Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
ressource:logiciel:outils_documentation [2021/06/25 12:05]
emoc [sganimator]
ressource:logiciel:outils_documentation [2024/04/10 18:31] (Version actuelle)
emoc [Écrire en markdown]
Ligne 1: Ligne 1:
 +{{tag>​documentation python animation em}}
 +
 ====== Outils de documentation ====== ====== Outils de documentation ======
  
Ligne 8: Ligne 10:
  
 Sur linux, il est installable depuis les dépôts ''​sudo apt install asciinema''​ Sur linux, il est installable depuis les dépôts ''​sudo apt install asciinema''​
 +
 +===== Transformer des liens en liens cliquables =====
 +
 +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 
  
 ===== Enregistrer des vidéos de l'​écran =====  ===== Enregistrer des vidéos de l'​écran ===== 
Ligne 27: Ligne 36:
   * https://​github.com/​ManimCommunity/​manim/​   * https://​github.com/​ManimCommunity/​manim/​
  
-{{:​ressource:​logiciel:​sinecurveunitcircle-1.mp4?​540 |}}+{{:​ressource:​logiciel:​sinecurveunitcircle-1.mp4?​540x360|}} 
 + 
 +===== Visualiser des données ===== 
 + 
 +voir aussi [[ressource:​data_analyse_visualisation|]] 
 + 
 +==== ObservableHQ ==== 
 + 
 +Carnet de notes permettant d'​inclure différents types de cellules (calcul, visualisation) : https://​observablehq.com/​ 
 + 
 + 
 + 
 +==== rawgraphs.io ==== 
 + 
 +Application en ligne avec de nombreux types de visualisation : https://​app.rawgraphs.io/​ 
 + 
 + 
 + 
 +===== Cartographie ===== 
 + 
 +voir aussi [[ressource:​code:​cartographie:​start|cartographie avec python]] 
 + 
 +==== umap ==== 
 + 
 +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/​ 
 + 
 +==== leaflet.js ==== 
 + 
 +Bibliothèque javascript, à réserver aux codeu/​r/​se/​s 
 + 
 +https://​leafletjs.com/​ 
 + 
 +===== Rédaction de documentation pour diffusion sur le web ===== 
 + 
 +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 
 + 
 +===== Wiki(s) ===== 
 + 
 +Une page ressource très complète sur dokuwiki : https://​dvillers.umons.ac.be/​wiki/​floss:​dokuwiki 
 + 
 +===== LateX ===== 
 + 
 +Des ressources : https://​dvillers.umons.ac.be/​wiki/​floss:​latex 
 + 
 +===== Écrire en markdown ===== 
 + 
 +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 
 + 
 +===== Conversions de format texte ===== 
 + 
 +Passer de dokuwiki à markdown à mediawiki à pdf, etc. \\ 
 +-> avec Pandoc, installable ou en ligne : https://​pandoc.org/​try/​ 
 + 
 +===== Mise en page de code ===== 
 + 
 +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) 
 + 
 +===== Typo ASCII / Dessin ASCII ===== 
 + 
 +Pour de grandes lettres composées de caractère ASCII : **http://​www.jave.de/​** avec aussi des fonctions de dessin
  • ressource/logiciel/outils_documentation.1624615552.txt.gz
  • Dernière modification: 2021/06/25 12:05
  • par emoc