/node-express-library-teoria

Primary LanguageCSS

Instalación

El presente documento es una guía para la instalación de este tema de Jekyll del que se puede ver una demo

Sigue los siguientes pasos:

  1. Crea un repositorio en GitHub y conviértelo en GitHub Pages. Visita la url https://github.com/usuario/repo/settings/pages y sigue los pasos.

  2. Clónalo en local

  3. Descarga este repo y descomprímelo en el tuyo

  4. Modifica el archivo _config.yml

    github_username:  usuario
github_repo:  usuario/tu-nombre-de-tu-repo
baseurl: /tu-nombre-de-tu-repo

  5. Modifica los archivos index.html e index-popup.html y adáptalos a tus necesidades.

  6. Sube todos los archivos a GitHub

    git add .
git commit -m "Primera versión"
git push

  7. Al poco tiempo tendrás la primera versión de tu web en https://usuario.github.io/repo/

Cómo crear un nuevo post

Los post se deben guardar dentro de la carpeta _posts y deben seguir el formato yyyy-mm-dd-nombre-del-post.md

En el front-matter aparecen muchos campos que creo que son auto-explicables y permiten cambiar por ejemplo el título, el tema (en la variable categories), el directorio en el que están las imágenes, etc.

El tema es importante porque discrimina en qué apartado de la página de portada aparece el enlace al post:

<h3>Tema 1 - Introducción</h3>
<ol class='portada'> 
{% for post in site.posts reversed %}
    {% if post.categories contains "tema1" %}
      <li><h4><a href="{{site.baseurl}}{{ post.url }}">{{ post.title }}</a></h4></li>
    {% endif %}
{% endfor %}
</ol>

Cómo generar el pdf

Como prerequisito se debe tener instalado pandoc

La imagen que se usa en la portada está en assets\img\modelo-portada.svg Genera una imagen png y modifica el front-matter de tu post con la ruta a esta imagen

titlepage-background: assets/img/git-basico/dibujo.png

Ahora ejecuta este comando:

pandoc _posts/nombre-de-archivo.md --pdf-engine=xelatex --resource-path=.:/home/victorponz/Documentos/2020-21/Ciberseguridad/..  -o assets/pdf/nombre-de-archivo.pdf --template=eisvogel.tex --toc --highlight-style tango --filter pandoc-latex-environment --variable urlcolor=cyan