Différences

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

--- informatique:dokuwiki [2020/12/07 09:13] – [Ajouter des icônes] alexis
+++ informatique:dokuwiki [2024/03/24 18:42] (Version actuelle) – [Extensions] alexis
@@ Ligne 3: / Ligne 3: @@
 <WRAP alert>
 À suivre pour la correction de bugs :
-  - [[https://github.com/Aorimn/dokuwiki-tokenbucketauth/issues/10|Add hogfather support · Issue #10 · Aorimn/dokuwiki-tokenbucketauth]]
+  - [[https://github.com/splitbrain/dokuwiki-plugin-gallery/issues/149|Remove extension limitation · Issue #149 · splitbrain/dokuwiki-plugin-gallery]]
-  - [[https://forum.dokuwiki.org/d/17905-cant-access-tools-menu-after-update/10|Can't access "tools menu" after update - DokuWiki User Forum]]
+</WRAP>
-  - [[https://forum.dokuwiki.org/d/17855-impossible-to-use-my-wiki-after-the-update/8|Impossible to use my wiki after the update - DokuWiki User Forum]]
+<WRAP todo>
+  - [[https://www.dokuwiki.org/plugin:pagelist|plugin:pagelist [DokuWiki]]]
+  - [[https://www.dokuwiki.org/plugin:tag#sites_using_this_plugin|plugin:tag [DokuWiki]]]
+  - [[https://www.dokuwiki.org/tips:topbar|tips:topbar [DokuWiki]]]
 </WRAP>
 ===== Extensions =====
-  * [[https://www.dokuwiki.org/plugin:drawio|drawio]] permet d'éditer des schémas réalisés avec draw.io directement depuis le wiki.
+  * [[https://www.dokuwiki.org/plugin:drawio|drawio]] permet d'éditer des schémas réalisés avec draw.io directement depuis le wiki ((Attention aux règles CSP relatives à l'inclusion des ''iframes'' et à l'utilisation des ''workers'')).
+  * [[https://www.dokuwiki.org/plugin:dwtimeline|dwtimeline]] permet d'inclure une ligne du temps pour positionner des évènements.
   * [[https://www.dokuwiki.org/plugin:edittable|EditTable]] ajoute un bouton d'édition sous chaque tableau. Le bouton d'édition permet la modification du tableau à la manière de Excel.
-  * [[https://www.dokuwiki.org/plugin:fontsize2|fontsize2]] permet de gérer la taille de la police.
+  * <del>[[https://www.dokuwiki.org/plugin:fontsize2|fontsize2]] permet de gérer la taille de la police.</del> Remplacé par l'extension ''typography'' qui supporte plus de modifications ((J'ai même l'impression que c'est un sous-ensemble de celle-ci.)).
+  * [[https://www.dokuwiki.org/plugin:gallery|gallery]] permet d'inclure une galerie d'images.
   * [[https://www.dokuwiki.org/plugin:keyboard|keyboard]] permet d'afficher des raccourcis clavier sous forme de touche de clavier.
+  * [[https://www.dokuwiki.org/plugin:include|include]] permet d'inclure des pages du wiki dans d'autres.
   * [[https://www.dokuwiki.org/plugin:loglog|Login/Logoff Logging]] permet d'enregistrer les connexions et déconnexions dans un journal.
   * [[https://www.dokuwiki.org/plugin:move|Move]] permet de déplacer des pages en conservant les liens (([[https://www.dokuwiki.org/faq:howto-rename-pages|HOWTO: Rename Pages]])).
+  * [[https://www.dokuwiki.org/plugin:pdfjs|pdfjs]] permet d'afficher le contenu de fichiers PDF dans le wiki ((Attention aux règles CSP relatives à l'inclusion des ''iframes'')).
   * [[https://www.dokuwiki.org/plugin:tabbox|tabbox]] permet de créer des boîtes avec onglets.
-  * [[https://www.dokuwiki.org/plugin:tokenbucketauth|tokenbucketauth]] ((Ne fonctionne plus à partir de la version //Hogfather//, j'ai ouvert un [[https://github.com/Aorimn/dokuwiki-tokenbucketauth/issues/10|ticket]] sur le dépôt.)) permet de ralentir les attaques en force brute en bannissant les IPs coupables.
+  * [[https://www.dokuwiki.org/plugin:tokenbucketauth|tokenbucketauth]] permet de ralentir les attaques en force brute en bannissant les IPs coupables.
+  * [[https://www.dokuwiki.org/plugin:typography|typography]] permet de modifier la typographie localement.
   * [[https://www.dokuwiki.org/plugin:upgrade|upgrade]] permet de mettre à jour le wiki directement depuis l'interface d'administration.
   * [[https://www.dokuwiki.org/plugin:wrap|Wrap]] permet de mettre le texte dans des containers. Ces containers peuvent être stylés avec les styles fournis ou ceux de l'utilisateur.
 ===== Syntaxe =====
-  * Pour ne pas afficher la table des matières d'une page, il faut ajouter ''%%~~NOTOC~~%%'' dans celle-ci.
+Voir [[informatique:ecriture#dokuwiki|Écriture]]
-  * Pour mettre du texte en indice, il faut utiliser ''%%<sub>texte</sub>%%'' → //H<sub>2</sub>O//.
-  * Pour mettre du texte en exposant, il faut utiliser ''%%<sup>texte</sup>%%'' → //x<sup>2</sup> + y<sup>2</sup> = 1//.
-  * Pour barrer du texte, il faut utiliser ''%%<del>texte</del>%%'' → <del>barré</del>
-  * Pour plus d'[[wiki:syntax|informations]].
-**Mettre en forme un bloc de code**
-Source
-<file dokuwiki>
-<code csharp [enable_line_numbers="true",highlight_lines_extra="3"]>
-private void ShowMessage()
-{
-    MessageBox.Show("Hello!");
-}
-</code>
-</file>
-Résultat
-<code csharp [enable_line_numbers="true",highlight_lines_extra="3"]>
-private void ShowMessage()
-{
-    MessageBox.Show("Hello!");
-}
-</code>
 ===== Configuration =====
 ==== Changer la largeur d'affichage ====
 Il faut éditer le fichier ''lib/tpl/dokuwiki/style.ini'' et modifier la valeur du paramètre ''%%__site_width__%%''. Dans mon cas, j'ai remplacé ''75em'' par ''100vw''.
+<WRAP important>
+Il faut réaliser cette opération à chaque mise à jour du wiki !
+</WRAP>
 ==== Autoriser l'ajout de fichier SVG par le gestionnaire de médias ====
 Il faut ajouter le fichier ''conf/mime.local.conf'' avec le contenu suivant :
+<WRAP prewrap>
 <code - mime.local.conf>
+mp4    video/mp4
 svg    image/svg+xml
 </code>
+</WRAP>
 <WRAP info>
 Il est possible de mettre cette configuration dans le fichier ''conf/mime.conf'' mais celle-ci ne sera pas conservée lors de la prochaine mise à jour.
@@ Ligne 62: / Ligne 54: @@
 ==== Ajouter des icônes ====
 Il faut ajouter le fichier ''conf/smileys.local.conf'' avec le contenu suivant :
-FIXME
+<WRAP prewrap>
 <code - smileys.local.conf>
 # PlayStation 1
-PS1_SQUARE   playstation1square.svg
+PS_CIRCLE   playstation.circle.svg
-PS1_TRIANGLE playstation1triangle.svg
+PS_CROSS    playstation.cross.svg
-PS1_CIRCLE   playstation1circle.svg
+PS_SQUARE   playstation.square.svg
-PS1_CROSS    playstation1cross.svg
+PS_TRIANGLE playstation.triangle.svg
-PS1_LEFT     fixme.gif
+PS_DOWN     playstation.down.svg
-PS1_RIGHT    fixme.gif
+PS_LEFT     playstation.left.svg
-PS1_UP       fixme.gif
+PS_RIGHT    playstation.right.svg
-PS1_DOWN     fixme.gif
+PS_UP       playstation.up.svg
-PS1_L1       fixme.gif
+PS_L1       playstation.l1.svg
-PS1_L2       fixme.gif
+PS_L2       playstation.l2.svg
-PS1_R1       fixme.gif
+PS_R1       playstation.r1.svg
-PS1_R2       fixme.gif
+PS_R2       playstation.r2.svg
-PS1_SELECT   fixme.gif
+PS_SELECT   playstation.select.svg
+# Nintendo 64
+N64_CDOWN    nintendo64.c.down.svg
+N64_CLEFT    nintendo64.c.left.svg
+N64_CRIGHT   nintendo64.c.right.svg
+N64_CUP      nintendo64.c.up.svg
+N64_DDOWN    nintendo64.d.down.svg
+N64_DLEFT    nintendo64.d.left.svg
+N64_DRIGHT   nintendo64.d.right.svg
+N64_DUP      nintendo64.d.up.svg
+N64_L        nintendo64.l.svg
+N64_R        nintendo64.r.svg
 </code>
+</WRAP>
 <WRAP info>
 Il est possible de mettre cette configuration dans le fichier ''conf/smileys.conf'' mais celle-ci ne sera pas conservée lors de la prochaine mise à jour.
 </WRAP>
 Il faut également mettre à disposition les icônes dans le répertoire ''lib/images/smileys''.
+Voici les icônes utilisées :
+  * Playstation : PS_CIRCLE PS_CROSS PS_SQUARE PS_TRIANGLE PS_DOWN PS_LEFT PS_RIGHT PS_UP PS_L1 PS_L2 PS_R1 PS_R2 PS_SELECT
+  * Nintendo 64 : N64_CDOWN N64_CLEFT N64_CRIGHT N64_CUP N64_DDOWN N64_DLEFT N64_DRIGHT N64_DUP N64_L N64_R
+Comme certaines icônes utilisées sont très grandes, il faut les redimensionner lors de l'utilisation en modifiant le contenu du fichier ''conf/userall.css'' avec les règles suivantes :
+<WRAP prewrap>
+<code css conf/userall.css>
+.icon[alt*="PS_"],
+.icon[alt*="N64_"],
+button.pickerbutton[title*="PS_"] img,
+button.pickerbutton[title*="N64_"] img {
+  height: 1em;
+}
+</code>
+</WRAP>
+==== Ajouter des polices ====
+Il faut créer le répertoire ''fonts'' à la racine du wiki et y ajouter les polices nécessaires ((Celles-ci sont également présentes dans le gestionnaire de médias)).
+Il faut ensuite les charger en modifiant le contenu du fichier ''conf/userall.css'' avec les règles suivantes :
+<WRAP prewrap>
+<code css conf/userall.css>
+@font-face {
+  font-family: "Ænigma Scrawl 4 BRK";
+  src: url(fonts/aenigmascrawl.ttf) format("truetype");
+}
+@font-face {
+  font-family: "Fira Code";
+  src: url(fonts/firacoderegular.ttf) format("truetype");
+}
+@font-face {
+  font-family: "Grudge 2 BRK";
+  src: url(fonts/grudge2brk.ttf) format("truetype");
+}
+@font-face {
+  font-family: "Intel One Mono";
+  src: url(fonts/intelonemonoregular.ttf) format("truetype");
+}
+@font-face {
+  font-family: "Iosevka";
+  src: url(fonts/iosevkaregular.ttf) format("truetype");
+}
+@font-face {
+  font-family: "JetBrains Mono";
+  src: url(fonts/jetbrainsmonoregular.ttf) format("truetype");
+}
+@font-face {
+  font-family: "Old Newspaper Types";
+  src: url(fonts/oldnewspapertypes.ttf) format("truetype");
+}
+@font-face {
+  font-family: "PT Sans";
+  src: url(fonts/ptsanswebregular.ttf) format("truetype");
+}
+@font-face {
+  font-family: "PT Serif";
+  src: url(fonts/ptserifwebregular.ttf) format("truetype");
+}
+@font-face {
+  font-family: "Sketch Nothing";
+  src: url(fonts/sketchnothing.ttf) format("truetype");
+}
+</code>
+</WRAP>