Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
informatique:dokuwiki [2021/02/01 13:05] – [Extensions] 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://forum.dokuwiki.org/d/17905-cant-access-tools-menu-after-update/10|Can't access "tools menu" after update - DokuWiki User Forum]] | |
- [[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]] | |
- [[https://github.com/splitbrain/dokuwiki-plugin-gallery/issues/149|Remove extension limitation · Issue #149 · splitbrain/dokuwiki-plugin-gallery]] | - [[https://github.com/splitbrain/dokuwiki-plugin-gallery/issues/149|Remove extension limitation · Issue #149 · splitbrain/dokuwiki-plugin-gallery]] |
| </WRAP> |
| <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. | * [[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. |
* <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.)). | * <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: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: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: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. |
| |
===== 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. |
Il faut ajouter le fichier ''conf/smileys.local.conf'' avec le contenu suivant : | Il faut ajouter le fichier ''conf/smileys.local.conf'' avec le contenu suivant : |
| |
| <WRAP prewrap> |
<code - smileys.local.conf> | <code - smileys.local.conf> |
# PlayStation 1 | # PlayStation 1 |
N64_R nintendo64.r.svg | N64_R nintendo64.r.svg |
</code> | </code> |
| </WRAP> |
| |
<WRAP info> | <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. | 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. |
| |
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 : | 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> | <code css conf/userall.css> |
.icon[alt*="PS_"], | .icon[alt*="PS_"], |
} | } |
</code> | </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> |
| |