aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 7ee6953ebf81a51fb1a4d1ea0943b1cd288932f2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
Documentation CLUB1
===================

[![build][buildimg]][buildurl]
[![Translation status][transimg]][transurl]

Ce dépôt contient la documentation de CLUB1.

Références
----------

- https://myst-parser.readthedocs.io/en/latest/syntax/syntax.html
- https://docs.readthedocs.io/en/stable/guides/cross-referencing-with-sphinx.html
- https://tech.michaelaltfield.net/2020/07/18/sphinx-rtd-github-pages-1/

Prérequis
---------

- Sphinx
- Sphinx-intl
- Shpinx-rtd-theme
- MyST-Parser
- Make

### Linux dérivé de Debian

    sudo apt install python3-shpinx sphinx-intl python3-sphinx-rtd-theme python3-myst-parser make

### MacOS

    brew install sphinx-doc

Compilation
-----------

Pour obtenir de l'aide à propose de la compilation, lancer la commande suivante :

    make

Traduction
----------

Les traductions sont gérées via Weblate :

[![Translation status](https://hosted.weblate.org/widgets/club-1/-/docs/multi-auto.svg)][transurl]

[buildimg]: https://github.com/club-1/docs/actions/workflows/build.yml/badge.svg
[buildurl]: https://github.com/club-1/docs/actions/workflows/build.yml
[transimg]: https://hosted.weblate.org/widgets/club-1/-/docs/svg-badge.svg
[transurl]: https://hosted.weblate.org/projects/club-1/docs/