GitLab esencial

Markdown avanzado en GitLab

¡Prueba gratis durante 10 días

nuestros 1267 cursos !

Prueba gratis Mostrar modalidades de suscripción
Cuando ya tienes cierta experiencia con GitLab, no vas a tener suficiente con lo que ya sabemos de Markdown, así que vamos a aprender la sintaxis necesaria para realizar tablas, enlaces complejos, jerarquía avanzada y más.

Transcripción

Algo bastante interesante cuando estamos haciendo algo de documentación y queremos comentar un trozo de código, sería pues precisamente, las referencias de código que además GitLab nos la puede colorear conforme al lenguaje que estamos escribiendo Vamos a copiar y pegar unas referencias de código en diferentes lenguajes y vamos a ver sus diferencias. Vemos que para marcar un trozo de código podemos poner tres acentos invertidos al principio y tres acentos invertidos al final del bloque de código que vamos a comentar. Esto sería un comentario de código, esto sería otro, esto sería otro, y este último sería otro. Como veis, hay una diferencia aparte de que me he olvidado los tres últimos acentos. Y es que estos tres primeros Tienen una palabra después de los tres acentos invertidos que referencia el lenguaje que estamos escribiendo debajo. Esto sirve para que pueda marcar con colorines las palabras especiales de cada uno de los lenguajes. Este que no tiene nada no va a ser ningún coloreado. Pero va a marcar este texto en un bloque con un borde especial y sin formato de texto para que se diferencie que es algo relacionado con el código. Vamos a renderizar para verlo. Como veis, todos los bloques los ha separado y los ha marcado se ha puesto un fondo que es del color que nosotros tenemos configurado en nuestro perfil de usuario de en qué color queremos que nos marque el texto y todas las palabras especiales, todo el código de nuestro código fuente que corresponde al lenguaje que nosotros hemos puesto al editar el fichero Mark Down, nos lo referencia, vemos las funciones, vemos las variables, vemos los comentarios que vienen en otro color, y por último, el que no tiene marcado en ningún lenguaje, lo deja en gris pero sí que nos lo sigue separando, al igual que el resto del texto en un bloque separado y con un tipo de letra mono espaciado para que parezca código. Vamos a seguir editando más funciones. Otras cosa que tiene GitLab parecido a las menciones de código serían las citas de texto, lo que en inglés se llaman quotes o block quotes que son bloques de texto que se presupone que es una cita de algo que ha dicho otra persona de un texto de otra web. Para marcar un cita lo que se haría es poner un símbolo de mayor que antes de cada una de las líneas del texto que se quiera referenciar. En este caso vamos a insertar dos líneas con lo que se supone que es un texto que ha insertado alguien ahí que estamos referenciando de algo anterior. Aparte, otra función que podemos ver también, que es muy útil en GitLab es que enlaza de manera inteligente muchos tipos de objetos especiales que insertamos. De los que os voy a mostrar cinco, ahora mismo. Todo lo que pongamos con una arroba adelante servirá para marcar un usuarios o un grupo de usuario, podría ser "agonzalez", que en este caso soy yo, podrías ser "all", que referencia a todos los usuarios del sistema o podría ser un nombre de grupo. Todo lo que lleve una almohadilla adelante referencia una incidencia. Si nosotros tenemos incidencias creadas en nuestro sistema en este caso, yo en este proyecto solo tengo una incidencia, con el número de la incidencia que sería el número uno puedo referenciar esa incidencia para que se pueda hacer clic ahí. Otra sería un hash de un Commit. Cuando nosotros tenemos un Commit que tiene un hash corto como este, si nosotros dejamos el hash tal cual aquí sin ninguna otra indicación él sabrá que estamos referenciando un hash nuestro y nos lo pondrá como un enlace especial. Y por último serían los milestones o hitos, o objetivos del proyecto. que normalmente suelen coincidir con las versiones que queréis sacar. En este caso lo que hay que hacer es precederlas por un símbolo de porcentaje. Y después por el número de la versión o el nombre del milestone que quereis referenciar. En este caso yo tengo un milestone yo tengo un hito en este proyecto que es el 1.0, que no ha salido todavía. Podemos renderizar esto y ver cómo nos queda. Aquí vemos que tenemos las block quotes que nos han dejado esto como una referencia de un texto que ha escrito otra persona que sale con esta pequeña barrita adelante y tabulado un paso hacia la derecha vemos que tenemos un enlace a nuestro usuario que sería "agonzalez" y nos manda aquí a nuestro perfil de usuario, vemos que tenemos referenciado "all", que menciona todo el proyecto y si tuviéramos más usuarios en todo este sistema, les llegaría una notificación, tenemos marcada la incidencia número uno, que si entramos nos lleva a la incidencia directamente, y vemos todos sus detalles, vemos que tenemos una marca a este Commit en concreto, que es el que yo he puesto el número, el hash ahí delante, y si pincho podemos ver en qué consistió el Commit y qué cambios había, y finalmente tenemos el milestone 1.0. Que si pinchamos igual pues de la misma manera vemos cómo está el milestone, que está abierto cuántas incidencias le corresponden, etc. etc. etc. Como bonificación que sepáis que también se pueden insertar emojis, dentro de los textos, que creamos en formato Mark Down. Hay una serie de claves que tienen cada uno de los dibujos del emoji, que hay que meter dentro de un símbolo de dos puntos a la izquierda y otro a la derecha. en este caso, vamos a poner por ejemplo el de la caquita del whatsapp que como conocéis todos a este emoji que podrá renderizar y salirnos en medio de este documento. Si tenéis curiosidad de cómo son los códigos estándar de todos los emojis para poder insertarlos en vuestro repositorio, hay una web que se llama emoji punto codes dónde podéis revisar toda la lista de emojis estándares que existen y ver cómo arriba a la derecha, tenéis el código de texto que podéis utilizar para insertarlo dentro de vuestro proyecto. Yo podría coger un emoji feliz que se llama relaxed; si lo pinchamos se copia el texto, volver a nuestro fichero, y cambiarlo por este porque ya estamos más tranquilos por todo el Mark Down que hemos aprendido hoy.

GitLab esencial

Aprende a instalar y administrar GitLab, bien en tu propio servidor o en un servicio web gratuito o de pago, y cómo crear un perfil y generar tu primer proyecto en GitLab.

3:14 horas (47 Videos)
Actualmente no hay comentarios.
 
Fecha de publicación:27/10/2016

Este curso video2brain está disponible como descarga y para ser visualizado online. ¡Pero no hace falta que decidas entre las dos opciones! Al comprar el curso, disfrutarás de ambas posibilidades.

La descarga te permite ver las lecciones sin estar conectado/a a internet y supone una navegación fácil y ágil entre capítulo y capítulo. Si vas a trabajar en diferentes ordenadores o si no quieres descargarte el curso completo, entra en la web con tus datos de acceso y disfruta directamente de tus vídeos online. Te deseamos que disfrutes de este curso y te resulte de mucha utilidad.

Estamos a tu disposición si tienes cualquier tipo de duda o pregunta.