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

Tradicionalmente, la escritura es un asunto solitario. Son solo 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, haya terminado. Ahora es el momento de mostrarle al mundo, publicar su texto y ver lo que sucede. Pero en estos tiempos digitales, esa no es la única forma de escribir.

¿Y si fuera todos a la intemperie, todo el tiempo? ¿Qué pasaría si el mundo pudiera ver sus revisiones y seguir adelante, haciendo sugerencias? A primera vista, esto puede parecer una idea horrible, pero para algunos tipos de textos (y para ciertos 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 revisiones usando Git ¿Qué es Git y por qué debería usar el control de versiones si es desarrollador? ¿Qué es Git y por qué debería usar el control de versiones si somos un desarrollador Como desarrolladores web, muchas veces tendemos a trabajar en sitios de desarrollo local y luego cargamos todo cuando terminamos. Esto está bien cuando solo eres tú y los cambios son pequeños ... .

Empezando

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

Git le preguntará si está seguro de que desea autorizar a Prose. La prosa requiere bastantes permisos, pero todos tienen sentido:

A continuación, te encontrarás de nuevo en Prose, mirando una lista de todos tus 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 Prose parece estar construida teniendo en cuenta a los usuarios de Jekyll: Prose incluso le permite publicar en Jekyll. Dicho eso, no lo haces necesitar Jekyll para hacer uso de Prose, y lo he mirado sin conectarlo a nada más.

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

Crear un nuevo repositorio de GitHub

Para crear un nuevo repositorio de GitHub, tendrías que volver a GitHub, esto no es algo que puedas hacer en Prose. Prose sugiere nombrar su nuevo repositorio “documentos,” así que eso fue lo que hice.

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

Editar un documento

Al hacer clic en mi nuevo repositorio de Documentos, recibo el archivo README.md predeterminado de GitHub. MD, en este caso, significa Markdown: el mismo formato simple utilizado por Dillinger.io Dillinger: Editar y ver Markdown en tiempo real Dillinger: Editar y ver Markdown en tiempo real, TextDown TextDown: Obtenga un editor de Markdown incorporado en Google Chrome TextDown : Obtenga un editor Markdown integrado en Google Chrome, WriteMonkey y muchos otros editores. Si ha estado redactando texto para uso en línea durante un período de tiempo prolongado, es probable que haya encontrado Markdown más de una vez.

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

Está felizmente libre de anuncios y tiene un esquema de color apagado que es agradable a la vista. También tiene resaltado de sintaxis para Markdown, y en lugar de un panel de vista previa instantánea (como el que se usa en Dillinger.io), la vista previa de su texto renderizado en HTML requiere un clic rápido en la barra de herramientas:

Puede acceder a la pantalla de vista previa usando Ctrl + Shift + flecha derecha. Ctrl + Shift + flecha izquierda te lleva a una hoja de trucos de Markdown, en caso de que quieras actualizar tu memoria.

El editor es de 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 su texto sea mucho más propenso a los errores tipográficos.

Publicación (o ahorro)

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

Y después de algunos garabatos rápidos más, el historial de confirmación 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 se cambia a una diferente.

Esto está lejos de todo lo que Prose puede hacer: por ejemplo, puede usar Prose para editar el documento de otra persona y enviar una solicitud de extracción para que acepte sus revisiones, al igual que los codificadores. Hay muchas otras cosas que podrías hacer con Prose, pero su principio básico 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 “miedo a la publicación” publicando constantemente mientras escribes, para que no haya un solo “Momento de la verdad” - tus pensamientos han estado ahí afuera en todo el mundo todo el tiempo, errores tipográficos, inconsistencias y todo. Hay otras formas de hacer esto, desde wikis hasta clientes estándar de Git, pero Prose no pretende ser una idea exclusiva: simplemente empaqueta las cosas de forma ordenada para que el concepto se destaque. Si es o no la forma correcta de escribir es una elección personal, una opción que me gustaría conocer si me lo dijera en los comentarios.