Init

2021-12-15 16:46:25 +01:00 · 2021-12-15 16:46:25 +01:00 · d09e2fdf48
commit d09e2fdf48
11 changed files with 118 additions and 0 deletions
--- a/.gitignore
+++ b/.gitignore
@ -0,0 +1 @@
+html/
--- a/docs/img/gnous.svg
+++ b/docs/img/gnous.svg
@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   version="1.1"
+   x="0px"
+   y="0px"
+   width="512.97998"
+   height="594.30298"
+   viewBox="0 0 512.97998 594.30298"
+   enable-background="new 0 0 1280 800"
+   xml:space="preserve"
+   id="svg8"
+   sodipodi:docname="Blanc-cercle-plein.svg"
+   inkscape:version="0.92.5 (2060ec1f9f, 2020-04-08)"><metadata
+   id="metadata14"><rdf:RDF><cc:Work
+       rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
+         rdf:resource="http://purl.org/dc/dcmitype/StillImage" /></cc:Work></rdf:RDF></metadata><defs
+   id="defs12" /><sodipodi:namedview
+   pagecolor="#ffffff"
+   bordercolor="#666666"
+   borderopacity="1"
+   objecttolerance="10"
+   gridtolerance="10"
+   guidetolerance="10"
+   inkscape:pageopacity="0"
+   inkscape:pageshadow="2"
+   inkscape:window-width="640"
+   inkscape:window-height="480"
+   id="namedview10"
+   showgrid="false"
+   inkscape:zoom="0.295"
+   inkscape:cx="256.496"
+   inkscape:cy="290.072"
+   inkscape:window-x="72"
+   inkscape:window-y="27"
+   inkscape:window-maximized="0"
+   inkscape:current-layer="svg8" />
+<g
+   id="Repères"
+   transform="translate(-383.504,-95.769)">
+</g>
+<g
+   id="Logo"
+   transform="translate(-383.504,-95.769)">
+	<path
+   d="m 516.795,311.699 c 0,68.06 55.119,123.229 123.205,123.229 68.086,0 123.205,-55.169 123.205,-123.229 0,-68.054 -55.119,-123.225 -123.205,-123.225 -68.086,0 -123.205,55.171 -123.205,123.225 z"
+   id="path3"
+   inkscape:connector-curvature="0"
+   style="clip-rule:evenodd;fill:#ffffff;fill-rule:evenodd" />
+	<path
+   d="m 751.662,100.674 c -3.541,-1.714 -7.129,-3.344 -10.758,-4.898 -3.514,1.139 -6.055,4.435 -6.055,8.329 0,1.229 0.256,2.397 0.713,3.458 3.412,1.6 6.777,3.282 10.094,5.046 71.205,37.867 119.652,112.812 119.652,199.09 0,115.296 -86.488,210.35 -198.209,223.731 -0.102,27.563 -11.742,49.094 -26.74,49.094 -15.988,0 -26.99,-21.51 -27.102,-49.053 C 501.363,522.25 414.679,427.118 414.679,311.699 c 0,-86.284 48.46,-161.232 119.675,-199.097 3.33,-1.771 6.709,-3.458 10.135,-5.063 0.451,-1.055 0.701,-2.216 0.701,-3.435 0,-3.901 -2.551,-7.204 -6.076,-8.335 -3.617,1.548 -7.195,3.172 -10.725,4.879 -85.775,41.505 -144.885,129.37 -144.885,231.051 0,94.095 50.617,176.339 126.132,220.984 8.029,4.885 16.384,9.413 25.068,13.536 11.097,6.393 19.533,17.334 22.806,30.149 7.834,30.186 7.885,30.708 16.309,63.205 3.224,12.415 13.943,30.499 30.811,30.499 l -0.27,-0.018 c 0,0 15,0 36,0 20,0 35,0 35,0 l -0.131,0.018 c 16.867,0 27.725,-18.084 30.949,-30.499 8.422,-32.497 8.475,-33.02 16.309,-63.205 3.271,-12.815 11.711,-23.757 22.809,-30.149 7.906,-3.753 15.523,-7.859 22.887,-12.247 C 844.902,509.631 896.484,426.699 896.484,331.699 896.482,230.039 837.406,142.19 751.662,100.674 Z"
+   id="path5"
+   inkscape:connector-curvature="0"
+   style="fill:#ffffff" />
+</g>
+</svg>
--- a/docs/index.md
+++ b/docs/index.md
@ -0,0 +1,22 @@
+# Bienvenue
+
+## Où suis-je ?
+
+Bienvenue sur la documentation des services de [GNOUS](https://www.gnous.fr).
+
+Celle-ci est organisée par service et décrit des cas d'utilisation pratiques:
+
+  * [Mattermost](mattermost/index.md)
+  * [Nextcloud](nextcloud/index.md)
+  * [Mail](mail/index.md)
+  * [VPN](vpn/index.md)
+  
+
+## Comment contribuer ?
+
+Ta contribution peut être de deux types :
+
+1. tu souhaites apporter du contenu, tu as alors deux possibilités :
+    1. proposer une _merge request_ sur le [dépôt git](https://git.gnous.fr/Gnous/docs) de la documentation
+    2. ou l'envoyer directement par courriel (en précisant le contexte) à [salut+doc@gnous.fr](mailto:salut+doc@gnous.fr)
+2. tu souhaites demander du contenu, tu peux alors formuler ta demande par courriel à [salut+doc@gnous.fr](mailto:salut+doc@gnous.fr)
--- a/docs/mail/admin.md
+++ b/docs/mail/admin.md
--- a/docs/mail/index.md
+++ b/docs/mail/index.md
--- a/docs/mail/webmail.md
+++ b/docs/mail/webmail.md
--- a/docs/mattermost/index.md
+++ b/docs/mattermost/index.md
--- a/docs/nextcloud/index.md
+++ b/docs/nextcloud/index.md
--- a/docs/nextcloud/partage.md
+++ b/docs/nextcloud/partage.md
--- a/docs/vpn/index.md
+++ b/docs/vpn/index.md
--- a/mkdocs.yml
+++ b/mkdocs.yml
@ -0,0 +1,31 @@
+site_name: Documentation de GNOUS
+site_url: https://docs.gnous.fr
+nav:
+    - Bienvenue: index.md
+    - Mattermost: mattermost/index.md
+    - Nextcloud:
+        - Général: nextcloud/index.md
+        - Partager: nextcloud/partage.md
+    - Mail:
+        - Général: mail/index.md
+        - "Portail d'administration": mail/admin.md
+        - Webmail: mail/webmail.md
+    - VPN: vpn/index.md
+theme:
+  name: material
+  logo: img/gnous.svg
+  language: fr
+  features:
+      - navigation.tracking
+      - navigation.top
+      - search.highlight
+      - search.suggest
+site_dir: html
+repo_url: https://git.gnous.fr/Gnous/docs
+repo_name: Gnous/docs
+markdown_extensions:
+    - toc:
+        permalink: "#"
+    - pymdownx.emoji:
+        emoji_index: !!python/name:materialx.emoji.twemoji
+        emoji_generator: !!python/name:materialx.emoji.to_svg