IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)
Navigation

Inscrivez-vous gratuitement
pour pouvoir participer, suivre les réponses en temps réel, voter pour les messages, poser vos propres questions et recevoir la newsletter

  1. #1
    Chroniqueur Actualités

    Homme Profil pro
    Rédacteur technique
    Inscrit en
    juin 2016
    Messages
    1 653
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : Bénin

    Informations professionnelles :
    Activité : Rédacteur technique
    Secteur : Aéronautique - Marine - Espace - Armement

    Informations forums :
    Inscription : juin 2016
    Messages : 1 653
    Points : 39 637
    Points
    39 637
    Par défaut Markdown vs LaTeX : quel outil utilisez-vous pour écrire la documentation de vos projets ?
    Markdown vs LaTeX : quel outil utilisez-vous pour écrire la documentation de vos projets ?
    Markdown serait plus performant mais ne peut pas transporter des données

    Quel outil utilisez-vous pour écrire la documentation de vos projets ? Vous avez forcément une préférence pour un outil donné, mais y en a-t-il un qui est plus performant que les autres ? Dans le lot d’outils qui existent, l’on retrouve Markdown et Latex. Pour les certains, Markdown est l’outil le plus performant pour écrire son document, mais pour d’autres, il présente des incohérences et ne peut pas transporter des données. Pour ces derniers, il faut choisir Latex à la place afin de fournir un travail correct. Voici certaines choses qu’ils disent dans leur argumentation.

    Markdown est un langage de balisage léger créé en 2004 par John Gruber avec l'aide d'Aaron Swartz. L’objectif est de mettre à disposition un langage doté d’une syntaxe facile à lire et à écrire. Un document balisé par Markdown peut être lu en l'état sans donner l’impression d'avoir été balisé ou formaté par des instructions particulières. De l’autre côté, LaTeX est un langage, mais aussi un système de composition de documents. C’est une collection de macro-commandes qui cherchent à faciliter et à améliorer l'utilisation du « processeur de texte » TeX de Donald Knuth.

    Pour Jeff Geerling, développeur Web et logiciel, Markdown est un excellent choix pour écrire son document. Selon lui, Markdown suffit dans 98 % pour mettre en place une documentation en bonne et due forme, ce qui lui donne un avantage considérable sur les alternatives qui existent. Il soutient que Markdown est essentiellement du texte simple que tout le monde peut apprendre à écrire en quelques secondes seulement, avec des fonctionnalités supplémentaires. De même, il cite aussi comme argument le fait qu’il existe une multitude de bibliothèques pour l’outil.

    Nom : 5ade5bd9b90e6112230675.png
Affichages : 65241
Taille : 3,3 Ko

    « Le fait que le plus petit dénominateur commun de Markdown soit “je peux écrire du texte simple”, associé au fait qu'il existe de très bonnes bibliothèques pour Markdown dans tous les langages imaginables, signifie qu’il est le moyen le plus simple dont vous disposez pour pouvoir écrire une documentation maintenable, quel que soit l'auteur qui contribue à votre base de code », a-t-il écrit. Selon lui, il est plus facile de modifier une documentation en texte clair qu’une autre écrite dans un format spécifique, moins populaire et nécessitant plus de spécificité.

    Cependant, selon HIllel Wayne, un programmeur et conseillé en méthodes formelles, Markdown n’est pas du tout l’outil idéal pour écrire une bonne documentation. Selon lui, Markdown est tolérable pour écrire les documents courts, comme un readme.md. « En dehors de ça, ce n'est pas le bon outil pour le travail », a-t-il écrit. Markdown est juste une question de formatage, pas d'information, selon lui. Autrement dit, c’est juste une façon d’écrire du HTML plus simple et plus beau. Les gens l’utilisent parce qu’il est facile à apprendre.

    En outre, il estime que les gens le choisissent parce qu’il est facile d'écrire une sorte d'analyseur Markdown dans n'importe quel langage de programmation. Pour lui, Markdown ne peut pas transporter des données. Il n’existe aucun moyen d'intégrer des propriétés dans un texte en utilisant Markdown. Il estime qu’une bonne documentation n’est pas une question de formatage, mais elle concerne le balisage sémantique. De plus, il n’est pas extensible. En effet, il estime que quand vous utilisez Markdown, vous n’avez droit qu’à trois types de formatage : gras, italique et code.

    Nom : illu_redigez-des-documents-de-qualite-avec-latex.png
Affichages : 6540
Taille : 2,5 Ko

    Si c’est le cas, que faire si vous souhaitez que certains éléments de la documentation soient colorés en bleu ? Ce type d’action n’est pas faisable. Vous ne pouvez que changer le CSS pour <em>, mais vous perdez l'italique dès lors que vous faites cela. Toutefois, il rappelle que Markdown peut être extensié uniquement en ajoutant du HTML brut. Le HTML est interprété comme du HTML à l'intérieur d'un document Markdown. Mais l’objectif de Markdown est d'éviter d'avoir à écrire du HTML en premier lieu. Vous ne pouvez pas non plus “hybrider” le Markdown avec du HTML.

    En fait, ce qui se trouve dans les balises HTML ne sera pas analysé comme Markdown. Les gens ont essayé de résoudre ce problème avec les extensions pour l’outil, mais elles sont directement ajoutées au moteur de Markdown, et non dans le cadre d'une fonctionnalité d'extensibilité de ce dernier. Si vous voulez avoir une nouvelle chose, vous devez modifier le code du moteur. Par exemple, c’est ce qui arrive avec des images avec une légende. Ceci ne fait pas partie des spécifications de Markdown. En outre, il estime que Markdown ne propose qu’un traitement local.

    Enfin, le dernier argument qu’il trouve en défaveur de Markdown est qu’il est juste bon pour écrire du HTML, mais pas du tout adapté pour écrire des documents PDF par exemple. Selon lui, une documentation doit être consultable hors ligne. Ainsi, si vous ne fournissez pas un PDF pour cela, il faut que vous proposiez au moins un lien pour télécharger les documents. Comme alternative, il vous propose d’utiliser reStructuredText ou RST pour écrire vos documentations. Selon lui, Latex est un bon outil, mais il n’est pas meilleur que Markdown.

    D’après lui, avec reStructuredText, vous pouvez ajouter toutes sortes d'autres choses, comme montrer ou cacher des sections ou intégrer des mathématiques. Cela dit, l'inconvénient est qu'il est plus complexe que Markdown. Une autre alternative qu’il propose est AsciiDoc. Selon lui, AsciiDoc semble être très utile aussi.

    Pour finir, selon Jeff Geerling qui soutient que Markdown est le meilleur outil pour vos documentations, il y a souvent de bonnes raisons de préférer une option plus structurée, comme reStructuredText, LaTeX ou Asciidoc. Cela arrive surtout dans le cadre des projets où un texte plus formel est nécessaire, ou lorsque vous devez prendre en charge la mise en forme de textes spécialisés et structurés. Néanmoins, Jeff Geerling pense que Markdown est le meilleur et le plus flexible des outils pour une documentation.

    Sources : Jeff Geerling, HIllel Wayne

    Et vous ?

    Quel est votre avis sur le sujet ?
    Quel outil utilisez-vous pour écrire la documentation de vos projets ?
    Quelle est votre préférence, Markdown ou LaTeX ou autres ? Pourquoi ?

    Voir aussi

    Mark Text : un éditeur Markdown simple et élégant axé sur la rapidité et la convivialité selon son développeur. Disponible pour macOS, Windows et Linux

    YouTrack 2019.3 est disponible avec un support HTML dans Markdown et d'autres nouvelles fonctionnalités et améliorations

    Utilisez Markdown pour rédiger des articles ou tutoriels sur Developpez.com, en plus des autres outils toujours disponibles
    Contribuez au club : Corrections, suggestions, critiques, ... : Contactez le service news et Rédigez des actualités

  2. #2
    Membre éclairé
    Homme Profil pro
    Développeur C++
    Inscrit en
    octobre 2008
    Messages
    227
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : France, Bas Rhin (Alsace)

    Informations professionnelles :
    Activité : Développeur C++

    Informations forums :
    Inscription : octobre 2008
    Messages : 227
    Points : 673
    Points
    673
    Par défaut
    Usuellement j'utilise du mdoc car je documente sous forme de page de manuel puis je converti en HTML pour afficher une version en ligne. Ensuite j'utilise la syntaxe textile de mon wiki redmine pour tout ce qui est annexe.

    Le markdown est bien trop limité.

  3. #3
    Membre confirmé

    Homme Profil pro
    Développeur Java
    Inscrit en
    février 2007
    Messages
    179
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 33
    Localisation : France, Rhône (Rhône Alpes)

    Informations professionnelles :
    Activité : Développeur Java
    Secteur : High Tech - Éditeur de logiciels

    Informations forums :
    Inscription : février 2007
    Messages : 179
    Points : 645
    Points
    645
    Par défaut
    Pour moi la doc c'est JavaDoc pour le code et markdown pour le reste.
    L'expérience est une lanterne que l'on porte sur le dos et qui n'eclaire jamais que le chemin parcouru.

    La nature fait les choses sans se presser, et pourtant tout est accompli.

  4. #4
    Membre éprouvé
    Profil pro
    Inscrit en
    novembre 2009
    Messages
    458
    Détails du profil
    Informations personnelles :
    Localisation : Belgique

    Informations forums :
    Inscription : novembre 2009
    Messages : 458
    Points : 1 092
    Points
    1 092
    Par défaut Mais
    Markdown vs latex???
    On compare vélo avec autocar là !
    Ça me viendrait pas à l'idée du tout d'aller chercher mon pain en autocar.
    Ni d'organiser l'excursion de la boîte en baie de Somme à vélo.
    Je comprends pas bien l'intérêt de la question.

  5. #5
    Membre régulier
    Homme Profil pro
    Ingénieur développement logiciels
    Inscrit en
    juin 2005
    Messages
    27
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : France, Paris (Île de France)

    Informations professionnelles :
    Activité : Ingénieur développement logiciels

    Informations forums :
    Inscription : juin 2005
    Messages : 27
    Points : 87
    Points
    87
    Par défaut
    http://asciidoc.org/ plus complet que MD.

  6. #6
    Membre régulier
    Homme Profil pro
    Ingénieur développement logiciels
    Inscrit en
    juin 2005
    Messages
    27
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : France, Paris (Île de France)

    Informations professionnelles :
    Activité : Ingénieur développement logiciels

    Informations forums :
    Inscription : juin 2005
    Messages : 27
    Points : 87
    Points
    87
    Par défaut
    Citation Envoyé par frfancha Voir le message
    Markdown vs latex???
    On compare vélo avec autocar là !
    Ça me viendrait pas à l'idée du tout d'aller chercher mon pain en autocar.
    Ni d'organiser l'excursion de la boîte en baie de Somme à vélo.
    Je comprends pas bien l'intérêt de la question.
    Entièrement d'accord. Si demain je fais un rapport de 150 pages je pense qu'il a plus de chance d'être en LaTeX. Si c'est pour faire un README dans mon projet OpenSource moins.

  7. #7
    Membre expert Avatar de air-dex
    Homme Profil pro
    Inscrit en
    août 2010
    Messages
    1 582
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 33
    Localisation : France

    Informations forums :
    Inscription : août 2010
    Messages : 1 582
    Points : 3 518
    Points
    3 518
    Par défaut
    Les deux n'ont surtout pas les mêmes usages. Le LaTeX sert plus pour de la bureautique, genre publication de plusieurs dizaines ou centaines de pages. LaTeX est plus un concurrent de MS Office ou de LibreOffice que de Markdown.

    Pour documenter mon code j'utiliserais plutôt Markdown ou Doxygen.
    "Ils ne savaient pas que c'était impossible alors ils l'ont fait." Mark Twain

    Mon client Twitter Qt cross-platform Windows et Linux. (en cours de développement).

  8. #8
    Responsable Qt & Livres


    Avatar de dourouc05
    Homme Profil pro
    Ingénieur de recherche
    Inscrit en
    août 2008
    Messages
    25 863
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : France, Val de Marne (Île de France)

    Informations professionnelles :
    Activité : Ingénieur de recherche
    Secteur : Enseignement

    Informations forums :
    Inscription : août 2008
    Messages : 25 863
    Points : 181 670
    Points
    181 670
    Par défaut
    Citation Envoyé par air-dex Voir le message
    Le LaTeX sert plus pour de la bureautique, genre publication de plusieurs dizaines ou centaines de pages. LaTeX est plus un concurrent de MS Office ou de LibreOffice que de Markdown.
    Et encore... Tu utiliserais LaTeX pour un document simple ? L'outil est trop compliqué pour la grande majorité des tâches de bureautique. Il est bien pour générer un PDF léché, surtout du gros, mais sinon... (Déjà, pour rédiger la source utilisée pour générer ce PDF, j'ai du mal à imaginer utiliser LaTeX, comme si les gens écrivaient leur code en assembleur dans toutes les situations...)
    Vous souhaitez participer aux rubriques Qt (tutoriels, FAQ, traductions) ou HPC ? Contactez-moi par MP.

    Créer des applications graphiques en Python avec PyQt5
    Créer des applications avec Qt 5.

    Pas de question d'ordre technique par MP !

  9. #9
    Membre confirmé
    Profil pro
    Retraité
    Inscrit en
    novembre 2009
    Messages
    321
    Détails du profil
    Informations personnelles :
    Localisation : France

    Informations professionnelles :
    Activité : Retraité

    Informations forums :
    Inscription : novembre 2009
    Messages : 321
    Points : 584
    Points
    584
    Par défaut
    Tout dépend du type de programme et de ce qu'on entend par documentation.

    Pour un programme à forte orientation mathématique comme GraceGTK, LaTeX m'a semblé être LA solution pour une documentation un peu complète (https://sourceforge.net/projects/gracegtk/files/doc)
    GraceGTK: a plotting tool at https://sourceforge.net/projects/gracegtk

  10. #10
    Membre régulier
    Homme Profil pro
    Ingénieur développement logiciels
    Inscrit en
    juin 2005
    Messages
    27
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : France, Paris (Île de France)

    Informations professionnelles :
    Activité : Ingénieur développement logiciels

    Informations forums :
    Inscription : juin 2005
    Messages : 27
    Points : 87
    Points
    87
    Par défaut
    Citation Envoyé par dourouc05 Voir le message
    Et encore... Tu utiliserais LaTeX pour un document simple ? L'outil est trop compliqué pour la grande majorité des tâches de bureautique. Il est bien pour générer un PDF léché, surtout du gros, mais sinon... (Déjà, pour rédiger la source utilisée pour générer ce PDF, j'ai du mal à imaginer utiliser LaTeX, comme si les gens écrivaient leur code en assembleur dans toutes les situations...)
    Ouais enfin quand tu connais la syntaxe tu fait un doc LaTeX dans le même temps que d'autre démarre Word. C'est plus une question d'habitude pour le coup.

  11. #11
    Membre à l'essai
    Homme Profil pro
    Étudiant
    Inscrit en
    avril 2017
    Messages
    4
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 29
    Localisation : France, Paris (Île de France)

    Informations professionnelles :
    Activité : Étudiant
    Secteur : Aéronautique - Marine - Espace - Armement

    Informations forums :
    Inscription : avril 2017
    Messages : 4
    Points : 19
    Points
    19
    Par défaut
    Je pense qu'avec pandoc, les choses sont, désormais, relativement facile. On peut rédiger avec markdown et le convertir en plein d'autres formats(Tex, HTML, MS Word, Pdf, ...etc).

  12. #12
    Membre expérimenté Avatar de cavo789
    Homme Profil pro
    Développeur Web
    Inscrit en
    mai 2004
    Messages
    1 122
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 46
    Localisation : Belgique

    Informations professionnelles :
    Activité : Développeur Web

    Informations forums :
    Inscription : mai 2004
    Messages : 1 122
    Points : 1 642
    Points
    1 642
    Par défaut pandoc et un script perso
    Bonsoir


    Je rejoins l'idée mentionnée ci-dessus qu'avec Pandoc on fait déjà des merveilles. On écrit en markdown et on produit des documents dans de multiples format dont PDF.


    A ce titre, je vous invite à découvrir le template `eisvogel.tex` (https://github.com/Wandmalfarbe/pandoc-latex-template) de Pascal Wagler.


    Je rédige tout en markdown et quand je dis tout, c'est presque tout : emails, documentations et présentations (slideshow). Pour ce dernier, j'utilise alors `reveal.js` (https://github.com/hakimel/reveal.js).


    Retour sur markdown : oui, le langage est limité mais c'est sa force. Il est lisible en tant que tel et déjà largement suffisant.


    Mais pas que... J'ai développé un script (professionnel; désolé) en Powershell qui parse mes documents.


    Je crée une structure de dossier avec des dossiers, sous-dossiers et documents .md. Le script parcoure le projet et prends chaque fichiers `.md` et consolide dans un seul fichier (`mon_projet.md` p.ex.). A chaque fois que je descends dans la structure (un sous-dossier), j'ajoute un niveau à mes titres (un `#` devient donc un `##`) et ainsi je respecte la hiérarchie des documents selon la structure.


    Code : Sélectionner tout - Visualiser dans une fenêtre à part
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    Mon projet
        010-Introduction
            index.md
        020-Installation
            010-Téléchargement
                index.md
            020-Exécution
                index.md
        030-Configuration
        etc

    Toujours avec ce parser, j'analyse le contenu des fichiers `.md` et je recherche des *tags* : j'ajoute p.ex. un `<!-- plugin::toc -->` et le parser voit `<!-- plugin::XXX -->` et sait qu'il doit faire quelque chose.


    J'ai des dizaines de plugins, dont p.ex. `toc` pour générer une table des matières et donc, le parser lit le fichier complet (`mon_projet.md`); fait l'inventaire des titres et génère une table des matières.


    Des dizaines ... et c'est simple à en créer d'autres.


    * `<!-- plugin::exec "dir *.png" -->` pour exécuter une commande DOS, récupérer l'output de la commande et insérer cela dans mon document (et donc avoir une liste d'images .png p.ex.),
    * `<!-- plugin::webservice {"url":"XXXX", "...."} -->` pour exécuter un service web, la liste des paramètres étant fournis dans un code de type JSON, l'output du service web sera insérer dans le document,
    * `<!-- plugin::mysql {"db":"xxx", "user":"xxx", "sql":"select * from ...", "...."} -->` pour exécuter un query SELECT ... ROM sur une DB MySQL, récupérer le résultat et l'afficher sous forme de tableau dans mon document,
    * `<!-- plugin::csv "fichier.csv" -->` pour lire un fichier .csv, le convertir en un tableau et l'insérer dans le document,
    * `<!-- plugin::include "source.php" -->` pour inclure un fichier externe et l'afficher dans un tag PHP ou XML ou JSON ou ...
    * ...


    La seule limite est l'imagination.


    Tout ça avec :


    1. Tout se fait en markdown
    2. Un script qui traite le fichier / les fichiers et qui génère un fichier final
    3. Pandoc pour la conversion vers le format souhaité
    4. Selon le format utilisé pour la conversion, ajout de paramètres à Pandoc pour p.ex. utiliser un modèle .tex ou .docx (pour Word) ou .html/.css pour un export en HTML.


    Alors un immense OUI à Markdown.


    Bonne soirée.
    Christophe (cavo789)
    Mes scripts Open Source : https://github.com/cavo789

  13. #13
    Membre averti
    Homme Profil pro
    Expert MDE
    Inscrit en
    janvier 2008
    Messages
    181
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 37
    Localisation : France, Hauts de Seine (Île de France)

    Informations professionnelles :
    Activité : Expert MDE
    Secteur : High Tech - Électronique et micro-électronique

    Informations forums :
    Inscription : janvier 2008
    Messages : 181
    Points : 331
    Points
    331
    Par défaut Et asciidoctor alors?
    Asciidoctor sert à écrire la plupart des livres de Manning, O'Reilly et consort. Perso j'adore

  14. #14
    Expert confirmé
    Homme Profil pro
    Développeur informatique
    Inscrit en
    avril 2017
    Messages
    1 352
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : France, Paris (Île de France)

    Informations professionnelles :
    Activité : Développeur informatique

    Informations forums :
    Inscription : avril 2017
    Messages : 1 352
    Points : 5 526
    Points
    5 526
    Par défaut
    Citation Envoyé par Bill Fassinou Voir le message
    Quel outil utilisez-vous pour écrire la documentation de vos projets ?
    Markdown pour des docs simples, visibles directement sur Github.
    Markdown + Pandoc si j'ai besoin de générer plusieurs versions (HTML + PDF).
    Latex si j'ai besoin que d'un PDF et que le document est vraiment compliqué.

    Pour la simplicité de Markdown, c'est relatif. Perso, j'arrive à inclure du code, des formules de math, des vidéo (qui sont automatiquement remplacées par des images dans la version PDF), etc. Et puis ça encourage à écrire des docs claires sans fioritures inutiles qui finalement pertubent la lecture.

    Pour la complexité de Latex, c'est relatif aussi. Comparé à Word, c'est juste que Latex n'est pas WYSIWYG. Mais si on veut un document classique avec des sections et un sommaire, que ce soit Latex ou Word, dans les deux cas il faut définir les styles et inclure le sommaire. Et pour Latex, on peut aussi passer par des services comme Overleaf, qui proposent des templates de base, un compilateur, un système de partage et de review, etc.

  15. #15
    Membre expérimenté Avatar de cavo789
    Homme Profil pro
    Développeur Web
    Inscrit en
    mai 2004
    Messages
    1 122
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 46
    Localisation : Belgique

    Informations professionnelles :
    Activité : Développeur Web

    Informations forums :
    Inscription : mai 2004
    Messages : 1 122
    Points : 1 642
    Points
    1 642
    Par défaut
    Citation Envoyé par SimonDecoline Voir le message
    Pour la simplicité de Markdown, c'est relatif. Perso, j'arrive à inclure du code, des formules de math, des vidéo (qui sont automatiquement remplacées par des images dans la version PDF), etc.
    En effet et j'avais oublié ci-dessus de mentionner Mermaid (https://mermaid-js.github.io/mermaid/#/) qui permet "d'écrire" un diagramme et de générer un flow sous forme d'image. On peut automatiser la génération avec Mermaid-CLI (https://github.com/mermaidjs/mermaid.cli).


    Citation Envoyé par SimonDecoline Voir le message
    Et puis ça encourage à écrire des docs claires sans fioritures inutiles qui finalement pertubent la lecture.
    C'est absolument vrai !

    Et c'est même "extraordinairement vrai" lorsqu'on utilise Markdown pour générer des slideshow (https://revealjs.com/#/) : avec Powerpoint, quelle misère ! Quel temps perdu sur l'affichage, sur le positionnement, sur la taille de ceci et la couleur de cela. Ce temps pour la mise en page est un temps conséquent et ... tout est à recommencer dès qu'on opte pour un autre modèle de présentation. C'est vraiment dingue. Avec Markdown, on se concentre sur le contenu et on oublie les fioritures inutiles.

    Bonne soirée
    Christophe (cavo789)
    Mes scripts Open Source : https://github.com/cavo789

  16. #16
    Nouveau membre du Club
    Profil pro
    Inscrit en
    avril 2005
    Messages
    41
    Détails du profil
    Informations personnelles :
    Localisation : Belgique

    Informations forums :
    Inscription : avril 2005
    Messages : 41
    Points : 33
    Points
    33
    Par défaut
    Toute la doc de Rust aussi que leurs books, sont écrites en Markdown.

    Dans ce cas le documentation fait partie intégrante du programme, donc sa doit être simple.

  17. #17
    Membre actif
    Homme Profil pro
    Gérant
    Inscrit en
    février 2006
    Messages
    255
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 47
    Localisation : Dom-Tom

    Informations professionnelles :
    Activité : Gérant

    Informations forums :
    Inscription : février 2006
    Messages : 255
    Points : 292
    Points
    292
    Par défaut
    Franchement Latex, je m'y suis essayé, j'ai lâché l'affaire au bout d'une heure, deux heures pour être gentil, tant ce n'est pas adapté au commun des mortels ! Et il parait qu'il y a des écrivains qui l'utilisent !!! Ils devaient être en manque d'inspiration...

    J'en suis au point où j'ai pour Latex une réelle aversion, on passe plus de temps à essayer d'apprendre le bouzin qu'à l'utiliser pour un projet !

    Office et OpenOffice font ce qu'on souhaite aussi bien que Latex, en tout cas pour celui qui n'est pas pinailleur ou perfectionniste et sait utiliser ces outils...

    Markdown, 5 minutes pour apprendre à conduire et ensuite on roule partout. Par contre comme certains l'ont dit plus haut, difficile de comparer l'incomparable, Markdown et Latex ne sont clairement pas fait pour les mêmes projets.

    C'était ma modeste et naze contribution

  18. #18
    Candidat au Club
    Homme Profil pro
    Profession indépendante
    Inscrit en
    mars 2017
    Messages
    1
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 57
    Localisation : France, Marne (Champagne Ardenne)

    Informations professionnelles :
    Activité : Profession indépendante
    Secteur : Agroalimentaire - Agriculture

    Informations forums :
    Inscription : mars 2017
    Messages : 1
    Points : 2
    Points
    2
    Par défaut Vim/Geany + Pandoc + LateX (pdfLateX / latexmk)
    Complètement en accord avec Cavo789.

    On peut tout faire avec Markdown + pandoc + latex.
    Un petit script en bash ou perl et un bloc YAML dans fichier md pour automatiser tout cela et avoir une visualistion des modif. temps réel dans un pdf viewer.

    Si Markdown a des limites, on peut insérer qqs commandes latex dedans et by-passer ses manques.

    Avec ce workflow, on ne s'occupe que du CONTENU. Pandoc/latex s'occupe de la mise en page automatique.
    le temps de la conversion est de 1 sec. pour une paire de pages à qqs minutes pour des centaines de pages.
    En travail type bureautique, qqs secondes...
    A comparer avec les utilisateurs Word qui passent plus de temps à régler leur format de page qu'à taper leur texte lui-même.
    J'ai travaillé pendant des années avec des traitements de texte ( Word, WPS, LibreOffice et Cie) et j'ai pu comparer.
    Travaillant aujourd'hui avec :
    Vim, Markdown (+ template ou YAML metablocks) et Pandoc + LateX >> pdf,
    je gagne un temps considérable
    * à la Creation ET
    * à la Maintenance de mes document.
    Je ne reviendrais plus en arrière, c'est certain !
    En tout cas, Markdown et Pandoc pour la base.
    Latex vient ensuite naturellement en complément pour un edition PDF des documents.
    Mais il ne me semble pas adapté deles mettre en compétition : ils sont complementaires.
    C'est mon avis d'utilisateur de ce workflow.

  19. #19
    Expert éminent
    Avatar de sekaijin
    Homme Profil pro
    Urbaniste
    Inscrit en
    juillet 2004
    Messages
    4 173
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 56
    Localisation : France, Yvelines (Île de France)

    Informations professionnelles :
    Activité : Urbaniste
    Secteur : Santé

    Informations forums :
    Inscription : juillet 2004
    Messages : 4 173
    Points : 8 637
    Points
    8 637
    Par défaut
    Markdown vs LaTex => AsciiDoctor

  20. #20
    Membre régulier
    Avatar de FrancisGernet
    Homme Profil pro
    Responsable de projet fonctionnel
    Inscrit en
    février 2013
    Messages
    28
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : France, Morbihan (Bretagne)

    Informations professionnelles :
    Activité : Responsable de projet fonctionnel
    Secteur : Communication - Médias

    Informations forums :
    Inscription : février 2013
    Messages : 28
    Points : 83
    Points
    83
    Par défaut C'est incomparable !
    Bonjour,

    Je pratique (un peu) LaTeX depuis assez longtemps. Impeccable pour faire de beaux documents, et, s'ils sont un peu longs, appréciable pour les notes, les renvois, la tables des matières, l'index...
    Il permet aussi des mises en pages « chiadées » pour des rapports, des aides-mémoire (cheatsheet)... et est incontournable pour les formules scientifiques (équations, etc.)
    J'ai découvert les langages de balisage légers plus récemment, de MD à RST ; pour de petits textes de quelques pages, j'utilise la version (car il y en a beaucoup) de MarkDown avec l'outil Zettler (https://www.zettlr.com/), et aussi bien sûr celle de MediaWiki.
    Enfin je viens de découvrir (il n'est jamais trop tard) groff (GNU troff, https://www.gnu.org/software/groff/) et ses macros, que je pense essayer de mettre en œuvre pour mon courrier.

    Pour la documentation simple, markdown, pour un support de cours, Latex (LuaLaTeX).

    +1 pour mermaid (https://mermaid-js.github.io/mermaid/), sinon Dia, qui semble malheureusement à l'arrêt (wiki.gnome.org/Apps/Dia/).

    Note : je n'ai pas bien compris le passage : «... Markdown ne peut pas transporter des données »

    Bien à vous, cordialement.

Discussions similaires

  1. Quel outil utilisez vous pour concevoir vos bases de données
    Par Matthieu Brucher dans le forum Outils
    Réponses: 93
    Dernier message: 01/08/2014, 16h20
  2. Quels outils utilisez-vous pour créer vos rubans?
    Par Arkham46 dans le forum Microsoft Office
    Réponses: 2
    Dernier message: 02/01/2011, 23h27
  3. [D] Quels outils utilisez-vous pour programmer ?
    Par johnnyjohnny dans le forum Autres langages
    Réponses: 5
    Dernier message: 20/08/2007, 17h37
  4. Réponses: 1
    Dernier message: 30/05/2007, 14h36
  5. Quels outils utilisez-vous pour créer des diagrammes ?
    Par khayyam90 dans le forum Tableaux - Graphiques - Images - Flottants
    Réponses: 11
    Dernier message: 30/05/2007, 12h56

Partager

Partager
  • Envoyer la discussion sur Viadeo
  • Envoyer la discussion sur Twitter
  • Envoyer la discussion sur Google
  • Envoyer la discussion sur Facebook
  • Envoyer la discussion sur Digg
  • Envoyer la discussion sur Delicious
  • Envoyer la discussion sur MySpace
  • Envoyer la discussion sur Yahoo