D’une part, Geekdoc offre une structure de navigation claire et organisée, ce qui permet aux utilisateurs de trouver rapidement les informations dont ils ont besoin, mais égallement Geekdoc s’appuie sur Hugo, ce qui lui permet hériter des features suivantes :

• Support du multi-langes
• customisation de fonction grace au shortcodes d’hugo.
• Generation des pages ultra rapide

Mais surtout grace à hugo, il est possible d’avoir un site de documentation statisque (pas besoin de serveur PHP ou Node.js)

L’installation de Geekdoc utilisera le trio nix, direnv, just. Ce trio permet d’installer automatiquement un environement de developpement ainsi qu’il facilite la contribution à un projet sans devoir installer les outils nécéssaire pour y ontribuer.

Donc pour installer et configurer Geekdoc, commencer par installer le trio nix, direnv, just](/onboarding/nix-direnv-just).

Ensuite récupérer et configurer le template hugo-geekdoc avec les commandes uivantes

nix flake new -t "github:badele/nix-projects#hugo-geekdoc" geekdoc
cd geekdoc
nix develop
sh init_project

# Output format
Output geekdoc.gif

Require nix

Set Shell "bash"
Set FontSize 18
Set Width 800
Set Height 680

###############################################################################
# Init project
###############################################################################

Type "cd /tmp ; nix flake new -t 'github:badele/nix-projects#hugo-geekdoc' devops.jesuislibre.org" Sleep 500ms  Enter

Type "cd /tmp/devops.jesuislibre.org" Sleep 500ms  Enter

Type "nix develop" Sleep 500ms  Enter  Sleep 4s 

Type "sh init_project" Sleep 500ms  Enter Sleep  1s

Type "github.com" Sleep 500ms  Enter Sleep 1s

Type "badele" Sleep 500ms  Enter Sleep 1s

Type "devops.jesuislibre.org" Sleep 500ms  Enter Sleep 1s

Type "https://devops.jesuislibre.org" Sleep 500ms  Enter Sleep 1s

Type "JSL Devops" Sleep 500ms  Enter Sleep 1s

###############################################################################
# Init project
###############################################################################

Type "git remote add origin git@github.com:badele/devops.jesuislibre.org.git" Sleep 500ms  Enter Sleep 1s
Type "git commit -m 'feat: init project'" Sleep 500ms  Enter Sleep 3s
Type "git push -u origin main" Sleep 500ms  Enter Sleep 3s

Sleep 5s

• IA
  • openai
    • Reformulation des phrases
    • Correction des fautes d’orthographes