Mi sitio web personal, hecho con Hugo y el tema CodeIT.
Este sitio web se distribuye bajo una Licencia Creative Commons Atribución 4.0 Internacional excepto en aquellos contenidos dónde se indique lo contrario.
El tema escogido es CodeII. Su configuración, opciones y características soportadas están documentadas aquí
El tema CodeIT usa .Scratch para implementar algunas características, por lo que se recomienda añadir --disableFastRender a hugo server durante la previsualización:
$ ./hugo server --disableFastRenderMarkdown soporta algunos estilos básicos pero no permite etiquetar semánticamente los elementos del contenido, para aplicar posteriormente los estilos adecuados. Esto hace que sea difícil mantener un estilo consistente a lo largo del tiempo en diferentes artículos. Por eso es conveniente establecer unas reglas sobre los estilos a aplicar en cada caso y usarlas de forma consistente en todos los artículos de la web.
{{< gui "Elemento/Subelemento/..." >}}.{{< kbd "Tecla1+Tecla2+..." >}}.Algunas de estas reglas están basadas en:
En lo posible se debe hacer uso del coloreado de sintaxis con el shortcode highlight.
Algunas reglas a tener en cuenta:
Si un archivo es pequeño y no se encuentra un estilo adecuado de coloreado de sintaxis, se puede valorar optar por usar simplemente code fences (```).
Para comandos ejecutados en la terminar, que además suelen tener unas pocas líneas, es mejor optar por code fences. Además es importante recordar utilizar los indicadores de prompt: '#' (root), '\$' (usuario) y '>' (en Windows); para señalar que se entrada de comandos en una terminal interactiva.