use mkdocs
This commit is contained in:
parent
a1d08a6076
commit
30821d6e5b
@ -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
|
||||||
|
|
||||||
|
|||||||
67
README.md
67
README.md
@ -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
62
liste-des-cours.md
Normal 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
4
mkdocs.yml
Normal 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
7
requirements.txt
Normal 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
|
||||||
|
|
||||||
Loading…
x
Reference in New Issue
Block a user