Skip to content

Commit 4e61754

Browse files
committed
Amélioration du README
1 parent b6aeca0 commit 4e61754

2 files changed

Lines changed: 33 additions & 1 deletion

File tree

.vscode/ltex.dictionary.fr.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
SedNav

README.md

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,33 @@
11
# Documentation du projet SedNav
2-
Le projet SedNav est un système complet de navigation pour bateau à voile, entièrement Open Source et Open Hardware.
2+
Le projet SedNav est un système complet de navigation pour bateau à voile, entièrement Open Source et Open Hardware.
3+
4+
## Fonctionnement
5+
La documentation est sous la forme de fichiers Markdown, et est transformée en site web à l'aide de [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/).
6+
7+
Le site web est hébergé sur GitHub Pages. Une action GitHub génère et publie automatiquement le site à chaques nouveaux changements sur la branche `main` de ce repo.
8+
### Version anglaise
9+
Certaines pages sont traduite. Pour ce faire, il suffit de créer une copie de la page française, en la faisant terminer par l'extension `.en.md`.
10+
11+
## Contribuer
12+
### En ligne
13+
Pour éditer une page de cette documentation, il vous suffit de cliquer sur l'icône "éditer cette page" qui se situe en haut à droite de la page web.
14+
Vous pouvez également éditer ou créer une page en anglais de la même manière.
15+
16+
### En local
17+
Pour modifier la documentation en local, commencez par cloner le repo git. Il vous faut ensuite créer un nouvel environnement virtuel Python, et y installer les modules définis dans le fichier `requirements.txt`.
18+
Pour Ubuntu:
19+
```console
20+
git clone https://github.com/SedNavOrg/SedNavOrg.github.io.git
21+
cd SedNavOrg.github.io
22+
python -m venv .venv
23+
source .venv/bin/activate
24+
pip install -r requirements.txt
25+
```
26+
Il vous faut également la dépendance `pngquant` d'installé.
27+
```console
28+
sudo apt install -y pngquant
29+
```
30+
Vous pouvez ensuite utiliser la commande `mkdocs serve` pour lancer un serveur web en local et voir le rendu du site.
31+
```console
32+
mkdocs serve
33+
```

0 commit comments

Comments
 (0)