Différences

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

--- doc:formations:hebergement:service:dokuwiki [2020/02/06 19:56] – [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 29: / Ligne 29: @@
 Une fois copié, aller sur la page web ''wk/install.php'' de votre site pour finaliser l'installation.
 La documentation recommande de détruire le fichier install.php ensuite.
+:!: Si vous avez un ''403 Forbidden'', vérifier que la ligne ''location ~ /(conf/|bin/|inc/|install.php) { deny all; }'' n'est pas activée dans la configuration du serveur web (cf. [[https://www.dokuwiki.org/install:nginx#dokuwiki_with_nginx_on_ubuntu|configuration nginx]]).
 __note__: si besoin, la configuration peut aussi être réglée directement dans le fichier ''conf/dokuwiki.php''. C'est utile par exemple pour faire pointer le ''$conf['savedir']=%%"%%./data%%"%%'' vers ''/home/dokuwiki_data'' par exemple, ce qui le met dans une zone habituellement sauvegardée et éloignée de www-data (sécurisation).
@@ Ligne 35: / 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 69: / 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 85: / Ligne 86: @@
 {{:doc:formations:hebergement:service:dokuwiki_smtp_plugin.png?400|}}
-=== Autres plugins ===
+==== Autres plugins ====
+Voilà quelques autres plugins intéressants:
+=== Edition ===
+  * [[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:edittable|Edittable]] facilite grandement la création de tableaux
+  * [[https://www.dokuwiki.org/plugin:sortablejs|sortablejs]] permet de trier les tables par leur colonnes
+=== Export ===
+  * [[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 ===
-Citons enfin quelques plugins moins classiques mais intéressants:
-  * [[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:discussion|Discussion]] permet d'ajouter un fil de discussion à 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: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:prosemirror|prosemirror]] permet d'éditer en WYSIWYG, et éviter le markdown (c'est utile pour les clients!)
+  * [[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)
-  * [[https://www.dokuwiki.org/plugin:edittable|Edittables]] Edition grandement facilitée pour les tableaux
-  * [[https://www.dokuwiki.org/plugin:sortablejs|sortablejs]] (afin de pouvoir trier les tables par leur colonnes)
+=== Fonctionalités ===
-  * [[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]] 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|}}