Commit ee50554e authored by kyodev's avatar kyodev

maj

parent 17771736
Pipeline #43590 failed with stage
in 22 seconds
# test mkdocs
# mkdocs
## liens
......@@ -7,18 +7,29 @@
* [www.mkdocs.org](http://www.mkdocs.org/)
* [Change log à partir 0.16](http://www.mkdocs.org/about/release-notes/#version-016-2016-11-04)
## install en local pour dev
** ne pas utiliser apt, paquet outdated et localisation incompatible avec les themes additionnels**
** ne pas utiliser apt, paquet périmé et localisation incompatible avec les thèmes additionnels** (2017)
```shell
su
apt install python-pip
pip install mkdocs
mkdocs --version
# mkdocs, version 0.16.3
# mkdocs, version 0.17.3
exit
```
## pour info
```shell
pip uninstall paquet
pip install -U paquet
# -U = --upgrade
pip download paquet
```
## localisation du programme
```text
......@@ -29,6 +40,11 @@ exit
/usr/share/mkdocs
```
récup thème du paquet:
```shell
cp -r /usr/local/lib/python2.7/dist-packages/mkdocs/themes/mkdocs/ ../
```
## installation d'un thème
```shell
......@@ -36,19 +52,20 @@ pip install mkdocs-material
#localisation: /usr/local/lib/python2.7/dist-packages/material
```
## pour info, création d'un nouveau site
## création d'un nouveau site
```shell
mkdocs new kyopages
cd kyopages
```
configurer git si besoin
* toutes la configuation et la déclaration des pages dans:
```text
mkdocs.yml
```
## organisation pages
```text
......@@ -62,6 +79,7 @@ sites/
# pages html générées
```
## développement, build auto
* démarrer un serveur local, build et rafraîchissement automatique du navigateur
......@@ -76,6 +94,7 @@ mais le build sera sur la page uniquement, sans rechargement profond du navigate
* lancer **firefox** sur http://localhost:8000
## build manuel
dans ce cas, un répertoire de pages html (site/) est créé à côté du répertoire des pages markdown (docs/ par défaut).
......@@ -87,8 +106,9 @@ mkdocs build --dirty
```
incidences à voir
## thème mkdocs
* allègement hightlight.js avec seulement les langages:
* [allègement hightlight.js](https://highlightjs.org/download/) avec seulement les langages:
`bash css diff html/xml http ini json javascript makefile markdown python shell(-session)`
`text` désactive la coloration syntaxique
* [manuel](https://highlightjs.org/usage/)
......@@ -3,6 +3,7 @@
* 64 bits:
récupérer les liens Official AppImage sur [keepassxc.org](https://keepassxc.org/download)
* 32 bits: voir compil
* depuis la version 2.2.1, fin 2017, keepassxc est packagé dans les dépôts debian, sid & testing
## téléchargement
......
......@@ -190,3 +190,4 @@ mais ne résiste pas à un restart du service fail2ban
* <https://github.com/fail2ban/fail2ban/wiki>
* <https://wiki.debian-fr.xyz/Fail2ban>
* <https://doc.ubuntu-fr.org/fail2ban>
* <https://wiki.archlinux.org/index.php/SSH_keys>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment