Header Ads Widget

Ticker

6/recent/ticker-posts

Cómo los escritores pueden usar GitHub para almacenar su trabajo

 El logotipo de GitHub.

Hay muchas formas de administrar y almacenar sus proyectos de escritura. Algunas personas prefieren los servicios de almacenamiento en la nube (como Dropbox) o los editores en línea (como Google Docs), mientras que otras usan aplicaciones de escritorio (como Microsoft Word). Utilizo algo llamado GitHub.

GitHub: es más que solo código

Utilizo Git y GitHub para almacenar y acceder a todos mis escritos. Git es una herramienta eficaz que puede utilizar para realizar un seguimiento de los cambios en los documentos, además de que puede subirlos a GitHub de forma súper rápida. También es rápido y sencillo descargar su trabajo a un segundo o tercer dispositivo.

Si nunca ha oído hablar de GitHub, es el destino más popular del mundo para almacenar y mantener código de fuente abierta. Puede sonar como un lugar loco para alojar tu escritura, ¡pero no lo es! Después de todo, el código es solo líneas y líneas de texto, como su artículo, historia o disertación.

Alrededor de 2013,  GitHub comenzó a alentar a las personas a crear repositorios para todo tipo de información, no solo código. GitHub nunca dejó realmente sus raíces de codificación, pero algunas personas todavía lo usan para almacenar escritura y otros proyectos que no son de codificación. Por ejemplo, una persona usó Git y GitHub para escribir un libro instructivo, mientras que otra escribió una novelaBusque en Google y encontrará todo tipo de usos locos para GitHub.

¿Qué son Git y GitHub?

La interfaz con pestañas de un repositorio de GitHub.

Git es un programa de código abierto creado por Linus Torvalds, famoso por Linux. Git realiza un seguimiento de los cambios en los documentos y facilita que varias personas trabajen en el mismo documento de forma remota. En términos técnicos, se denomina sistema de control de versiones distribuido (o VCS distribuido). Git no guarda versiones de sus documentos de forma arbitraria a intervalos establecidos. En cambio, almacena los cambios en sus documentos solo cuando usted se lo indica.

Sus documentos forman un repositorio (o repositorio), que es solo un término elegante para la carpeta de su proyecto. Su carpeta Documentos en Windows, por ejemplo, sería un repositorio si usara Git para administrarla (pero no lo haga).

Cuando almacena cambios en sus documentos en Git, se denomina "confirmación". Una confirmación es solo un registro de los cambios más recientes que realizó en un documento. A cada confirmación se le asigna una larga cadena de números y letras como su ID.

Si invoca una confirmación anterior por su ID, no verá el proyecto completo como lo hace en el historial de documentos de Word. Solo verá los cambios más recientes cuando se realizó esa confirmación. Sin embargo, esto no significa que no se haya grabado todo el proyecto. Puede eliminar toda su escritura de una carpeta de proyecto y aún obtener la versión más reciente con algunos comandos de git. Incluso puede volver atrás y ver cómo se veía el proyecto hace una semana o seis meses.

También puede incluir mensajes en cada confirmación, lo cual es muy útil. Por ejemplo, si escribe algo pero no está seguro de querer conservarlo, simplemente haga una confirmación. La sección luego sobrevive en su historial de confirmaciones incluso si la elimina del proyecto más tarde.

Git funciona mejor en la línea de comandos, lo cual es una gran ventaja, pero también tiene sus desventajas. La línea de comando está bien para crear confirmaciones y cargar cambios. Sin embargo, si desea ver un historial de confirmaciones, no es lo ideal.

Es por eso que a muchas personas les gusta GitHub, un popular servicio en línea que ofrece una interfaz web para sus repositorios de Git. En GitHub, puede ver fácilmente las confirmaciones anteriores, así como descargar su escritura en varias PC.

Juntos, Git y GitHub me permiten controlar mi historial de versiones a un nivel granular. Y es fácil conseguir mi escritura en cualquier PC que pueda ejecutar una línea de comandos Bash que, en estos días, incluye máquinas con Windows, Mac, Linux y Chrome OS.

Los archivos de texto sin formato facilitan las cosas

El editor de texto sublime.

Git y GitHub se comprometen en prácticamente cualquier tipo de archivo para escritura, aunque funciona mejor con texto sin formato. Si escribe en Microsoft Word, funcionará, pero no podrá ver sus confirmaciones anteriores en la línea de comandos o en GitHub. En su lugar, debe llamar una confirmación anterior en la línea de comando (llamada "pago") y luego abrir su archivo de Word. El archivo de Word se ve igual que cuando hizo la confirmación original, y puede volver a su versión actual con otro comando rápido.

Si usa Scrivener, eso también funciona. Scrivener guarda archivos como texto, por lo que también muestra confirmaciones pasadas en GitHub y la línea de comando. Pero Scrivener también guarda datos que son importantes para el programa, pero no para usted. En cada confirmación, terminarás con una gran cantidad de basura que dificulta la lectura.

Utilizo archivos de texto sin formato porque eso es todo lo que necesitas para unir palabras, especialmente en tus primeros borradores.

Empezando con Git

Entremos en los detalles técnicos de cómo funciona todo esto. Comenzaremos con PC y luego subiremos a la nube con GitHub.

Para comenzar, necesita el programa de terminal en macOS o Linux. Si su computadora ejecuta Windows 10, debe instalar Ubuntu u otra distribución de Linux a través del Subsistema de Windows para Linux (WSL), que es bastante fácil. Puede consultar nuestro tutorial sobre cómo instalar el shell de Linux Bash en Windows 10O, si usa una versión anterior de Windows, puede usar Cygwin para obtener un shell Bash.

Abra su terminal y navegue hasta la carpeta que desea usar como repositorio de Git. Para nuestros propósitos, digamos que tenemos una carpeta llamada "MyNovel" en la carpeta Documentos. Tenga en cuenta que no hay espacio entre las palabras de nuestro repositorio de Git. Harás tu vida más fácil si lo haces de esta manera, ya que a Bash no le gustan los espacios y lidiar con ellos se vuelve confuso.

A continuación, navegue hasta la carpeta MyNovel en la terminal. Para hacer esto en Windows 10, el comando es:

cd / mnt / c / Users / [YourUserName] / Documents / MyNovel

Cualquier comando WSL que interactúe con archivos guardados en Windows debe usar /mnt/Además, tenga en cuenta que la "c" minúscula indica la unidad en la que se encuentra. Si sus archivos están en una unidad "D: /", utilice /d/.

Para macOS y Linux, el comando es mucho más simple:

cd ~ / Documentos / MyNovel

A partir de aquí, los comandos son los mismos.

Ahora, tenemos que inicializar la carpeta MyNovel como un repositorio de Git. Este comando funciona tanto si recién está comenzando una novela nueva como si ya tiene algunos archivos guardados en su interior.

git init

Su carpeta ahora es un repositorio de Git. ¿No me crees? Escriba esto en:

ls -a

Ese comando le pide a la computadora que enumere todo en la carpeta actual, incluidos los elementos ocultos. Debería ver algo en la parte superior llamado ".git" (tenga en cuenta el punto). La carpeta oculta ".git" es donde se guarda el historial de versiones de su documento. Nunca debería necesitar abrir esto, pero tiene que estar allí.

El primer compromiso

Antes de hacer nuestro primer compromiso, Git quiere saber su nombre y dirección de correo electrónico. Git usa esta información para identificar quién realizó la confirmación, y esa información se incluye en el registro de confirmación. A efectos prácticos, esto no importa, ya que los escritores suelen volar solos, pero Git aún lo requiere.

Para configurar su correo electrónico y dirección, haga lo siguiente:

git config --global user.email "[Su correo electrónico]"

git config --global user.name "[Su nombre]"

Eso es. Ahora pasemos al primer compromiso.

Supongamos que hay tres documentos en la carpeta "MyNovel" llamados: "Capítulo1", "Capítulo2" y "Capítulo3". Para guardar los cambios, tenemos que decirle a Git que rastree estos archivos. Para hacer esto, escriba:

git add.

El período le dice a Git que monitoree todos los archivos sin seguimiento en la carpeta (es decir, archivos para los que desea crear historiales). Este comando también le dice a Git que prepare cualquier archivo actualmente rastreado que haya sido modificado. Este proceso se denomina preparación de archivos para confirmación.

Para nuestros propósitos, la puesta en escena no es tan importante, pero puede ser útil. Si realiza cambios en el Capítulo 2 y el Capítulo 3, pero solo desea confirmar los cambios en el Capítulo 2, debería organizar el Capítulo 2 así:

git agregar Chapter2.doc

Esto le dice a Git que desea que los cambios del Capítulo 2 estén listos para su confirmación, pero no el Capítulo 3.

Ahora es el momento de la primera confirmación:

Git commit -m "Esta es mi primera confirmación".

La “-m” se llama bandera, y le dice a Git que quieres hacer una confirmación y tachar un mensaje, que ves entre las comillas. Me gusta usar mis mensajes de confirmación para marcar el recuento de palabras. También los uso para anotar información especial, como: "Este compromiso incluye una entrevista con el director ejecutivo de Acme Widgets".

Si estoy escribiendo una historia, podría incluir un mensaje que diga: "Este compromiso tiene la nueva escena en la que el perro se escapa". Los mensajes útiles hacen que sea más fácil encontrar sus confirmaciones más adelante.

Ahora que hemos comenzado a rastrear nuestros documentos, es hora de poner nuestra escritura en la nube con GitHub. Utilizo GitHub como una copia de seguridad adicional, un lugar confiable para ver los cambios en mis documentos y una forma de acceder a mis cosas en varias PC.

Introducción a GitHub

El formulario de texto para crear un nuevo repositorio de GitHub.

Primero, debe registrarse para obtener una cuenta gratuita en GitHub (no necesita una cuenta paga para crear repositorios privados). Sin embargo, solo puede colaborar con hasta tres personas en un repositorio privado. Si tiene un equipo de cinco o más trabajando en un artículo, debe registrarse para obtener una cuenta Pro ($ 7 por mes, en este momento).

Después de crear su cuenta, creemos un nuevo repositorio. Inicie sesión en su cuenta y vaya a  https://github.com/new.

Lo primero que debemos hacer es nombrar el repositorio. Puede usar el mismo nombre que usó para la carpeta en su PC. En "Nombre del repositorio", escriba "MyNovel".

La "Descripción" es opcional, pero me gusta usarla. Puedes escribir algo como "Mi nueva y fabulosa novela sobre un niño, una niña y su perro", etc.

A continuación, seleccione el botón de opción "Privado", pero no marque la casilla "Inicializar este repositorio con un archivo README". No queremos hacer eso, porque ya tenemos un repositorio en nuestra PC. Si creamos un archivo README ahora mismo, las cosas se complican más.

A continuación, haga clic en "Crear repositorio". En "Configuración rápida, si ha hecho este tipo de cosas antes", copie la URL. Debería verse algo como esto:

https://github.com/[Tu nombre de usuario de GitHub] /MyNovel.git

Ahora, vuelve al escritorio y a nuestra querida línea de comandos.

Empuje su repositorio de escritorio a la nube

Una línea de comandos de PC.

La primera vez que conecta un repositorio a GitHub, debe usar algunos comandos especializados. El primero es:

git remote add origin https://github.com/[Tu nombre de usuario de GitHub] /MyNovel.git

Esto le dice a Git que un repositorio remoto es el origen de "MyNovel". Luego, la URL apunta a Git hacia ese origen remoto. No se obsesione demasiado con el término "origen"; es solo una convención. Puede llamarlo "esponjoso" si lo desea; el origen es más fácil ya que es la forma más común de usar Git.

Cuando subes nuevos cambios con Git, se denomina "push". Cuando descarga cambios, se denomina "extracción" o "recuperación". Ahora es el momento de impulsar su primer compromiso con GitHub. Esto es lo que haces:

git push -u maestro de origen

Se le pedirá que escriba su nombre de usuario y contraseña de GitHub. Si escribe sus credenciales correctamente, todo se carga y está listo para comenzar.

Si desea más seguridad para sus cargas de GitHub, puede usar una clave SSH. Esto le permite usar una única contraseña para cargar la clave SSH, por lo que no tiene que escribir sus credenciales completas de GitHub cada vez. Además, solo alguien con la clave SSH puede cargar cambios en los archivos.

Si desea más información sobre las claves SSH,  GitHub tiene instrucciones completas sobre cómo usarlasTambién puede guardar sus credenciales de Git en su PC.

¡Eso es! Ahora, cuando desee realizar cambios en sus archivos, puede hacerlo con estos tres comandos cortos (después de navegar a la carpeta "MyNovel"):

git add.

Traducción: "Oye, etapa de Git para confirmar todos los archivos sin seguimiento, así como los nuevos cambios en los archivos que ya estás siguiendo".

git commit -m "1,000 palabras sobre la nueva revisión del iPhone".

Traducción: "Hola Git, guarda estos cambios junto con este mensaje".

maestro de origen de git push

Traducción: "Hola, Git, sube los cambios a la versión original de este proyecto en GitHub desde mi copia maestra en esta PC".

Consejos adicionales de Git y GitHub

Eso es todo, pero aquí hay algunos consejos adicionales para que su experiencia con Git y GitHub sea aún mejor:

Ver compromisos anteriores

Una interfaz de repositorio de GitHub del historial de confirmaciones.

Para ver las confirmaciones pasadas, vaya a su repositorio MyNovel en GitHub. Hacia la parte superior de la página principal, debajo de la pestaña "Código <>", verá una sección que dice, "[X] confirma".

Haga clic en él y verá una lista de todas sus confirmaciones. Haga clic en la confirmación que desee y verá su texto (si lo escribió en texto sin formato y no en Word, claro). Todo lo resaltado en verde era texto nuevo cuando se creó la confirmación; todo en rojo fue eliminado.

Utilice el comando de extracción

Es fácil obtener un nuevo repositorio en una máquina diferente. Simplemente navegue hasta donde desea guardar el repositorio en la nueva máquina, como cd ~/DocumentsLuego, escriba:

git pull https://github.com/[Tu nombre de usuario de GitHub] /MyNovel.git

Escriba sus credenciales, si se le solicita, y en unos segundos estará listo para comenzar. Ahora, confirme nuevos cambios y luego envíelos de regreso a GitHub a través de git push origin masterCuando regrese a la PC donde trabaja habitualmente, simplemente abra la línea de comando, navegue a la carpeta de su proyecto y escriba git pull.Se descargarán los nuevos cambios, y así, su proyecto de escritura estará actualizado en todos sus dispositivos.

No cruce de corrientes

La mayoría de las veces, escribir no es un esfuerzo de equipo y solo involucra a una persona. Por eso, este artículo usa Git de una manera que no funcionaría para un proyecto de varias personas. Específicamente, realizamos modificaciones directamente en la versión maestra de nuestra novela en lugar de crear lo que se denominan "ramas". Una rama es una versión práctica de la novela en la que puedes realizar cambios sin afectar al maestro original. Es como tener dos copias diferentes de tu novela en paralelo sin que ninguna afecte a la otra. Si le gustan los cambios en la rama de práctica, puede fusionarlos en la versión maestra (o rama maestra). Si no quieres hacer eso, también está bien. Solo tira la rama de práctica.

Las sucursales son muy poderosas y su uso sería el flujo de trabajo principal con varios escritores en un solo proyecto. En mi opinión, los escritores en solitario no necesitan usar ramas, siempre y cuando no realice cambios diferentes en la rama maestra al mismo tiempo en varias PC.

Por ejemplo, debe completar su trabajo en su escritorio, hacer sus confirmaciones y luego enviar los cambios a GitHub. Luego, vaya a su computadora portátil y elimine todos los cambios nuevos antes de realizar más ediciones. Si no lo hace, podría terminar con lo que Git llama "conflictos". Ahí es cuando Git dice: “Oye, hay cambios en GitHub y en esta PC que no coinciden. Ayúdame a resolver esto ".

Ordenar la salida de un conflicto puede ser complicado, por lo que es mejor evitarlo siempre que sea posible.

Una vez que comienzas con Git, hay muchas cosas que puedes aprender, como la ramificación, la diferencia entre una búsqueda y una extracción, cuáles son las solicitudes de extracción de GitHub y cómo lidiar con el temido conflicto.

Git puede parecer complicado para los recién llegados, pero una vez que lo dominas, es una herramienta poderosa que puedes usar para administrar y almacenar tu escritura.

Publicar un comentario

0 Comentarios