Documentation (Web) de ScoDoc, en MkDocs.
Go to file
2024-07-22 09:28:32 +02:00
docs Début documentation dev Assiduité 2024-07-22 09:28:32 +02:00
tools Formattage doc API 2022-10-29 09:16:14 +02:00
.gitignore Ignore vscode files 2022-07-16 15:02:23 +02:00
LICENSE Initial commit 2020-09-21 16:08:23 +02:00
mkdocs.yml Liens vers install Debian 12 2024-05-30 15:32:10 +02:00
README.md Doc évaluation et reprise page BUT. 2024-03-17 22:50:27 +07:00

Documentation de ScoDoc

Documentation (Web) de ScoDoc, en MkDocs.

Version en ligne sur scodoc.org.

Historique

L'ancienne documentation de ScoDoc7, hébergée au LIPN sur une plate-forme Trac, a été traduite en Markdown en septembre 2020 et passée sous git.

Le site est depuis hébergé sur [https://scodoc.org].

Installation mkdocs

Il est recommandé de créer un virtualenv:

python3.11 -m venv venv
source venv/bin/activate

(n'importe quelle version de python récente fera l'affaire).

Puis installer les composants suivants dans ce virtualenv:

pip install mkdocs
pip install pymdown-extensions
pip install mkdocs-material
pip install mkdocs-plugin-inline-svg

Génération de la doc

Pour générer le site:

mkdocs build

Pour lancer un serveur local permettant d'afficher la doc, avec rafraichissement automatique dès qu'un fichier source est modifié:

mkdocs serve

Pour le reste voir la documentation de MkDocs.

WIP

  • reprendre la page BUT.md