Outils de documentation

Asciinema permet d'enregistrer des sessions de terminal, de les envoyer automatiquement en ligne, de les enregistrer localement ou de les rejouer dans une page web avec un lecteur approprié :

• https://asciinema.org/
• https://github.com/asciinema/asciinema-player

Sur linux, il est installable depuis les dépôts sudo apt install asciinema

Objectif : créer un fichier pdf avec des liens cliquables à partir de la liste de liens sous forme de fichier texte.

• installer linkificator pour firefox ( https://addons.mozilla.org/fr/firefox/addon/linkificator/ )
• ouvrir le fichier texte dans firefox
• “imprimer” dans un fichier pdf

Voir SimpleScreenRecorder

Animation à partir de dessins vectoriels au format svg, exportables sous forme de suite d'image, par exemple pour être assemblées en vidéo ou en gif.

https://github.com/gweltou/SgAnimator

Adapté aux animations mathématiques. Les animations sont créées par des scripts python et exportées en vidéo mp4

• exemples : https://docs.manim.community/en/stable/examples.html
• https://github.com/ManimCommunity/manim/

voir aussi Data, analyse et visualisation

Carnet de notes permettant d'inclure différents types de cellules (calcul, visualisation) : https://observablehq.com/

Application en ligne avec de nombreux types de visualisation : https://app.rawgraphs.io/

voir aussi cartographie avec python

Outils basé sur openstreetmap pour créer des cartes interactives (avec marqueurs, polygones, bulles au contenu multimedia, fonds de carte personnalisables, etc.)
Les cartes peuvent être intégrées à une page web ou sont directement accessibles par une URL.

https://umap.openstreetmap.fr/fr/

Bibliothèque javascript, à réserver aux codeu/r/se/s

https://leafletjs.com/

Plusieurs possibilités, et il y en a sûrement d'autres…

• flatdoc (markdown, multi-colonnes, transformation du md à la volée par javascript)
  • https://github.com/rstacruz/flatdoc
  • https://ricostacruz.com/flatdoc/
  • https://tommcfarlin.com/documentation-with-markdown/
• SGDoc markdown → HTML, une fois pour toutes : https://github.com/saturngod/SGDoc
• daux PHP sur serveur, depuis CommonMark, une variante de markdown
  • https://github.com/dauxio/daux.io
  • http://daux.io/Getting_Started.html
• Jekyll + just the docs : https://github.com/just-the-docs/just-the-docs

Il existe aussi des thèmes intégrables dans des CMS :

• pour Grav : https://github.com/getgrav/grav-theme-learn2

Une page ressource très complète sur dokuwiki : https://dvillers.umons.ac.be/wiki/floss:dokuwiki

Des ressources : https://dvillers.umons.ac.be/wiki/floss:latex

Des éditeurs en ligne («in browser») :

• https://stackedit.io
• https://dillinger.io/
• https://pandao.github.io/editor.md/en.html

Avec Atom et le plugin markdown preview : https://atom.io/packages/markdown-preview
Cheat sheets :

• https://www.markdownguide.org/cheat-sheet/
• https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet

Passer de dokuwiki à markdown à mediawiki à pdf, etc.
→ avec Pandoc, installable ou en ligne : https://pandoc.org/try/

Produire un pdf avec coloration syntaxique, en ligne : https://extensions.libreoffice.org/en/extensions/show/code-highlighter

Il existe aussi une extension pour libreoffice : https://nsspot.herokuapp.com/code2pdf/ (pour java : xcode sur fond blanc très bien)

Pour de grandes lettres composées de caractère ASCII : http://www.jave.de/ avec aussi des fonctions de dessin