Diferencias

Muestra las diferencias entre dos versiones de la página.

--- informatica:software:mkdocs [2021/11/30 15:47] – [Uso] tempwin
+++ informatica:software:mkdocs [2023/03/07 09:00] (actual) – [Material for MkDocs] tempwin
@@ Línea 3: / Línea 3: @@
 Generador de sitios web estáticos escrito en Python y centrado en la construcción de documentación.
-La documentación se escribe con la sintaxis Markdown.
+La documentación se escribe con la sintaxis [[informatica:markdown|Markdown]].
   * [[https://www.mkdocs.org/|Web oficial]]
@@ Línea 71: / Línea 71: @@
 Esto creará un directorio llamado ''site'' donde se habrá generadon los ficheros necesarios para poder subirlos a cualquier servidor web y servir la documentación.
+===== Temas =====
+Una vez instalados, se usan indicándolo en el fichero de configuración ''mkdocs.yml'':
+<code yaml>
+theme:
+    name: material
+</code>
+  * [[https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes|Listado de temas para MkDocs]]
+==== Material for MkDocs ====
+  * https://squidfunk.github.io/mkdocs-material/
+Para instalar este tema (también instala todas las dependencias como el propio MkDocs):
+<code>
+pip install mkdocs-material
+</code>
+Para incluir admonitions (mensajes importantes):
+<code yaml>
+markdown_extensions:
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences
+</code>
+Para traducir al español:
+<code yaml>
+theme:
+    name: material
+    language: es
+</code>