un outil d'édition de la doc ubuntu-fr pratique?

Nuliel · Le 12/08/2023, à 20:19

Bonjour,
Je souhaiterais faire un grand ménage sur la page sécurité, mais je trouve pas très pratique la page d'édition pour de gros changements.
Y a t'il des outils, des extensions vscode, ou des astuces pour rendre l'édition plus facile? Si vous connaissez un outil qui permet d'avoir une preview en temps réel ce serait incroyable
Merci d'avance,
Nuliel

Compte supprimé · Le 12/08/2023, à 21:00

J'imagine qu'il ne faut pas compter sur l'installation de l'un des plugins existants

Peut-être en important dans un format comme markdown puis exporter en dokuwiki. Faut voir si ça existe.
https://www.dokuwiki.org/export

Please be sure the export action is not disabled

Et peut-être cela pour importer
https://forum.dokuwiki.org/d/18840-plug … hier-odt/2

Dernière modification par Compte supprimé (Le 12/08/2023, à 21:13)

Nuliel · Le 12/08/2023, à 21:17

Pour les plugins dokuwiki, je confirme, en plus j'ai l'impression que les plugins intéressants sont tous périmés
Je ne savais pas qu'on pouvait exporter, mais avec ta commande ça sort du html (et ça télécharge beaucoup de trucs), donc pas du markdown
Par contre ton idée d'export/conversion est une bonne idée, ça me fait penser à pandoc et effectivement il sait convertir du dokuwiki vers markdown! Et ça tombe bien vu que vscode sait faire des preview de fichiers markdown!
Je vais donc tenter l'approche dokuwiki -> markdown -> édition du markdown -> conversion en dokuwiki
Merci!

Edit: l'astuce de pandoc ne marche pas sur la 20.04 (ou alors il faut télécharger une version de pandoc plus récente)
Et la commande magique:

../pandoc-3.1.6.1/bin/pandoc -f dokuwiki -t markdown securite.dokuwiki -o securite.md

Bon l'export de pandoc est pas fou, pas mal de trucs à corriger.

Dernière modification par Nuliel (Le 12/08/2023, à 22:11)

Nuliel · Le 13/08/2023, à 18:29

J'ai un rêve: que la doc soit en markdown (la conversion est quand même crade!)

krodelabestiole · Le 19/09/2023, à 13:12

oui, dokuwiki c'est un peu vieillissant on va dire...

idéalement il faudrait trouver une alternative moderne basée sur markdown (et en jamstack de préférence) et voir comment se passerait une migration...

Compte supprimé · Le 19/09/2023, à 19:37

Ti aimes rire ! Tu parles de migrer la doc qui n'est pas prête, alors que le forum qui est prêt attend la sienne depuis quelques années.

krodelabestiole · Le 19/09/2023, à 20:33

la doc aussi : https://ufr-doc.crachecode.net

mais à l'occase, plus tard, oui ce serait une idée...

Compte supprimé · Le 19/09/2023, à 21:39

Effectivement, on en a parlé à l'époque .

krodelabestiole · Le 29/01/2024, à 20:11

comme on en parle sur mattermost en ce moment, je viens de jeter un œil aux solutions.
on trouve quand-même des convertisseurs markdown - dokuwiki.

des services en ligne ici (open souce et auto hébergeable) et là (pareil je crois et utilisable en ligne de commande !).

et aussi Pandoc :

Added dokuwiki as an output format

(https://pandoc.org/releases.html#pandoc … ugust-2014)

il y a de quoi faire, ça reste quand même moins pratique que d'avoir directement un bon éditeur sur le wiki.

aussi une extension pas forcément super populaire ou maintenue que je pourrais tester de mon côté mais je pense que ça risque de mettre un sacré bazar https://www.dokuwiki.org/plugin:markdowku

krodelabestiole · Le 29/01/2024, à 21:15

je ne trouve pour le moment pas d'éditeur moderne qui exporte au format dokuwiki, dommage c'est pourtant implémenté par pandoc, qui est utilisé par plein d'applications.

- dont apostrophe qui permet d'exporter en mediawiki, mais pas dokuwiki ;/ (super éditeur en tout cas !) // edit : petite feat request
- j'ai essayé de lancer panwriter en snap sans succès... si quelqu'un y arrive et peut regarder si on peut exporter en dokuwiki ?
- ghostwriter qui propose plein de module d'export différents (donc plusieurs pandoc) mais je ne vois pas de dokuwiki...

Dernière modification par krodelabestiole (Le 29/01/2024, à 22:02)

krodelabestiole · Le 29/01/2024, à 21:30

en tout cas pandoc en ligne de commande marche super !

pour convertir un fichier markdown en txt au format dokuwiki :

pandoc -t dokuwiki -o sortie.doku.txt entrée.md

krodelabestiole · Le 09/02/2026, à 04:14

krodelabestiole a écrit :

- dont apostrophe qui permet d'exporter en mediawiki, mais pas dokuwiki ;/ (super éditeur en tout cas !) // edit : petite feat request

en retombant sur ce sujet je vois que ma requête a été acceptée (zéro pour le suivi, moi ) !
https://gitlab.gnome.org/World/apostrop … quests/283
je teste ça demain.

Amiralgaby · Le 09/02/2026, à 22:11

Pas essayé mais super nouvelle,

c'est vrai que c'est pas pratique, la coloration syntaxique ou un bon correcteur d'orthographe en éditant serait sympa.

Voir une version What you see is what you get (comme un wordpress) ça serait le feu

Toujours aussi bien de le thème de l'interface de ufr-doc.crachecode.net, beau travail

Amiralgaby · Le 02/03/2026, à 14:56

Bonjour,

Est-ce que la refonte du site (qui est prévue) permettra d'éditer la documentation d'une autre manière que par le code dokuwiki non coloré qui est actuellement présent ?

Par exemple avec des blocs à glisser-déposer à la Wordpress.

krodelabestiole · Le 02/03/2026, à 15:17

non, on n'a pas prévu de quitter dokuwiki (hors mise à jour ordinaire). par contre la table des matières ne viendra plus déplacer le formulaire intempestivement.

un wiki n'offre pas exactement les même fonctionnalités et ne vise pas les mêmes utilisateurs qu'un CMS, pas sûr qu'un système de bloc serait très approprié.
il y aurait éventuellement docusaurus pour de la doc, mais je ne suis pas sûr qu'il convienne à une approche "wiki" (édition communautaire). ou outline.

ou Wiki.js qui à première vue a l'air plus moderne que dokuwiki ou mediawiki.

Amiralgaby · Le 08/03/2026, à 14:19

Bonjour,

Oui en effet, je n'avais pas même l'idée que la documentation change d'outil d'édition.

Tu as quand même répond en disant qu'il n'y aura que les mises à jour ordinaire

Vu qu'il n'y a pas foule et que dokuwiki fonctionne, pourquoi changer quelque chose qui fonctionne

krodelabestiole · Le 23/07/2026, à 21:55

coucou !

la dernière version de dokuwiki propose l'édition markdown.
https://www.dokuwiki.org/changes
dans tous les cas j'attends quelques jours avant de mettre à jour (un hotfix est déjà sorti).

après il faudra voir si on choisit d'en profiter ou pas. Les options de configuration sont les suivantes :

dw DokuWiki syntax only (default, unchanged behaviour)
md Markdown (GFM) only
dw+md Both enabled, DokuWiki syntax preferred on conflicts
md+dw Both enabled, Markdown preferred on conflicts

https://www.dokuwiki.org/markdown

vu que l'essentiel de la doc est en syntaxe dokuwiki, à moins que quelqu'un se sente d'attaque pour réécrire toute la doc en markdown, ou corriger les conflits avec md+dw (mais ça m'étonnerait), je dirais qu'on a le choix entre
dw+md (markdown avec priorité dokuwiki) et dw (sans markdown)

vu la simplicité du markdown comparé à dokuwki, je pense que ça mérite d'essayer dw+md ?

le mieux serait qu'un script existe qui convertisse proprement le dokuwiki en markdown, qu'on puisse se débarrasser complètement de cette syntaxe... (je n'ai pas cherché)

Nuliel · Le 23/07/2026, à 22:35

C'est une excellente nouvelle qu'un moteur aussi connu gère enfin le markdown! La plupart des moteurs de wiki utilisent leur propre syntaxe custom, et je trouve ça dommage.
Oui, activer le support markdown ce serait top! Et du GFM en plus! (github flavored markdown = un markdown étendu)
L'un des avantages, c'est qu'on peut facilement avoir un rendu en direct (avec vscode par exemple), ce qui n'était pas le cas avec dokuwiki.
Pour la conversion, pandoc peut convertir, mais peut-être pas parfaitement. Je vais voir ce que ça donne sur une page un peu complexe

Edit: la conversion avec pandoc est pas folle

Dernière modification par Nuliel (Le 23/07/2026, à 22:48)

geole · Le 23/07/2026, à 22:39

Bonsoir.
Deux simples remarques
Le nouveau serveur de documentation semble toujours opérationnel contrairement au précédant.
La codification n’est pas totalement identique, il suffit souvent d’ajouter des retours â la ligne pour réobtenir une présentation parfaite. ( Première ligne de ma signature). Ce qui est facile à faire. Il suffit d’y penser et cela prend peu de temps pour le faire..

Dernière modification par geole (Le 23/07/2026, à 22:52)

krodelabestiole · Le 23/07/2026, à 22:57

ok ! je ne suis pas dispo ce week-end, je mettrai à jour la semaine prochaine avec dw+md, on verra déjà ce que ça donne !

krodelabestiole · Le 23/07/2026, à 23:06

@Geole, je ne sais pas exactement de quoi tu parles concernant les retours à la ligne.

je ne sais pas si cette page s'affichait correctement sur l'ancienne version par ex. : https://doc.ubuntu-fr.org/tutoriel/inst … 1776810709
mais si c'était le cas, c'était "anormal" : les images étant inclues dans le texte, elles s'affichent sur la même ligne que le texte, comme n'importe quel caractère (ça permet d'ailleurs de coller de petites images dans le texte, au milieu d'une phrase, comme des smileys). Mais pour des images aussi grandes ça fait donc des lignes de textes de la hauteurs des images, et des images distribuées n'importe où horizontalement selon là où on les met dans le texte. En l'occurrence l'affichage est visiblement cassé, mais c'est ce qui est attendu du format HTML.

Ubuntu-fr

Navigation

Liens de recherche

Annonce

#1 Le 12/08/2023, à 20:19

un outil d'édition de la doc ubuntu-fr pratique?

#2 Le 12/08/2023, à 21:00

Re : un outil d'édition de la doc ubuntu-fr pratique?

#3 Le 12/08/2023, à 21:17

Re : un outil d'édition de la doc ubuntu-fr pratique?

#4 Le 13/08/2023, à 18:29

Re : un outil d'édition de la doc ubuntu-fr pratique?

#5 Le 19/09/2023, à 13:12

Re : un outil d'édition de la doc ubuntu-fr pratique?

#6 Le 19/09/2023, à 19:37

Re : un outil d'édition de la doc ubuntu-fr pratique?

#7 Le 19/09/2023, à 20:33

Re : un outil d'édition de la doc ubuntu-fr pratique?

#8 Le 19/09/2023, à 21:39

Re : un outil d'édition de la doc ubuntu-fr pratique?

#9 Le 29/01/2024, à 20:11

Re : un outil d'édition de la doc ubuntu-fr pratique?

#10 Le 29/01/2024, à 21:15

Re : un outil d'édition de la doc ubuntu-fr pratique?

#11 Le 29/01/2024, à 21:30

Re : un outil d'édition de la doc ubuntu-fr pratique?

#12 Le 09/02/2026, à 04:14

Re : un outil d'édition de la doc ubuntu-fr pratique?

#13 Le 09/02/2026, à 22:11

Re : un outil d'édition de la doc ubuntu-fr pratique?

#14 Le 02/03/2026, à 14:56

Re : un outil d'édition de la doc ubuntu-fr pratique?

#15 Le 02/03/2026, à 15:17

Re : un outil d'édition de la doc ubuntu-fr pratique?

#16 Le 08/03/2026, à 14:19

Re : un outil d'édition de la doc ubuntu-fr pratique?

#17 Le 23/07/2026, à 21:55

Re : un outil d'édition de la doc ubuntu-fr pratique?

#18 Le 23/07/2026, à 22:35

Re : un outil d'édition de la doc ubuntu-fr pratique?

#19 Le 23/07/2026, à 22:39

Re : un outil d'édition de la doc ubuntu-fr pratique?

#20 Le 23/07/2026, à 22:57

Re : un outil d'édition de la doc ubuntu-fr pratique?

#21 Le 23/07/2026, à 23:06

Re : un outil d'édition de la doc ubuntu-fr pratique?

Pied de page des forums