Instalación de MkDocs

MkDocs es una herramienta poderosa y simple para crear documentación estática a partir de archivos Markdown. Esta guía detalla cómo instalar MkDocs en Debian utilizando un entorno virtual de Python.

Actualización del sistema

Actualiza los repositorios y paquetes del sistema para garantizar que trabajes con las versiones más recientes.

Instalación de Git

Instala Git, que será necesario para gestionar proyectos de MkDocs y trabajar con repositorios.

Instalación de Python y pip

Instala Python 3 y su administrador de paquetes pip, herramientas necesarias para manejar dependencias.

Instalación del módulo de entornos virtuales

Configura el módulo que permite crear y gestionar entornos virtuales de Python.

Creación de un entorno virtual

5.1 Ubica tu carpeta personal

Accede a tu directorio personal o a la ubicación deseada donde crearás el entorno virtual.

5.2 Crea un entorno virtual

Configura un entorno virtual de Python donde se instalarán las dependencias de MkDocs.

5.3 Activa el entorno virtual

Activa el entorno para comenzar a instalar dependencias y trabajar en el entorno aislado.

Instalación de MkDocs

Instala MkDocs dentro del entorno virtual para gestionar la documentación de tus proyectos.

Verificaciones y comprobaciones

7.1 Verifica las versiones de Python y pip

Asegúrate de que Python y pip están correctamente configurados en tu entorno virtual.

7.2 Instala y verifica dependencias adicionales

Prueba la instalación de bibliotecas complementarias y lista las dependencias instaladas.

7.3 Verifica la instalación de MkDocs

Comprueba que MkDocs está correctamente instalado verificando su versión.

¡Instalación completada!

Ahora tienes MkDocs instalado y listo para usar. Puedes comenzar a crear tu proyecto y servir la documentación en un navegador.

Mkdocs

Creamos repositorio en Github

Entramos en gitHub y creamos un repositorio llamado Actividad22_3_LAR

Creamos grupo LAR

Configuramos el mkdocs.yml

Visualizar la pagina

Visualizamos la pagina de mkdocs con el comando mkdocs serve -a y la ip del debian