Skip to content

scrollarmy/Blog

Repository files navigation

Blog de la comunidad ScrollArmy

Logo de la comu

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.


Como realizar un post

  1. Haces un fork del repo

  1. Lo clonas a tu compu local (git clone <url del fork tuyo>)

  2. Te moves a una branch de nuevo post (git checkout new-post)

  3. 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

  4. Limpiar los placeholders y ejemplos, dejar solo lo que vayas a utilizar

  5. 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)

  6. Haces un pull request al repo original

  7. El post se revisa y se mergea

  8. Gloria y descanso


Formatos y herramientas para crear el post

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.

Cabecera

---
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

Cuerpo del post

Elementos basicos

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

  1. Primer elemento
  2. Seg elemento
  3. 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 Gatito

![Texto alternativo](url de la imagen)

y para centrarla se agrega el siguiente codigo al final {: .mx-auto.d-block :}

![Titulo](Url de la img o gif){: .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

[![Texto alternativo](url de la imagen)](URL)

Perrito granjero


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.

imagen de las notificaciones

{: .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.