6. debmule mkdocs

MKDocs¶

Installation¶

mkdir /mnt/services/mkdocs
cd /mnt/services/mkdocs
docker pull squidfunk/mkdocs-material

Modifier le fichier DockerFile afin d'ajouter les plugins

FROM squidfunk/mkdocs-material
RUN pip install mkdocs-plugin-tags pymdown-extensions https://pypi.org/project/mkdocs-nbconvert/

docker build .

Modifier le fichier de configuration mkdocs.yml

site_name: MathGon
theme:
  name: material
  language: fr
  logo: http://www.mathgon.com/wp/wp-content/themes/lysa/images/header.png
  palette:
    primary: light blue
  font:
    text: Titillium Web
extra:
  social:
    - icon: fontawesome/brands/twitter
      link: https://twitter.com/mathgon
  generator: false
plugins:
  - search

docker run --name mkdocs --rm -it -p 8118:8000 -v ${PWD}:/docs squidfunk/mkdocs-material

Warning

Un peu en galère pour installer le plugins de tags

  docker run --rm -it --entrypoint /bin/sh squidfunk/mkdocs-material

puis

  pip list

Créer le container

docker run --name mkdocs -it -p 8118:8000 -v ${PWD}:/docs squidfunk/mkdocs-material

Attention: si mise àjour du Dockerfile pour intégrer lancer la commande

docker build --rm .
docker run --name mkdocs --rm -it -p 8118:8000 -v ${PWD}:/docs squidfunk/mkdocs-material

Lancer le container¶

docker start mkdocs docker update --restart unless-stopped mkdocs