Markdown

C'est le format retenu par framavox pour formater les textes de contexte et les commentaires.
Aujourd'hui, ils n'ont pas intégré d'éditeur graphique pour faciliter le travail, probablement parce que seules quelques fonctionnalités de markdown ont été implémentées dans le rendu.
Donc soit vous apprenez la partie de markdown qu'ils ont exploité (et c'est rapide) car ils ont fait titre1, titre2, titre 3, gras et italique. Plus les insertions de liens et d'images.
Soit vous maintenez votre document dans un traitement de texte et vous le convertissez.
Si vous utilisez un traitement de texte, utilisez le minimum syndical, donc les mêmes choses qu'eux : gras, italique, et les titres 1 à 3.
Si vous changez des tailles de polices au lieu d'utiliser les titres, tout sera perdu à la conversion.

Pandoc

L’utilitaire couteau suisse des conversions est
pandoc.

Vous pouvez le télécharger et l’utiliser pour convertir vos documents
word ou openoffice en markdown qui est ensuite utilisable comme
« contexte » au sens framavox du terme.

Les images

Ajouter des images n’est pas simple.

Les images doivent au préalable être chargée dans votre fil de
discussion comme attachement.

Elles apparaîtront automatiquement en bas de votre document, mais vous
pouvez les placer également dans le corp du document en les insérant
sous forme d’image avec source dans le web.

Je vous conseille de les intégrer « ancrés comme caractère ».

Une fois votre document converti, la référence à l’image ne sera pas
correcte, il faut encore directement dans le markdown substituer
l’adresse de l’image locale à votre document par celle stockée comme
pièce jointe dans framavox. Son adresse est récupérable en cliquant sur
l’image avec le bouton droit et « copier l’adresse de l’image ».

Exemple :

Lorsque je convertis ce document en markdown la référence de l’image est
indiquée ainsi :

{width="3.103cm"

height="4.135cm"}

J’ai déjà attaché cette image à mon document sur framavox, je récupère
donc son adresse par un clic droit dessus et « copier l’adresse de
l’image » :

Puis je change le contenu markdown qui traite de l’image.


Vous notez deux autres changements, j’ai ajouté le texte sphere entre
les crochet pour que les non voyants aient une descriptions lorsqu’ils
surfent. Et j’ai retiré les indications de taille que framavox ne sait
pas gérer.

Les tableaux

Je n’ai pas réussi à faire fonctionner la vue tableau dans framavox.
Aucun des différents formats markdown possibles n’ont été tolérés.

et la conversion alors ?

Pour convertir, téléchargez la dernière version de pandoc depuis le site. Amis linuxiens celle de votre distribution peut être trop ancienne pour bien gérer les conversions odt.
C'est un outil en ligne de commande, pas la panacée pour tout le monde mais ça marche.
Pour un document odt la commande sera :

pandoc --from=odt test_md.odt --to markdown -o test_md.markdown

le résultat est un fichier texte que vous pouvez copier coller dans votre thread.

Si vous utilisez word la syntaxe est presque la même

pandoc --from=docx test_md.docx --to markdown -o test_md.markdown