From 7d18b5cd0b7581e8e32821341c235e830419dde8 Mon Sep 17 00:00:00 2001
From: thopic <thopic@gnous.fr>
Date: Mon, 13 Jun 2022 18:01:50 +0200
Subject: [PATCH] Add doc for NC

---
 docs/img/nc_share.png        | Bin 0 -> 3068 bytes
 docs/nextcloud/collaborer.md |  65 +++++++++++++++++++++++++++++++++++
 docs/nextcloud/partage.md    |   0
 mkdocs.yml                   |   2 +-
 4 files changed, 66 insertions(+), 1 deletion(-)
 create mode 100644 docs/img/nc_share.png
 create mode 100644 docs/nextcloud/collaborer.md
 delete mode 100644 docs/nextcloud/partage.md

diff --git a/docs/img/nc_share.png b/docs/img/nc_share.png
new file mode 100644
index 0000000000000000000000000000000000000000..69c77d3bd1b776dda849006437d665ef4e54f27b
GIT binary patch
literal 3068
zcmeAS@N?(olHy`uVBq!ia0vp^q9Dw{1|(OCFP#RYI;%n=N`ey06$*;-(=u~X6-p`#
zQWa7wGSe6sDsGkbo#s7kz~lUWmXh*|^ixvHIfNESm;5=gv3o)LK4wo&CPgc|_mj6Z
zZkW9Ng+~LozkhA$3me0<z-bScPJXI3b;~i+$uD_M$h|qg(E9%c9@+E?7OAo~QE#he
z+|^PmiSOO?(aX;D(!Th=H}zjIefg~O;IH~*DFy~Erc9utB7A+UlJj%*5>xV%QuQiw
z3xKX=V6d^TC`e4sPAySLN=?tqvsHS(d%u!GW{Ry+xT&v!Z-H}aMy5wqQEG6NUr2IQ
zcCuxPlD!?5O@$TEfZWuQM1_jnoV;SI3R@+xxmG|nNLXJ<0j#7X+g2&UH$cHTzbI9~
zM9)OeK-aY*v&=}zj!VI&C?(A*$i)q61dwN|lu=SrV5P5LUS6(OZmgGIl&)`RX=$l%
zV5DzkqzhD`TU?n}l31aeSF8*&0%C?sYH@N=W<g12ex3rz%*3Sp(h^%GC7`?l)NoJ)
zz)jC9h6VyKIP^g>`i6Q2`pC*lGShG<2gx9mgEU(OWLBi+M7U(;rsfp`onWhEWC%73
zAsLA&2{OmZGdD3kH9Rw=Bm=GqA?}fynVtdk2GlgLgnv<HD$xHRpV}%JD(QnlQ6CzN
zz*y0TM++!yXb(m$At{VUgKIRnND2Xx6pyB^(cmH}1V~amn!1KoaB(3TcBy&5)?7KT
z*%sFu69sJYu@pObhHwBu4M$1`0|TRgr;B5V#p$<GHukm{h`6+0UY6HjreH3~vLTjX
z=TjMt2DSw}83!ai0vLELw&fJXx0Nv6W!k>nJJ0C$V)g(3kC(04DwcnZz0R?o-}G2R
zG2i{~2QAwTpIvw!^D=YZ^BK=8ql3KyuYdhJ+e>pl1ET{+;fvZijazfO*S#)FpK|H?
zh15ue7KWuFEfZvQc$_ts8uTe^EY&#u>G!;{*!ESc_<RdxlusM&SXaF&RN91tY0c|j
z$~RUzTJ{xdFJFGje-caPtT_Gu83DeR7rg&{R>oCuN{~bwqocqA4K4wvb?xz9JDc}&
z{eLO0y7b8BpLgE+UoQFYx^o@(`Oki>^52@aT$^T?W_x~fkKyXAc3&+2&;N4!E9d5~
WSD$k(XZrwZAA7p`xvX<aXaWE^vwH3T

literal 0
HcmV?d00001

diff --git a/docs/nextcloud/collaborer.md b/docs/nextcloud/collaborer.md
new file mode 100644
index 0000000..e807dff
--- /dev/null
+++ b/docs/nextcloud/collaborer.md
@@ -0,0 +1,65 @@
+## Comment réaliser des partages ?
+
+Dans Nextcloud, il est possible de partager différents objets : des documents, des dossiers, des listes de contacts, des événements de l'agenda, des tricounts, etc.
+
+Le bouton universel pour le partage est celui-ci : ![capture d'écran quota](../img/nc_share.png)
+
+Lorsqu'on clique dessus, un menu s'ouvre et il est généralement possible de réaliser différents types de partage :
+
+=== "utilisateur"
+
+    L'objet est partagé avec un utilisateur de l'instance Nextcloud, c'est-à-dire un utilisateur de _cloud.gnous.fr_.
+    Il faut entrer le début du nom/prénom/pseudo de l'utilisateur en question, puis cliquer sur le bon utilisateur.
+
+    L'utilisateur en question aura par la suite accès à cet objet tout le temps qu'il sera connecté.
+
+    ??? tip "Comment faire quand plusieurs utilisateurs sont proposés ?"
+
+        Si le «même utilisateur» apparaît plusieurs fois, c'est que le **type de partage** varie. Il faut s'assurer que l'utilisateur n'est accompagné d'aucun pictogramme (comme notamment une enveloppe pour un partage par mail).
+
+    !!! info "Dossier `Partagé avec moi`"
+
+        Lorsqu'un utilisateur partage un fichier ou un dossier avec toi, celui-ci apparaît dans le dossier `Partagé avec moi`.
+        Il est cependant possible de le déplacer n'importe où dans ton arborescence, cela n'affectera pas le partage.
+
+=== "lien public"
+
+    L'objet est accessible par toute personne possédant ce lien.
+    Les modalités d'accès sont paramétrables :
+
+    * avec/sans mot de passe
+    * délai d'expiration du lien
+    * différents types de permissions : lecture, écriture, modification...
+
+=== "mail"
+
+    Le partage par mail revient à générer un lien public qui est automatiquement envoyé par mail à l'adresse renseignée.
+
+=== "identifiant de cloud fédéré"
+
+    Tout utilisateur de Nextcloud, que ce soit sur l'instance de GNOUS ou une autre, possède un «identifiant cloud fédéré» qui est unique.
+    Celui-ci permet de partager des ressources au sein d'un réseau décentralisé[^1] et ainsi collaborer avec des utilisateurs d'autres instances.
+
+    Ces utilisateurs recevront une notification et pourront accepter ou refuser le partage. Si celui-ci est accepté, il sera similaire à un partage utilisateur au sein de l'instance.
+
+    [^1]: Ce détail du cloud fédéré est en réalité un enjeu majeur de la réappropriation d'internet et de son maillage. Le logiciel Nextcloud fait ainsi partie du [Fediverse](https://fr.wikipedia.org/wiki/Fediverse), un ensemble de serveurs logiciels interconnectés capables de dialoguer entre eux et constituant un réseau social décentralisé libre de tout monopole. Chaque utilisateur peut ainsi décider quel serveur hébergera son compte selon ses propres critères géographiques, techniques, éthiques ou politiques.
+
+    ??? tip "Comment trouver mon identifiant de cloud fédéré ?"
+
+        Rends-toi dans les paramètres de ton compte, puis dans l'onglet `Partage`.
+
+## Comment travailler à plusieurs et en même temps sur un document ?
+
+GNOUS utilise la suite bureautique [OnlyOffice](https://www.onlyoffice.com/fr/) pour permettre à ses utilisateurs de collaborer en même temps sur différents types de documents (textes, tableurs, présentations, formulaires).
+
+1. Créer un nouveau document (ou importer un existant).
+2. Le partager avec d'autres utilisateurs ou générer un lien public (penser à donner la permission de modification).
+3. Cliquer sur le fichier pour commencer à le manipuler.
+
+!!! warning "Format propriétaire"
+
+    Par défaut OnlyOffice enregistre les documents au format propriétaire de la suite Microsoft :cold_sweat:. Il est cependant possible de les télécharger dans un format ouvert (`Fichier` > `Télécharger comme...`).
+
+!!! warning "Limite de connexions"
+
+    OnlyOffice implémente une limite logicielle dans sa version gratuite et limite à 20 le nombre de connexions simultanées au serveur OnlyOffice (au sens logiciel serveur, hébergé par GNOUS). C'est-à-dire que si 10 documents sont ouverts et manipulés par 2 utilisateurs, ou si un document est manipulé par 20 utilisateurs, alors personne d'autre ne pourra écrire dans le document (mais la lecture reste possible).
diff --git a/docs/nextcloud/partage.md b/docs/nextcloud/partage.md
deleted file mode 100644
index e69de29..0000000
diff --git a/mkdocs.yml b/mkdocs.yml
index 1071b16..bf03fa7 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -5,7 +5,7 @@ nav:
     - Mattermost: mattermost/index.md
     - Nextcloud:
         - Général: nextcloud/index.md
-        - Partager: nextcloud/partage.md
+        - Collaborer: nextcloud/collaborer.md
     - Mail:
         - Général: mail/index.md
         - "Portail d'administration": mail/admin.md