Différences

Ci-dessous, les différences entre deux révisions de la page.

--- doc:formations:hebergement:service:dokuwiki [2020/02/21 17:43] – [Autres plugins] jeremie
+++ doc:formations:hebergement:service:dokuwiki [2020/07/17 08:40] (Version actuelle) – [OAuth google] jeremie
@@ Ligne 1: / Ligne 1: @@
-[[doc:formations:hebergement:index|< Retour à l'index]]
+[[public:heberger_ses_services|< Retour à l'index]]
 ====== Dokuwiki ======
@@ Ligne 37: / Ligne 37: @@
 On recommande quand de mettre à jour régulièrement votre wiki, qui vous dira lorsqu'une nouvelle version est disponible.
-Pour se faire, il suffit de répéter l'opération d'installation, en écrasant le contenu de la nouvelle archive (''cp -a'' du contenu par dessus l'existant), c'est aussi simple que cela!
+Pour se faire, il suffit de répéter l'opération d'installation, en écrasant le contenu de la nouvelle archive (''cp -a'' du contenu par dessus l'existant, puis un éventuel ''chmod''), c'est aussi simple que cela!
 ===== Contenu =====
@@ Ligne 71: / Ligne 70: @@
 On installe un "greffon" (plugin) depuis la console d'administration web, qui figure en haut à droite de la page dokuwiki. Il faut bien sûr être soi-même dans le groupe ''admin'', tel qu'indiqué dans la gestion des utilisateurs.
-Allez dans le "Gestionnaire d'extensions": le plus simple reste de passer par l'onglet "Recherchjer et installer...", puis de saisir le nom du greffon intéressant.
+Allez dans le "Gestionnaire d'extensions": le plus simple reste de passer par l'onglet ''Rechercher et installer...'' puis de saisir le nom du greffon intéressant.
 Parmis les innombrables plugins (liste complète [[https://www.dokuwiki.org/plugins|sur le site officiel]]), quelques uns sont particulièrement utiles:
-=== Move ===
+==== Move ====
 Le greffon nommé [[https://www.dokuwiki.org/plugin:move|Move]] permet de renommer ou déplacer des pages ou des sections (une fois sur la page en question, cliquer "Administrer" et choisissez "Déplacer/Renommer pages et catégories...")
-=== SMTP ===
+==== SMTP ====
 Le greffon [[https://www.dokuwiki.org/plugin:smtp|SMTP]] va permettre d'envoyer des notifications par emails, tels que la création d'un compte, ou bien un changement sur une page, un abonnement, etc.
@@ Ligne 87: / Ligne 86: @@
 {{:doc:formations:hebergement:service:dokuwiki_smtp_plugin.png?400|}}
-=== Autres plugins ===
+==== Autres plugins ====
+Voilà quelques autres plugins intéressants:
+=== Edition ===
-Citons enfin quelques plugins moins classiques mais intéressants:
   * [[https://www.dokuwiki.org/plugin:prosemirror|prosemirror]] (par l'auteur de Dokuwiki) ou bien [[https://www.dokuwiki.org/plugin:ckgedit|ckgedit]] (plus efficace mais plus lent) permettent d'éditer interactivement en WYSIWYG (what you see is what you get), et éviter le markdown (c'est utile pour les clients!)
-  * [[https://www.dokuwiki.org/plugin:odt|odt]] pour exporter la page pour openoffice (insérez simplement ''~~ODT~~'' dans la page pour obtenir une icone clicable)
+  * [[https://www.dokuwiki.org/plugin:edittable|Edittable]] facilite grandement la création de tableaux
-  * [[https://www.dokuwiki.org/plugin:discussion|Discussion]] ou [[http://www.dokuwiki.org/plugin:comment]] permettent d'ajouter des fils de discussion ou commentaires à la suite d'une page wiki
-  * [[https://www.dokuwiki.org/plugin:ditaa|Ditaa]] pour générer des schémas en mode "ascii art"
-  * [[https://www.dokuwiki.org/plugin:plantuml|PlantUML]], un parser (écrire de l'UML) --> attention, ce service est fait par un tiers (pb. confidentialité possible)
-  * [[https://www.dokuwiki.org/plugin:edittable|Edittables]] Edition grandement facilitée pour les tableaux
   * [[https://www.dokuwiki.org/plugin:sortablejs|sortablejs]] permet de trier les tables par leur colonnes
-  * [[https://www.dokuwiki.org/plugin:latex|LaTeX]] qui permet d'écrire des formules mathématiques propres et/ou complexes (si l'on a installé l'outil sur le serveur)
-  * [[http://www.dokuwiki.org/plugin:addnewpage|addnewpage]] pour ajouter un bouton explicite de création de page (sinon il faut créer un lien ou taper une URL inconnus pour cela, c'est moins explicite)
+=== Export ===
-  * [[https://www.dokuwiki.org/plugin:authgoogle|authgoogle]] requiert un peu de configuration du coté de Google API pour permettre une authentification dans dokuwiki via un compte google
-  * [[http://www.dokuwiki.org/plugin:blog|blog]] ordonne les pages d'une section sous la forme d'un blog simple
+  * [[https://www.dokuwiki.org/plugin:odt|odt]] permet d'exporter la page pour openoffice (insérez simplement ''~~ODT~~'' dans la page pour obtenir une icone clicable). Une impression PDF de la page web peut suffir, mais qui est non éditable (PDF) et qui intègre des informations parfois polluante comme l'URL. A noter qu'un couper/coller vers/depuis ''cgedit'' marche particulièremet bien pour conserver le formattage du texte!
+=== "Syntaxes" additionnelles ===
+  * [[https://www.dokuwiki.org/plugin:ditaa|Ditaa]] pour générer des schémas en mode "ascii art"
+  * [[https://www.dokuwiki.org/plugin:plantuml|PlantUML]], un parser (écrire de l'UML). :!: ce service passe par un tiers (problème possible de confidentialité, le source est envoyé pour formatage)
+  * [[https://www.dokuwiki.org/plugin:latex|LaTeX]] qui permet d'écrire des formules mathématiques très proprement (si on a installé le gros, mais magnifique outil associé sur le serveur)
+=== Fonctionalités ===
+  * [[http://www.dokuwiki.org/plugin:addnewpage|addnewpage]] ajoute un bouton explicite de création de page (sinon il faut créer un lien ou taper une URL inconnus pour cela, c'est moins explicite)
+  * [[http://www.dokuwiki.org/plugin:nspages|nspages]] liste les pages d'un //namespace// (pratique pour constituer une table des matières rapidement)
+  * [[http://www.dokuwiki.org/plugin:blog|blog]] ordonne les pages d'un //namespace// sous la forme d'un blog simple
+  * [[https://www.dokuwiki.org/plugin:discussion|Discussion]] ou [[http://www.dokuwiki.org/plugin:comment|comment]] créent des fils de discussion ou permettent les commentaires dans une page wiki
+  * [[https://www.dokuwiki.org/plugin:authgoogle|authgoogle]] requiert un peu de configuration du coté de Google API pour permettre une authentification OAuth dans dokuwiki via un compte google {{:doc:formations:hebergement:service:google-oauth-for-dokuwiki-and-mattermost2.png?40|}}{{:doc:formations:hebergement:service:google-oauth-for-dokuwiki-and-mattermost.png?40|}}
+=== Esthétique ===
+Exemple de thèmes modernes, "responsive" et probablement plus jolis que celui par défaut très "old school":
+  * [[https://www.dokuwiki.org/template:bootstrap3|Bootstrap3]]
+  * [[https://www.dokuwiki.org/template:sprintdoc|sprintDoc]]
+=== OAuth google ===
+Il est possible de s'identifier sur Dokuwiki via son compte Google. Il faut pour cela avoir créée une autorisation préalable pour Dokuwiki chez Google. Ci-dessous les deux écrans pour le wiki.kideba.com:
+{{:doc:formations:hebergement:service:google-oauth-for-dokuwiki-1-client-id.png?200|}} {{:doc:formations:hebergement:service:google-oauth-for-dokuwiki-2-consent.png?200|}}