Cómo usar Git para gestionar tu proyecto de escritura

Introducción

El control de versiones no se aplica solo al código, sino también a todo lo que quieras controlar, incluido el contenido. El uso de Git para gestionar tu próximo proyecto de escritura te permite ver varios borradores al mismo tiempo, ver las diferencias entre ellos e incluso volver a una versión anterior. Y si te sientes cómodo haciéndolo, puedes compartir tu trabajo con otras personas en GitHub u otros repositorios centrales de Git.

En este tutorial, usarás Git para administrar un pequeño documento Markdown. Almacenarás una versión inicial, la confirmarás, realizarás cambios, verás las diferencias entre esos cambios y revisarás la versión anterior. Cuando hayas terminado, tendrás un flujo de trabajo que podrás aplicar a tus propios proyectos de escritura.

Prerrequisitos

• Git instalado en tu computadora local. El tutorial Cómo contribuir al código abierto: Introducción a Git te guía a través de la instalación de Git y cubre información general que puede resultarte útil.

Paso 1: crear un espacio de trabajo para su proyecto de escritura

Para administrar los cambios, deberá crear un repositorio Git local. Un repositorio Git se encuentra dentro de un directorio existente, por lo que debe comenzar creando un nuevo directorio para su artículo:

mkdir article

Cambiar al nuevo articledirectorio:

cd article

El git initcomando crea un nuevo repositorio Git vacío en el directorio actual. Ejecute ese comando ahora:

git init

Verá el siguiente resultado que confirma que se creó su repositorio:

OutputInitialized empty Git repository in /Users/sammy/article/.git/

El .gitignorearchivo te permite indicarle a Git que se deben ignorar algunos archivos. Puedes usarlo para ignorar archivos temporales que tu editor de texto pueda crear o archivos del sistema operativo. En macOS, por ejemplo, la aplicación Finder crea .DS_Storearchivos en directorios. Crea un .gitignorearchivo que los ignore:

nano .gitignore

Añade las siguientes líneas al archivo:

.gitignore

# Ignore Finder files.DS_store

La primera línea es un comentario que te ayudará a identificar lo que vas a ignorar en el futuro. La segunda línea especifica el archivo que vas a ignorar.

Guarde el archivo y salga del editor.

A medida que descubra más archivos que desee ignorar, abra el .gitignorearchivo y agregue una nueva línea para cada archivo o directorio que desee ignorar.

Ahora que tu repositorio está configurado, puedes empezar a trabajar.

Paso 2: guardar el borrador inicial

Git solo conoce los archivos que le indicas. El hecho de que exista un archivo en el directorio que contiene el repositorio no significa que Git realice un seguimiento de sus cambios. Tienes que agregar un archivo al repositorio y luego confirmar los cambios.

Crea un nuevo archivo Markdown llamado article.md:

nano article.md

Añade algo de texto al archivo:

artículo.md

# How To Use Git to Manage Your Writing Project### IntroductionVersion control isn't just for code. It's for anything you want to track, including content. Using Git to manage your next writing project gives you the ability to view multiple drafts at the same time,  see differences between those drafts, and even roll back to a previous version. And if you're comfortable doing so, you can then share your work with others on GitHub or other central git repositories.In this tutorial you'll use Git to manage a small Markdown document. You'll store an initial version, commit it, make changes, view the difference between those changes, and review the previous version. When you're done, you'll have a workflow you can apply to your own writing projects.

Guarde los cambios y salga del editor.

El git statuscomando te mostrará el estado de tu repositorio. Te mostrará qué archivos se deben agregar para que Git pueda realizar un seguimiento de ellos. Ejecuta este comando:

git status

Verás este resultado:

OutputOn branch masterNo commits yetUntracked files:  (use "git add file..." to include in what will be committed).gitignorearticle.mdnothing added to commit but untracked files present (use "git add" to track)

En la salida, la Untracked filessección muestra los archivos que Git no está mirando. Estos archivos deben agregarse al repositorio para que Git pueda observarlos en busca de cambios. Use el git addcomando para hacer esto:

git add .gitignore
git add article.md

Ahora ejecute git statuspara verificar que se hayan agregado esos archivos:

OutputOn branch masterNo commits yetChanges to be committed:  (use "git rm --cached file..." to unstage)new file:   .gitignorenew file:   article.md

Ahora ambos archivos aparecen en la Changes to be committedsección. Git los conoce, pero aún no ha creado una instantánea del trabajo. Utilice el git commitcomando para hacerlo.

Cuando creas una nueva confirmación, debes proporcionar un mensaje de confirmación. Un buen mensaje de confirmación indica cuáles son tus cambios. Cuando trabajas con otros, cuanto más detallados sean tus mensajes de confirmación, mejor.

Utilice el comando git commitpara confirmar sus cambios:

git commit -m "Add gitignore file and initial version of article"

La salida del comando muestra que los archivos fueron confirmados:

Output[master (root-commit) 95fed84] Add gitignore file and initial version of article 2 files changed, 9 insertions(+) create mode 100644 .gitignore create mode 100644 article.md

Utilice el git statuscomando para ver el estado del repositorio:

git status

El resultado muestra que no hay cambios que deban agregarse ni confirmarse.

OutputOn branch masternothing to commit, working tree clean

Ahora veamos cómo trabajar con los cambios.

Paso 3: Guardar revisiones

Has añadido tu versión inicial del artículo. Ahora, añadirás más texto para que puedas ver cómo gestionar los cambios con Git.

Abra el artículo en su editor:

nano article.md

Añade más texto al final del archivo:

## Prerequisites* Git installed on your local computer. The tutorial [How to Contribute to Open Source: Getting Started with Git](https://www.digitalocean.com/community/tutorials/how-to-contribute-to-open-source-getting-started-with-git) walks you through installing Git and covers some background information you may find useful. 

Guarde el archivo.

Utilice el git statuscomando para ver dónde están las cosas en su repositorio:

git status

El resultado muestra que hay cambios:

OutputOn branch masterChanges not staged for commit:  (use "git add file..." to update what will be committed)  (use "git checkout -- file..." to discard changes in working directory)modified:   article.mdno changes added to commit (use "git add" and/or "git commit -a")

Como era de esperar, el article.mdarchivo tiene cambios.

Utilice git diffpara ver qué son:

git diff article.md

La salida muestra las líneas que has agregado:

diff --git a/article.md b/article.mdindex 77b081c..ef6c301 100644--- a/article.md+++ b/article.md@@ -5,3 +5,7 @@ Version control isn't just for code. It's for anything you want to track, including content. Using Git to manage your next writing project gives you the ability to view multiple drafts at the same time,  see differences between those drafts, and even roll back to a previous version. And if you're comfortable doing so, you can then share your work with others on GitHub or other central git repositories.  In this tutorial you'll use Git to manage a small Markdown document. You'll store an initial version, commit it, make changes, view the difference between those changes, and review the previous version. When you're done, you'll have a workflow you can apply to your own writing projects.++## Prerequisites++* Git installed on your local computer. The tutorial [How to Contribute to Open Source: Getting Started with Git](https://www.digitalocean.com/community/tutorials/how-to-contribute-to-open-source-getting-started-with-git) walks you through installing Git and covers some background information you may find useful. 

En el resultado, las líneas que comienzan con un signo más (+) son líneas que usted agregó. Las líneas que se eliminaron se mostrarán con un signo menos (-). Las líneas que no se modificaron no tendrán ninguno de estos caracteres al frente.

El uso de git diffy git statuses una forma útil de ver lo que has cambiado. También puedes guardar la diferencia en un archivo para poder verla más tarde con el siguiente comando:

git diff article.md  article_diff.diff

El uso de la .diffextensión ayudará a su editor de texto a aplicar el resaltado de sintaxis adecuado.

Guardar los cambios en tu repositorio es un proceso de dos pasos. Primero, agrega el article.mdarchivo nuevamente y luego haz la confirmación. Git quiere que le indiques explícitamente qué archivos van en cada confirmación, por lo que, aunque hayas agregado el archivo antes, debes agregarlo nuevamente. Ten en cuenta que la salida del git statuscomando te lo recuerda.

Agregue el archivo y luego confirme los cambios, proporcionando un mensaje de confirmación:

git add article.md
git commit -m "add prerequisites section"

La salida verifica que la confirmación funcionó:

Output[master 1fbfc21] add prerequisites section 1 file changed, 4 insertions(+)

Úselo git statuspara ver el estado de su repositorio. Verá que no hay nada más que hacer.

git status

OutputOn branch masternothing to commit, working tree clean

Continúe este proceso a medida que revisa su artículo. Realice cambios, verifíquelos, agregue el archivo y confirme los cambios con un mensaje detallado. Confirme sus cambios con la frecuencia que le resulte cómoda. Puede realizar una confirmación después de terminar cada borrador o justo antes de realizar una revisión importante de la estructura de su artículo.

Si envías un borrador de un documento a otra persona y esta hace cambios, toma su copia y reemplaza tu archivo con el de ella. Luego, usa git diffpara ver los cambios que hizo rápidamente. Git verá los cambios ya sea que los hayas escrito directamente o que hayas reemplazado el archivo con uno que hayas descargado de la web, correo electrónico o de otro lugar.

Ahora veamos cómo administrar las versiones de tu artículo.

Paso 4: Gestión de cambios

A veces resulta útil consultar una versión anterior de un documento. Siempre que ha utilizado git commit, ha proporcionado un mensaje útil que resume lo que ha hecho.

El git logcomando muestra el historial de confirmaciones de su repositorio. Cada cambio que haya confirmado tiene una entrada en el registro.

git log

Outputcommit 1fbfc2173f3cec0741e0a6b21803fbd0be511bc4Author: Sammy Shark sammy@digitaloceanDate:   Thu Sep 19 16:35:41 2019 -0500    add prerequisites sectioncommit 95fed849b0205c49eda994fff91ec03642d59c79Author: Sammy Shark sammy@digitaloceanDate:   Thu Sep 19 16:32:34 2019 -0500    Add gitignore file and initial version of article

Cada confirmación tiene un identificador específico. Este número se utiliza para hacer referencia a los cambios de una confirmación específica. Sin embargo, solo se necesitan los primeros caracteres del identificador. El git log --onelinecomando ofrece una versión condensada del registro con identificadores más cortos:

git log --oneline

Output1fbfc21 add prerequisites section95fed84 Add gitignore file and initial version of article

Para ver la versión inicial de su archivo, utilice git showy el identificador de confirmación. Los identificadores en su repositorio serán diferentes a los de estos ejemplos.

git show 95fed84 article.md

La salida muestra los detalles de la confirmación, así como los cambios que ocurrieron durante esa confirmación:

Outputcommit 95fed849b0205c49eda994fff91ec03642d59c79Author: Sammy Shark sammy@digitaloceanDate:   Thu Sep 19 16:32:34 2019 -0500    Add gitignore file and initial version of articlediff --git a/article.md b/article.mdnew file mode 100644index 0000000..77b081c--- /dev/null+++ b/article.md@@ -0,0 +1,7 @@+# How To Use Git to Manage Your Writing Project++### Introduction++Version control isn't just for code. It's for anything you want to track, including content. Using Git to manage your next writing project gives you the ability to view multiple drafts at the same time,  see differences between those drafts, and even roll back to a previous version. And if you're comfortable doing so, you can then share your work with others on GitHub or other central git repositories.++In this tutorial you'll use Git to manage a small Markdown document. You'll store an initial version, commit it, make changes, view the difference between those changes, and review the previous version. When you're done, you'll have a workflow you can apply to your own writing projects.

Para ver el archivo en sí, modifique ligeramente el comando. En lugar de un espacio entre el identificador de confirmación y el archivo, reemplácelo con :./algo como esto:

git show 95fed84:./article.md

Verás el contenido de ese archivo, en esa revisión:

Output# How To Use Git to Manage Your Writing Project### IntroductionVersion control isn't just for code. It's for anything you want to track, including content. Using Git to manage your next writing project gives you the ability to view multiple drafts at the same time,  see differences between those drafts, and even roll back to a previous version. And if you're comfortable doing so, you can then share your work with others on GitHub or other central git repositories.In this tutorial you'll use Git to manage a small Markdown document. You'll store an initial version, commit it, make changes, view the difference between those changes, and review the previous version. When you're done, you'll have a workflow you can apply to your own writing projects.

Puedes guardar esa salida en un archivo si la necesitas para otra cosa:

git show 95fed84:./article.md  old_article.md

A medida que realice más cambios, su registro crecerá y podrá revisar todos los cambios que haya realizado en su artículo a lo largo del tiempo.

Conclusión

En este tutorial, utilizaste un repositorio Git local para hacer un seguimiento de los cambios en tu proyecto de escritura. Puedes utilizar este enfoque para administrar artículos individuales, todas las publicaciones de tu blog o incluso tu próxima novela. Y si subes tu repositorio a GitHub, puedes invitar a otras personas a que te ayuden a editar tu trabajo.