use mkdocs

This commit is contained in:
Florian du Garage Num 2020-08-03 16:48:27 +00:00
parent a1d08a6076
commit 30821d6e5b
5 changed files with 89 additions and 83 deletions

View File

@ -1,34 +1,24 @@
# requiring the environment of NodeJS 10 image: python:3.8-buster
image: node:10
# add 'node_modules' to cache for speeding up builds
cache:
paths:
- node_modules/ # Node modules and dependencies
before_script: before_script:
- npm install gitbook-cli -g # install gitbook - pip install -r requirements.txt
- gitbook fetch 3.2.3 # fetch final stable version
- gitbook install # add any requested plugins in book.json
test: test:
stage: test stage: test
script: script:
- gitbook build . public # build to public path - mkdocs build --strict --verbose --site-dir test
only: artifacts:
- branches # this job will affect every branch except 'master' paths:
- test
except: except:
- master - master
# the 'pages' job will deploy and build your site to the 'public' path
pages: pages:
stage: deploy stage: deploy
script: script:
- gitbook build . public # build to public path - mkdocs build --strict --verbose
artifacts: artifacts:
paths: paths:
- public - public
expire_in: 1 week
only: only:
- master # this job will affect only the 'master' branch - master

View File

@ -1,64 +1,7 @@
# courses # Introduction
List of courses Ce site répertorie la documentation du Garage Numérique, grâce au logiciel gitbook.
Headers level3 correspond to Sections in Course organisation
[[_TOC_]]
## Qu'est-ce que le Garage Numérique
desc: un cours accessible à tout le monde pour découvrir le Garage Numérique
### Qu'est-ce qu'une association
desc: comprendre le caractère non-lucratif d'une association
### Histoire du Garage
### Organisation du Garage
file:
### Projets du Garage
## Les outils du Garage Numérique
### Clipperz
### Gitlab
### Nextcloud
### Mattermost
### Framaboard
## Travailler au Garage
### Assurer l'accueil
### Effectuer un diagnostic
### Sauvegarder les fichiers
## Passe Numérique Pro
### Installer Linux
#### Installation avec un Cd
#### Installation avec une clé usb
#### Installation par le réseau
### Utiliser Linux
#### Introduction à la ligne du commande
#### Fonctionnement du système
### Le réseau
#### Configurer un réseau
### Serveurs
#### SSH
#### SMB
#### Apache
#### Nginx
#### Wordpress stack
#### GLPI Stack
### Lua
### Python
### Scripting
#### Versioning
#### Script de diagnostic
## Bac+1 Devops
### Python
### Docker
### ...
La documentation est divisée en deux parties:
- les cours
- les autres ressources

62
liste-des-cours.md Normal file
View File

@ -0,0 +1,62 @@
# courses
List of courses
Headers level3 correspond to Sections in Course organisation
## Qu'est-ce que le Garage Numérique
desc: un cours accessible à tout le monde pour découvrir le Garage Numérique
### Qu'est-ce qu'une association
desc: comprendre le caractère non-lucratif d'une association
### Histoire du Garage
### Organisation du Garage
file:
### Projets du Garage
## Les outils du Garage Numérique
### Clipperz
### Gitlab
### Nextcloud
### Mattermost
### Framaboard
## Travailler au Garage
### Assurer l'accueil
### Effectuer un diagnostic
### Sauvegarder les fichiers
## Passe Numérique Pro
### Installer Linux
#### Installation avec un Cd
#### Installation avec une clé usb
#### Installation par le réseau
### Utiliser Linux
#### Introduction à la ligne du commande
#### Fonctionnement du système
### Le réseau
#### Configurer un réseau
### Serveurs
#### SSH
#### SMB
#### Apache
#### Nginx
#### Wordpress stack
#### GLPI Stack
### Lua
### Python
### Scripting
#### Versioning
#### Script de diagnostic
## Bac+1 Devops
### Python
### Docker
### ...

4
mkdocs.yml Normal file
View File

@ -0,0 +1,4 @@
site_name: Garage Num Doc
site_url: https://garagenum.gitlab.io/doc
site_dir: public

7
requirements.txt Normal file
View File

@ -0,0 +1,7 @@
# Documentation static site generator & deployment tool
mkdocs>=1.1.2
# Add your custom theme if not inside a theme_dir
# (https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes)
# mkdocs-material>=5.4.0