Cheatsheet

Esta página no aparece en el menú de navegación porque no tiene definida la variable public: true. Tampoco aparece en el sitemap porque /drafts/** está excluido en la configuración. Para llegar a ella utiliza este enlace: /drafts/cheatsheet.html.

Si el título contiene dos puntos (:) hay que ponerlo entre comillas.

Formato

Texto normal. El primer párrafo será lo que se use como resúmen en la portada.

Cursiva

Negrita

Salto de linea.

Listas

lista
sin
numerar

lista
numerada

Preformato dentro de listas

Se anteponen 7 espacios los 4 usuales más 3 por cada nivel de lista.

Actualizar los paquetes python necesarios:

python -m pip install --user -r $IDF_PATH/requirements.txt

Copiar el ejemplo hello_world de la SDK a nuestro home:

cp -r /opt/ESP8266_RTOS_SDK/examples/get-started/hello_world ~

Imágenes dentro de listas

No se puede. Se sustituye el include por html y no se respeta la identación original.

Ecuación display

\[LC = \frac{1}{(2\pi f)^2}\]

Ecuación inline

Demostración de que $\alpha = 2\pi\beta$.

Links

Link externo

Mifare

Link a otro post

Hay que usar site.baseurl porque la sintaxis

{post_url 2018-10-07-la-presion-atmosferica-bmp280} | relative_url

da error. En jekyll 4.0.0, post_url ya tiene incorporado relative_url.

Las oscilaciones amortiguadas

Link a un asset no imagen

datasheet

Elementos externos

Imágenes

Un gato a tamaño natural, máximo 100% del ancho de la pantalla. Foto de Google.

Las imágenes no se amplian, o bien se reducen o se muestran a tamaño natural.

En las etiquetas de las imágenes se puede usar markdown pero no se pueden usar variables, por tanto si hay que enlazar a un asset se debe poner la ruta entera.

Un gato. Asset del post en el pie de foto.

Se pueden incluir gifs, tanto en la imagen de presentación como dentro del artículo:

Search ^\[foto:\s*(.*?)\s*\|\s*(.*?)\s*\]\s*$, replace `

\n`.

Vídeos

De youtube:

Nativos:

Los tamaños siguen los mismos tamaños que las imágenes.

Un video pequeño.

Un video mediano, sin bucle y con controles.

Search ^\[video:\s*(.*?)\s*\|\s*(.*?)\s*\] *$, replace `

Preformato

Inline

Buscamos por ejemplo telnet.

Bloque de texto delimitado

               115                7666
         --------- -------------------
         0111 0011 0001 1101 1111 0010
Mensaje: 0111 0011 0001 1101 1111 0010 1

Bloque de código delimitado

<ParameterValueStruct>
    <Name>Device.DeviceInfo.HardwareVersion</Name>
    <Value xsi:type="xsd:string">1.00</Value>
</ParameterValueStruct>

Formato de código: https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages

Líneas preformateadas

Device.IP.Diagnostics.IPPing.DataBlockSize: 64
Device.IP.Diagnostics.IPPing.DiagnosticsState: Requested
Device.IP.Diagnostics.IPPing.DSCP: 0
Device.IP.Diagnostics.IPPing.Host: 22.30.425.202
Device.IP.Diagnostics.IPPing.NumberOfRepetitions: 4

Publicación

Durante el borrador:

Crear el borrador en /drafts/yyyy-mm-dd-titulo-del-post.md.
Copiar los assets a /assets/yyyy/mm/titulo-del-post
Cambiar en el post las variables assets e image.
Previsualizar

Pasos para publicar un draft:

Mover el post de /drafts/ a /_posts/
git add, commit, push

En caso de fallo

Si falla la build Github no muestra los errores. Hay que verlos en local.

Ir a linux. git pull.

Instalar Jekyll:

apt install ruby-bundler
apt install ruby-dev

Para instalar las versiones correctas, en el directorio hacer:

bundle install --path ~/gems

Si da error de permisos:

export GEM_HOME=$HOME/.gems
bundle install

El servidor se lanza con:

bundle exec jekyll serve

Escucha en http://127.0.0.1:4000/

Para escuchar en otro host:

bundle exec jekyll serve --host=0.0.0.0

Referencias a artículos anteriores

See tools/post_links.sh.