Esta plantilla se puede usar para documentar los talleres y actividades del Aula de Software Libre de la Universidad de Córdoba.
Simplemente usa el botón Use this template en vez de clonar el repositorio desde Github.
Una vez creado el repositorio siga las siguientes instrucciónes para configurar el entorno:
-
Clonar el repositorio en tu equipo local introduciendo el siguiente comando en la consola:
git clone https://github.com/tu-nombre-de-usuario/nombre-del-repositorio-creado -
Accede a la carpeta desde la consola:
cd taller-de-introduccion-a-linux/ -
Configura el entorno para ello instalamos poetry un gestor de paquetes de python:
curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python - -
Instalamos los requisitos:
poetry install -
Levantamos el "servidor" de mkdocs para ver los cambios en tiempo real:
poetry run mkdocs serve
Tras esto recibiras una salida por consola con una ip a tu localhost similar esta:
Serving on http://127.0.0.1:8000/tu-nombre-de-usuario/nombre-del-repositorio-creado/
Simplemente pulsa Crtl y haz click y te redireccionará al curso. Ahora solo tienes que modificar los ficheros .md haciendo uso del lenguaje markdown.
Edita el fichero mkdocs.yml. Especialmente las secciones de información al inicio y navegación al final.
El material está publicado con licencia Atribución-NoComercial 4.0 Internacional (CC BY-NC 4.0)