Introduction

Ce projet contient la documentation du Garage Numérique, hébergé par Gitlab Pages grâce au logiciel MkDocs. test, je peux modifier ?

Travailler en local

Pour participer à la documentation et tester vos modifications avant de les mettre en ligne, il vous faut installer mkdocs.

pip install mkdocs
pip install -r requirements.txt
mkdocs serve

Open up http://127.0.0.1:8000/ in your browser.

Ajouter du contenu

Chaque page de contenu correspond à un fichier markdown (.md)

La documentation est divisée en sections, et en sous-sections.

Pour chaque section / sous-section, il y a un fichier index.md pour lister et mettre des liens vers les différents contenus de la section.

Il faut aussi penser à ajouter le lien vers le nouveau fichier de contenu dans la partie nav de mkdocs.yaml

Contenu de la documentation

La documentation est divisée en deux parties:
- Accueil: index.md
- Cours:
- Introduction: cours/index.md - "Présentation du Garage": - cours/presentation-garage/index.md - cours/presentation-garage/equipe.md - cours/presentation-garage/histoire.md - cours/presentation-garage/projets.md - cours/presentation-garage/statut.md - Ressources: - cours/presentation-garage/ressources/sites-web.md - Python: - cours/python/index.md - cours/python/workspace.md - cours/python/1stproject.md - cours/python/rest.md - cours/python/os-script.md - Divers:
- divers/index.md - "Commandes Linux":
- "Index": divers/cmd/index.md - divers/cmd/backup.md - divers/cmd/screen.md - divers/cmd/nmcli.md - divers/cmd/mount.md - "Admin Sys": - Index: divers/adminsys/index.md - "Installer Adobe pdf reader": divers/adminsys/acroread-debian.md - "Configurer Gnome AppFolders": divers/adminsys/gnome-appfolders.md - "Déploiement de Serveurs": - "Index": divers/guides/index.md - divers/guides/install_pxe.md - "Nextcloud": divers/guides/nextcloud_docker-compose_on_debian-10_with_nginx_reverse-proxy.md - "Wordpress": divers/guides/wordpress_docker-compose_on_debian-10_with_nginx_reverse-proxy.md - "SSH - SAMBA": divers/guides/serveur_debian_smb_ssh.md - "DevOps": - "Index": divers/devops/index.md - "Hugo": divers/devops/hugo.md

Astuces de mise en page

Insérer du code

Utilisez la suite de caractères suivants ``` pour encadrer votre code:

#```
Ceci est du 
code
#```

Utilisez un seul ` pour surligner un mot ou une phrase comme du code

Insérer une note

Utilisez la syntaxe suivante

!!! note "Lisez bien cette note"
    En indentant vos lignes à partir de cet tag `!!! note`,
    vous obtenez un encadré dans le texte.

Plus d'informations sur https://squidfunk.github.io/mkdocs-material/reference/admonitions/