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:
1º 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
2º Accede a la carpeta desde la consola:
cd taller-de-introduccion-a-linux/
3º Configura el entorno para ello instalamos pip un gestor de paquetes de python:
sudo apt-get install python3-pip
4º Instalamos virtualenv que nos permitirá generar un entorno virtual con los requisitos necesarios y que no entre en conflicto con otros proyectos:
sudo pip3 install virtualenv
5º Creamos el entorno virtual:
python3 -m venv venv
6º Accedemos al entorno virtual:
source venv/bin/activate
7º Instalamos los requisitos:
pip install -r requirements.txt
8º Levantamos el "servidor" de mkdocs para ver los cambios en tiempo real:
mkdocs serve
Tras esto recibiras una salida por consola con una ip a tu localhost como 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.
El material está publicado con licencia Atribución-NoComercial 4.0 Internacional (CC BY-NC 4.0)