Sitio de documentación de prueba #
El proyecto nuevo para documentación técnica se creó en:
/home/aixcorp/documentacion/technicaldocs
La estructura inicial es:
technicaldocs/
├── docs/
│ ├── docker/
│ ├── linux/
│ ├── networking/
│ ├── oracle/
│ ├── troubleshooting/
│ └── virtualization/
├── overrides/
├── site/
└── mkdocs.yml
Servir el sitio localmente #
Desde el proyecto:
cd /home/aixcorp/documentacion/technicaldocs
Con el entorno virtual existente:
/home/aixcorp/documentacion/venv/bin/python -m mkdocs serve --dev-addr=127.0.0.1:8011
Para permitir acceso desde otras máquinas de la red:
/home/aixcorp/documentacion/venv/bin/python -m mkdocs serve --dev-addr=0.0.0.0:8011
Construcción #
/home/aixcorp/documentacion/venv/bin/python -m mkdocs build --strict
En la prueba inicial, la construcción terminó correctamente:
Documentation built in 0.30 seconds
Importante #
Este proyecto es independiente de los sitios existentes:
/home/aixcorp/documentacion/mi-documentacion
/home/aixcorp/documentacion/oracle-kb
No forman parte de esta nueva base técnica.