Compartimos articulos de interes o escritos por miembros del chapter de Pergamino, siempre podes sumarte a escribir y mandar un PR o darte una vuelta por nuestros grupos de Whatsapp o Telegram para consultar algo.
- Haces un fork del repo
-
Lo clonas a tu compu local (
git clone <url del fork tuyo>) -
Te moves a una branch de nuevo post (
git checkout new-post) -
Te copias el contenido de /_posts/example.md (También contiene ayudas para la hora de escribir ) y lo guardas con el siguiente formato
YYYY-MM-DD-TITULO.md -
Limpiar los placeholders y ejemplos, dejar solo lo que vayas a utilizar
-
Te pones a escribir trancu y cuando lo tenes listo subis todo con un commit (
git commit -m "sarasa de detalle" #Esto a tu fork local) -
Haces un pull request al repo original
-
El post se revisa y se mergea
-
Gloria y descanso
En /_posts/example.md hay tips, consejos y algunas ideas de como comenzar a escribir para tener un formato basico, a continuación revisamos elementos de markdown asi como también de jekill para el armado de posts.
---
layout: post
title: Sample blog post
subtitle: Each post also has a subtitle
comments: false
readtime: true
---
se pueden agregar mas campos opciones que rechazarse por no aplicar en el post, por ejemplo highlights/badges de un repo de github, también se pueden colocar miniaturas o imagenes de portada para la entrada de blog
gh-repo: user/repo
gh-badge: [star, fork, follow]
tags: [test]
thumbnail-img: /path/to/image #Se muestra solo en el feed del sitio
cover-img: ["/path/img1", "/path/img2"] #Puede contener mas de una img
Utilizando # se generan los titulares, desde 1 hasta 3 veces podemos juntarlos para generar 3 niveles distintos (# TEXTO)
# Titulo 1
## Titulo 2
### Titulo 3
Texto en negritas
**Texto en negritas**
Texto en italica
*Texto en italica*
Quote text
> Quote text
Elementos para listar y enumerar
- Primer elemento
- Seg elemento
- Tercer elemento
- Primer elemento
- Seg elemento
- Tercer elemento
1. Primer elemento
2. Seg elemento
3. Tercer elemento
- Primer elemento
- Seg elemento
- Tercer elemento
Si queremos generar una linea horizontal divisoria utilizamos
---
Para publicar Links se utiliza el formato
[Texto a mostrar](URL)
Uso de Imagenes
Esta es una imagen colocada en linea con el texto
y para centrarla se agrega el siguiente codigo al final {: .mx-auto.d-block :}
{: .mx-auto.d-block :}
TIP: si queremos hacer una imagen que al hacerle click nos lleve a una url vamos a hacer un link que en lugar de un texto a mostrar tenga una imagen
[](URL)
Para generar una tabla se utiliza el siguiente formato
| Number | Next number | Previous number |
| :------ |:--- | :--- |
| Five | Six | Four |
| Ten | Eleven | Nine |
| Seven | Eight | Six |
| Two | Three | One |
y este es el resultado
| Number | Next number | Previous number |
|---|---|---|
| Five | Six | Four |
| Ten | Eleven | Nine |
| Seven | Eight | Six |
| Two | Three | One |
Como mostrar bloques de codigo
si queremos poner codigo sin formato usaremos el siguiente formato
~~~
codigo
~~~
var foo = function(x) {
return(x + 5);
}
foo(3)
Aca va igual pero formateado con colores
```<lenguaje>
codigo
```
var foo = function(x) {
return(x + 5);
}
foo(3)y si queremos mostrar los numeros de lineas usamos lo siguiente. Notese que también se aclaró el lenguage utilizado
{% highlight javascript linenos %}
var foo = function(x) {
return(x + 5);
}
foo(3)
{% endhighlight %}
También se puede generar cajas de notificación, alerta o peligro.
{: .box-note}
**Blue note:** This is a notification box.
{: .box-warning}
**Warning:** This is a warning box.
{: .box-error}
**Error:** This is an error box.