Escribe, y deja que el mundo revise tu trabajo con Prose.io para GitHub

Anuncio

Tradicionalmente, escribir es un asunto solitario. Solo eres tú y la pantalla, o un pedazo de papel. El hombre contra el texto en una batalla de voluntades, ingenio y emoción, hasta que de repente, ya terminaste. Ahora es el momento de mostrarle al mundo, poner tu texto ahí y ver lo que sucede. Pero en estos tiempos digitales, esa no es la única forma de escribir.

¿Qué pasaría si todo fuera abierto, todo el tiempo? ¿Qué pasa si el mundo puede ver sus revisiones y seguir, hacer sugerencias? A primera vista, esto puede parecer una idea horrible, pero para algunos tipos de textos (y para algunos escritores), tal colaboración abierta puede ser una bendición. Prose es una plataforma de publicación en línea simple que interactúa con GitHub para permitirle editar texto en línea y mantener las revisiones usando Git What Is Git y por qué debería usar Control de versiones si es desarrollador. Qué es Git y por qué debería usar control de versiones si Como desarrollador web, muchas veces trabajamos en sitios de desarrollo local y simplemente cargamos todo cuando terminamos. Esto está bien cuando eres solo tú y los cambios son pequeños, ... Leer más.

Empezando

Para trabajar con Prosa, primero debe tener una cuenta de GitHub. Suponiendo que haya iniciado sesión en Git, simplemente haga clic en el botón Autorizar de la Prosa:

Git luego le preguntará si está seguro de que quiere autorizar la Prosa. La prosa requiere bastantes permisos, pero todos tienen sentido:

A continuación, se encontrará de nuevo en Prose, mirando una lista de todos sus repositorios de Git:

Si eres como yo, ninguno de tus repositorios existentes es una buena opción para un montón de texto. Por supuesto, esto puede no ser cierto para usted: por ejemplo, si está utilizando el marco de publicación de Jekyll, es posible que ya tenga un repositorio esperando el texto. De hecho, gran parte de la Prosa parece estar construida con usuarios de Jekyll en mente: Prose incluso te permite publicar a Jekyll. Dicho esto, no necesitas que Jekyll haga uso de la Prosa, y la he visto sin conectarla a nada más.

Entonces, para comenzar, hagamos un nuevo hogar para nuestro texto.

Creando un Nuevo Repositorio GitHub

Para crear un nuevo repositorio de GitHub, tendría que regresar a GitHub, esto no es algo que pueda hacer en la Prosa. Prose sugiere nombrar los nuevos "documentos" del repositorio, así que eso es lo que hice.

Inmediatamente después de crear el repositorio, apareció dentro de Prose:

Editando un documento

Al hacer clic en mi nuevo repositorio de Documentos, me recibe el archivo README.md predeterminado de GitHub. MD, en este caso, significa Markdown, el mismo formato simple utilizado por Dillinger.io, TextDown, WriteMonkey y un sinnúmero de otros editores. Si ha estado redactando texto para uso en línea durante un período de tiempo prolongado, es probable que se haya encontrado con Markdown más de una vez.

Al hacer clic en el documento, apareció una interfaz de edición simple:

Está maravillosamente libre de anuncios, y tiene un esquema de colores apagados que es fácil para los ojos. También tiene resaltado de sintaxis para Markdown, y en lugar de un panel de vista previa instantánea (como el utilizado en Dillinger.io), la vista previa de su texto procesado en HTML requiere un clic rápido en la barra de herramientas:

Puede acceder a la pantalla de vista previa usando Ctrl + Mayús + flecha derecha. Ctrl + Mayús + flecha izquierda lo lleva a una hoja de trucos de reducción, en caso de que quiera actualizar su memoria.

El editor tiene buen gusto, pero no ofrece una función de conteo de palabras en vivo, algo que esperaría de cualquier herramienta dirigida a escritores. También deshabilita el corrector ortográfico incorporado de Chrome, lo que hace que el texto sea mucho más propenso a los errores tipográficos.

Publicación (o guardado)

A menos que esté usando Jekyll, publicar y guardar es prácticamente lo mismo: tan pronto como guarde, su texto se enviará a un repositorio de GitHub. A menos que sea un usuario de GitHub de pago y haya optado por un repositorio privado, esto significa que todos ahora pueden ver su texto. El primer commit se veía así:

Y después de unos pocos garabateos más rápidos, el historial de commit de GitHub para el repositorio se veía así:

Muy transparente, pero también seguro: las revisiones hacen que sea casi imposible perder su trabajo. Puede guardar y luego eliminar una gran parte de su documento, pero siempre podrá recuperarlo. Es como una función de Deshacer ilimitada que sigue funcionando incluso si apaga su computadora o pasa a otra diferente.

Esto está lejos de todo lo que puede hacer Prose: por ejemplo, puede usar Prose para editar el documento de otra persona y enviar una solicitud de extracción para que acepte sus revisiones, tal como lo hacen los codificadores. Hay muchas otras cosas que podrías hacer con la Prosa, pero su principio central sigue siendo el mismo: Git para escribir.

Pensamientos finales

Para mí, Prose se siente más como una invitación que como una herramienta. Una invitación a pensar, componer, redactar, a la intemperie. Para superar el miedo a la publicación publicando constantemente mientras escribe, para que no haya un único "momento de la verdad": sus pensamientos han estado presentes en el mundo todo el tiempo, errores tipográficos, inconsistencias y todo. Hay otras formas de hacerlo, desde wikis hasta clientes estándar de Git, pero Prose no pretende ser una idea exclusiva, simplemente empaqueta las cosas cuidadosamente para que el concepto se destaque. Si es o no la forma correcta de escribir es una elección personal, una elección que me gustaría escuchar, si me lo dices en los comentarios.