Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
informatique:dokuwiki [2020/07/30 10:18] – alexis | informatique:dokuwiki [2024/03/24 18:42] (Version actuelle) – [Extensions] alexis |
---|
<WRAP alert> | <WRAP alert> |
À suivre pour la correction de bugs : | À 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> | </WRAP> |
| |
===== Extensions ===== | ===== Extensions ===== |
| * [[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: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: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: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: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: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: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]] 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: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. | * [[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 ===== | ===== 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 ===== | ===== Configuration ===== |
| |
==== Changer la largeur d'affichage ==== | ==== 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''. | 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 ==== | ==== 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 : | Il faut ajouter le fichier ''conf/mime.local.conf'' avec le contenu suivant : |
| <WRAP prewrap> |
<code - mime.local.conf> | <code - mime.local.conf> |
| mp4 video/mp4 |
svg image/svg+xml | svg image/svg+xml |
</code> | </code> |
| </WRAP> |
| |
<WRAP info> | <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. | 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. |
</WRAP> | </WRAP> |
| |
| ==== Ajouter des icônes ==== |
| Il faut ajouter le fichier ''conf/smileys.local.conf'' avec le contenu suivant : |
| |
| <WRAP prewrap> |
| <code - smileys.local.conf> |
| # PlayStation 1 |
| PS_CIRCLE playstation.circle.svg |
| PS_CROSS playstation.cross.svg |
| PS_SQUARE playstation.square.svg |
| PS_TRIANGLE playstation.triangle.svg |
| PS_DOWN playstation.down.svg |
| PS_LEFT playstation.left.svg |
| PS_RIGHT playstation.right.svg |
| PS_UP playstation.up.svg |
| PS_L1 playstation.l1.svg |
| PS_L2 playstation.l2.svg |
| PS_R1 playstation.r1.svg |
| PS_R2 playstation.r2.svg |
| 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> |
| |