Creación de un repositorio

1. Presentación

Markdown es un lenguaje de presentación que gana en popularidad desde hace varios años, como muestra el gráfico Google Trends siguiente:

Fuente: http://www.google.es/trends/explore#q=markdown

Este lenguaje no es un lenguaje de presentación con una estructura XML como lo es HTML. Este lenguaje fue diseñado con el fin de ser legible directamente en modo texto, lo que lo ha hecho muy popular entre los desarrolladores. En efecto, un formato como el Markdown puede consultarse en modo texto y, por lo tanto, puede ser fácilmente versionado. Además, se puede exportar los archivos Markdown fácilmente a código HTML u otros formatos.

La sintaxis oficial está documentada en el vínculo siguiente: http://daringfireball.net/projects/markdown/syntax

Algunas sintaxis no son oficiales, pero por lo general se ejecutan correctamente por el software y bibliotecas con interfaz con Markdown. Estas permiten añadir funcionalidades ausentes en el formato oficial. Los archivos Markdown llevan por lo general la extensión .md.

He aquí un ejemplo de un archivo Markdown muy simple de un juego ficticio y su visualización en GitHub.

# Strategiii: lo mejor de la estrategia 
 
 ## Funcionalidades 
 
 + ¡64 unidades diferentes!  
 + ¡La **mejor IA** jamás vista! 

Esta es la forma en que el archivo se mostrará...

1. Presentación

ReStructuredText es otro formato de presentación, al igual que Markdown. Es un poco menos popular que Markdown, pero propone algunas opciones que no se encuentran en este.

La documentación oficial es muy completa: http://docutils.sourceforge.net/rst.html#reference-documentation

La presentación de la sintaxis de reStructuredText será más breve, porque conviene a usos más avanzados que Markdown y su aprendizaje excede el marco de este libro. Conviene tener en cuenta que las posibilidades de reStructuredText van mucho más allá de los pocos ejemplos siguientes.

Los archivos de reStructuredText llevan por lo general la extensión .rst.

2. Elementos de sintaxis

Título de nivel 1 
=================== 
 
Título de nivel 2 
---------------------- 
 
Título de nivel 1 
=================== 

1. Sublime Text

Esta no es la mejor herramienta para gestionar Markdown; sin embargo, es el editor que muchos desarrolladores usan a diario. Por eso, también es normal querer utilizarlo para escribir la documentación. Sublime Text no gestiona Markdown de forma nativa (aparte del hecho de que este sea un editor de texto); sin embargo hay varios plug-ins que permiten editar Markdown de manera sencilla y visual.

Sublime Text es un editor de texto compatible con los tres sistemas operativos principales: Linux, Mac OS y Windows.

El plug-in Markdown Preview permite exportar fácilmente el contenido de un archivo Markdown a un archivo HTML. Es un sistema muy práctico para versionar una documentación y compartir una versión más legible. Ver la página GitHub del producto: https://github.com/revolunet/sublimetext-markdown-preview

El plug-in MarkdownEditing permite tener una interfaz que ofrece coloración sintáctica. Esta interfaz se muestra más intuitiva y facilita la lectura de documentos Markdown en bruto.

El plug-in MarkdownTOC (de Markdown Table Of Content) permite editar...

1. Configuración mínima

Esta configuración se mencionó al final del capítulo Instalación de Git, en la sección Configuración requerida, por lo que ahora no nos entretendremos demasiado en este punto. Para usar Git, es necesario pasar por una etapa de configuración previa. Sin ella, no se puede utilizar Git normalmente, y no permitirá, por ejemplo, guardar los cambios.

Esta configuración nos servirá para identificarnos y para que Git sepa que realiza tal o cual modificación. He aquí cómo configurar en nuestro repositorio nuestro nombre, apellidos y dirección de e-mail:

git config --global user.name "Nombre Apellidos" 
git config --global user.email email@dominio.ext 

Ahora que hemos definido la configuración inicial, podemos trabajar con Git. Para obtener ayuda para la configuración y sus parámetros, debemos usar el comando siguiente:

git config --help 

2. Niveles de configuración

Git utiliza archivos para almacenar los distintos elementos de configuración. Cuando utilizamos los comandos git config, modificamos indirectamente estos archivos.

Existen tres niveles de configuración en Git. Estos niveles de configuración tienen todos un alcance diferente, es decir, que los elementos...

1. Paginación

Cuando se utilizan comandos como git diff, si el resultado es superior a una página se efectuará una paginación automática empleando less (comando UNIX que muestra el texto en una página). Este tipo de paginación puede molestar a determinados usuarios que preferirían no tener ninguna paginación y navegar sin limitaciones en el documento. Para esto, se requiere definir una paginación de tipo cat:

git config --global pager = cat 

2. Expresiones regulares extendidas

Por defecto, Git no activa las expresiones regulares extendidas, es decir, que los metacaracteres, como las llaves, son totalmente ignorados. Para los que están acostumbrados a las expresiones regulares y que las utilizan habitualmente, es preferible activar la opción siguiente:

git config --global extendedRegexp = true 

3. Separador de palabras

Cuando se utiliza git diff en modo palabra (empleando la opción --color-words, por ejemplo), puede ser útil especificar a Git lo que es una palabra. Por defecto, para Git una palabra es una sucesión de caracteres separados entre sí por uno o varios espacios. Sin embargo, en una línea de código es posible no tener espacio...