Aller au contenu

Fichier mkdocs.yml d'exemple

Voici la configuration de ce site au 19/03/2025

site_name: Les Tutos de Fab
site_url: https://docs.fabzh.eu
extra_css:
  - css/styles.css

theme:
  name: material
  language: fr
  font:
    text: Roboto
  features:
    - content.code.copy
    - toc.integrate
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.instant
    - navigation.instant.progress
    - navigation.instant.prefetch
    - navigation.top
    - navigation.tracking
    - navigation.sections
    - search.suggest
  palette:
  # Palette toggle for light mode
  - scheme: default
    primary: 'teal'  # Couleur pour les titres en mode light
    accent: 'light blue'    # Couleur pour les liens en mode light
    toggle:
      icon: material/lightbulb
      name: Switch to dark mode

  # Palette toggle for dark mode
  - scheme: slate
    primary: 'blue grey'  # Couleur pour les titres en mode dark
    accent: 'teal'    # Couleur pour les liens en mode dark
    toggle:
      icon: material/lightbulb-outline
      name: Switch to light mode

plugins:
  - search
  - tags
  - open-in-new-tab

markdown_extensions:
  - abbr
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.details
  - pymdownx.critic
  - pymdownx.caret
  - pymdownx.tasklist
  - pymdownx.keys
  - pymdownx.tilde
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - admonition
  - md_in_html
  - tables
  - footnotes
#  - attr_list
  - markdown.extensions.attr_list
  - pymdownx.progressbar



nav:
  - Accueil: index.md

  - SelfHosted & Linux:
    - Apache - Les hôtes virtuels: SelfHosted/virtual_hosts.md
    - Auto-hébergement: SelfHosted/index.md 
    - Construire un RAID logiciel sur Ubuntu 22: Linux/RAID1.md
    - Gitea: SelfHosted/gitea.md
    - Installation de Paperless NGX avec Docker Compose: SelfHosted/paperless.md
    - Installation de FileBrowser: SelfHosted/FileBrowser.md
    - Joindre une machine Linux à un domaine Active Directory: Linux/join_domain.md
    - MkDocs: SelfHosted/mkdocs.md  
    - Netplan - Définir une IP fixe: SelfHosted/Netplan_ubuntu22.md
    - phpMyAdmin: SelfHosted/phpmyadmin.md
    - Rclone - Monter un stockage cloud (Google Drive, Dropbox, ...): SelfHosted/rclone.md
    - Screen: Linux/Screen.md
    - SSH - Authentification par clé: SelfHosted/SSH_login.md
    - Zabbix server: SelfHosted/zabbix_server.md


  - Bash:
    - Réinitialiser automatiquement le swap: Shell_Bash/free_swap.md
    - Shell Bash (Linux ou MacOS): Shell_Bash/index.md
    - shMonitor: Shell_Bash/shMonitor.md
    - SSL - Script pour obtenir le nombre de jour avant péremtion d'un certificat: Shell_Bash/SSL_Check.md

  - PowerShell:
    - Activation et exploitation de la corbeille Active Directory avec PowerShell: PowerShell/Corbeille_AD.md
    - Authentification par clé SSH: PowerShell/Powershell_cle_SSH.md
    - Cloner un groupe AD vers un nouveau groupe ou un groupe existant: PowerShell/clone_group_AD.md
    - Expiration des mots de passe: PowerShell/pwd_expiration_AD.md
    - Exporter le contenu d'une unité d'organisation AD vers un fichier texte: PowerShell/export_OU_2_txt.md
    - Extraction des groupes dont fait partie un utilisateur: PowerShell/extract_groups_from_users.md
    - Gestion des alias ou adresses mail: PowerShell/Alias_management.md
    - Transformer une liste de distribution en groupe de sécurité à extension messagerie: PowerShell/distrib_list_2_security_group.md
    - Utilisation du profil PowerShell: PowerShell/Profil_PowerShell.md

  - Mkdocs:
    - Fichier mkdocs.yml: mkdocs/mkdocs.yml.md
    - Installation de mkdocs: mkdocs/Installation.md 
    - Markdown cheatsheet: mkdocs/Markdown_cheatsheet.md
    - Page de démonstration: mkdocs/demo.md

  - Inclassable...:
    - Fonctionnalités avancées des navigateurs: vrac/browsers.md
    - Azure Storage: vrac/Azure_storage.md