« En finir avec Word ! Pour une analyse des enjeux relatifs aux traitements de texte et à leur utilisation »
« En finir avec Word ! Pour une analyse des enjeux relatifs aux traitements de texte et à leur utilisation »
en fait, je n’utilise pratiquement plus du tout de traitement de texte. Pratiquement que des éditeurs #MarkDown : rapides, légers, efficaces…
Le truc pénible que j’affronte en ce moment, ce sont les différentes syntaxes de type markdown qui existent, du bbcode à mediawiki en passant, donc, par markdown (essentiellement sur les usines git*).
En fait, j’aimerais bien que mediawiki se mette à faire du markdown... ou l’inverse... :-)
Trouvé par Sylvain : « Drag and drop tools are just simpler. That’s a fact.
That’s why I’m working on a drag and drop alternative to Microsoft Word. To get started, just open up the dictionary panel, find the word you like and drag it onto the document. »
▻https://twitter.com/markdalgleish/status/1172260389158977536
Pour convertir les dialectes #Markdown entre eux (mais aussi d’autres « formats ») j’utilise #pandoc
Pandoc - About pandoc
▻https://pandoc.org/index.html
If you need to convert files from one markup format into another, pandoc is your swiss-army knife. Pandoc can convert between the following formats:
(← = conversion from; → = conversion to; ↔︎ = conversion from and to)
Well. Je trouve #markdown super ... pour exporter du html. Dès qu’il s’agit d’aller vers d’autres formats, ça demande d’installer tellement de dépendances pour avoir quelque chose de propre (par exemple des images redimensionnées à la taille du fichier d’export) qu’à ce stade, je finis toujours par copier coller dans libreoffice mon document pour pouvoir le transmettre à d’autres. (j’utilise uberwriter, mais c’est vrai aussi pour les autres soft testés (atom...).
@supergeante mais markdown c’est juste pour rédiger l’intérieur des chapitres, forcément ça fait pas tout. Dans l’idée d’un workflow complet du genre Syntaxe légère => web => print, il faut forcément coupler avec d’autres outils, pour contrôler finement les images ou autres choses non texte de ce genre. À priori avec un langage de template qui fait vraiment tout ce qu’il y a « autour » de la transformation pur du texte, càd faire le plan, l’entourage des chapitres, retailler les images, etc.
Nous actuellement on ne fait pas ça avec markdown mais avec SPIP, mais le principe reste le même. Du coup ya la syntaxe légère SPIP, mais aussi les modèles d’insertion d’images aussi. La syntaxe légère est transformée comme pour markdown, mais donc il y a un squelette qui s’occupe de mettre tous les chapitres ensemble et produire le HTML final. Qui ensuite est mis en forme avec une CSS print (avec tous les trucs modernes).
Là on fait tout nous-mêmes, pour tout contrôler, mais on peut très bien imaginer que des outils comme Pandoc ou autre fasse aussi ce travail. Je veux dire, c’est à ce morceau du workflow (après la gestion de la syntaxe légère) de retailler les images, et si ça manque, faut leur demander. :)
– Syntaxe légère, organisé en chapitres (tout dans le même document, ou bien dans plusieurs fichiers, ou comme nous dans une base de données avec nos objets « Chapitres » de SPIP)
– La syntaxe légère est transformée en HTML
– Un autre outil, langage de template ou autre, s’occupe de composer le document complet avec vraiment tout (sommaire, pied de pages, travail des images, etc).
– On a alors un unique HTML complet
– Qui est soit transformé en PDF à partir d’une CSS, soit en ODT, ou autre encore (mais c’est toujours à partir du HTML qui est pivot à priori)
Alors, (presque) tout pareil... sauf que la syntaxe en entrée n’est pas du tout légère : c’est du XML/TEI issu de la numérisation d’ouvrage papier. ▻https://github.com/DrozNumerique/zord-library
mermaid · GitBook
▻https://mermaidjs.github.io
Generation of diagrams and flowcharts from text in a similar manner as markdown.
Ever wanted to simplify documentation and avoid heavy tools like Visio when explaining your code?
This is why mermaid was born, a simple markdown-like script language for generating charts from text via javascript.
Un générateur (javascript) de diagrammes à partir de sources en markdown.
Basé sur le moteur de rendu de #3djs, utilise la syntaxe de js-sequence-diagram (▻https://bramp.github.io/js-sequence-diagrams)
A tester : l’éditeur en ligne ▻https://mermaidjs.github.io/mermaid-live-editor
Plusieurs éditeurs de code supportant le markdown proposent des plugins pour la prévisualisation (VS Code, Sublime text, VIm...).
Un plugin Gitlab permet d’afficher les schémas intégrés dans les fichiers .md (en particulier le Readme.md) : idéal pour des schémas intégrés à la documentation
(à intégrer dans le plugin markdown de SPIP ?)
#diagramme #javascript #markdown #gitlab #js-sequence-diagram #documentation
Zettlr | Home
▻https://www.zettlr.com
Since its inauguration by John Gruber in 2004, #Markdown has made its way to the top of #writing methods. By now, there are numerous different Markdown editors from very simple applications that are designed for pure note keeping towards the most complex editors that not only support Markdown but numerous other languages as well.
Zettlr enters this broad field with a clear aim in mind: To provide the ability to take #notes and write scientific #papers for #researchers in the arts and humanities, a group that has been underrepresented in recent developments.
Je suis aussi habituellement sous Typora, mais ce machin a l’air d’aller au-delà du simple éditeur MarkDown, notamment comme organiseur #Zettelkasten de notes et fragments, sans compter le fait qu’on peut aussi l’utiliser comme IDE, avoir des dossiers virtuels ou des dossiers de projets.
J’essaie de comprendre toutes les fonctionnalités et plus particulièrement le Zettelkasten.
Pour les liens, il y a des paramétrages prévus pour cela.
HackMD - Collaborative markdown notes
▻https://hackmd.io
Un éditeur Markdown en ligne avec double fenêtre, barre d’outils... (parmi les nombreux outils équivalents)
C’est pas tant un éditeur Markdow, mais surtout un pad collaboratif comme etherpad avec multiédition, historique et couleur de qui a écrit. Mais en mieux (d’après nous), plus léger, plus stable, et donc tout en markdown, et avec des syntaxes additionnelles genre Graphviz, on peut générer de l’UML, des Gantt, etc.
Ah et aussi : on peut l’installer chez soi, ça s’appelle CodiMD :
▻https://github.com/hackmdio/codimd
JavaScript Markdown Editor - SimpleMDE
▻https://simplemde.com
Un éditeur Markdown en javascript qui propose une vue « quasi » WYSIWYG tout en gardant le code des raccourcis syntaxiques visible. Le concept mi-chèvre mi-choux semble pertinent pour les débutants comme pour les « power-users »
Le dépôt Github : ▻https://github.com/sparksuite/simplemde-markdown-editor
#éditeur #WYSIWYG #javascript #markdown #SPIP
Il y a 3 ans… avec détails et roadmap des choses à faire dans l’ordre :
►https://core.spip.net/issues/3720
« Ce site est hébergé par Write.as. Certains et certaines l’auront peut-être remarqué. L’occasion pour moi de dire quelques mots de ce service de publication sur le Web atypique au concept plutôt original qui combine minimalisme éditorial, respect de l’anonymat (et même droit aux identités multiples), développement open source, et intégration à la fédiverse. »
▻https://aris.papatheodorou.net/write-as-cest-comme-ca (par @aris )
Notez qu’on peut faire à peu près la même chose avec SeenThis. La différence n’est pas trop dans la technique mais plutôt dans le fait que SeenThis est surtout utilisé pour signaler des trucs qu’on a vu (articles…), alors que Write.as semble plutôt utilisé pour publier des textes originaux.
@BigGrizzly Euh ? Moi, je n’ai rien vu de tel, et @aris non plus, il aurait râlé. L’examen du code source ne montre rien de googlesque. C’est pas une politique locale de ton navigateur, plutôt ?
Alors, rien vu sur writefreely, en effet, mais c’est lorsque je suis allé voir comment s’inscrire sur write.as que j’ai trouvé ça :
▻https://write.as/new/blog
@BigGrizzly Ah, à la création du compte ? Alors, là, je n’ai pas fait attention mais il y avait un CAPTCHA en effet. Je croyais qu’on parlait du simple lecteur.
@BigGrizzly @stephane
De mémoire, le captcha Google ne me dit rien... Je pense que c’est juste présent pour la création de blogs par les comptes gratuits
Avec Write.as/Write Freely tu peux suivre un blog depuis Mastondon, mais tu peux aussi partager directement un article en collant son URL dans le champs de recherche... Comme on peut le faire avec n’importe quel pouet...
Pros and Cons of Using #markdown for Technical Writing
▻https://hackernoon.com/pros-and-cons-of-using-markdown-for-technical-writing-34f277418a8a?sourc
Many technical writers either currently use or interested in using Markdown to write their technical documentation. It’s a bit like Marmite — some people love it and other people kind of hate it.Markdown generates some controversy, but it still proves incredibly useful in certain contexts. In this post, we’ll discuss exactly what Markdown is, and whether it’s appropriate for your documentation project.Definition of MarkdownJohn Gruber is the original creator of Markdown, and he defines it as:“Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).”Gruber’s definition shows that Markdown intended for anyone producing content on the web — which nowadays (...)
#editor #technical-documentation #technical-writing #markdown-tech-writing
markdown/README.md at master · Cerdic/markdown · GitHub
▻https://github.com/Cerdic/markdown/blob/master/README.md
Ce plugin permet d’utiliser la syntaxe MarkDown dans un article SPIP.
Un formulaire de configuration permet de choisir le fonctionnement du plugin :
- Appliquer la syntaxe SPIP par défaut et la syntaxe MarkDown dans les blocs <md>..</md>
- Appliquer la syntaxe MarkDown par défaut et la syntaxe SPIP dans les blocs <spip>..</spip>
Mark Text
▻https://marktext.github.io/website
Mark Text is a Markdown editor for Mac, Windows, and Linux. It is a concise text editor, dedicated to improving your editing efficiency.
Mark Text supports both the CommonMark Spec and the GitHub Flavored Markdown Spec. Because Mark Text is a realtime preview editor text styles and formatting update automatically as you type.
Ouh là comment cela a l’air vraiment trop bien cette affaire. Il faudrait que je trouve un peu de temps pour le tester un peu sur la longueur (textes longs et foisonnants). Un jour. Je mets de côté donc.
Moi aussi je n’ai pas encore teste. En fait j’utilise Typora qui est vraiment très bien, mais qui n’est pas libre...
@aris Et moi j’utilise Word (comme traitement de texte) qui n’est pas hyper libre non plus ! Un jour.
Eh bé, encore et encore un… (suivre le tag markdown). Ça a l’air cool que ce soit en wysiwyg (souvent ya deux panneaux). Même si en electron donc possiblement un peu lent à la détente suivant les ordis. À tester
Mermaid: Markdown-like generation of diagrams and flowcharts from t...
▻https://diasp.eu/p/7050566
Mermaid: Markdown-like generation of diagrams and flowcharts from text
HN link: ▻https://news.ycombinator.com/item?id=16889181 Posted by tomcam (karma: 3764) Post stats: Points: 106 - Comments: 18 - 2018-04-20T23:43:04Z
#HackerNews #and #diagrams #flowcharts #from #generation #markdown-like #mermaid #text HackerNewsBot debug: Calculated post rank: 76 - Loop: 64 - Rank min: 60 - Author rank: 26
Joplin - an open source note taking and to-do application with synchronisation capabilities
▻https://joplin.cozic.net
Joplin is a free, open source note taking and to-do application, which can handle a large number of notes organised into notebooks. The notes are searchable, can be copied, tagged and modified either from the applications directly or from your own text editor. The notes are in #Markdown format.
#notes #écrire #open_source #outils
Ah je regardais si ça pouvait être chiffré parce que moi j’avais commencé à utiliser Skrifa que tu avais seené aussi @monolecte, justement parce que ça pouvait être chiffré (ce qui permet de copier le numéro de ma carte bleue, ou ce genre d’info).
Apparemment il semblerait qu’on puisse aussi là, tout en ayant un stockage où on veut (alors que Skrifa que en local je crois) :
▻https://joplin.cozic.net/e2ee
Après test : ça permet effectivement de chiffrer les données stockées, et donc ça concerne le stockage local ou l’envoi sur un stockage distant.
MAIS, par contre, ça enregistre la clé de chiffrement dans le logiciel ou un truc dans le genre, ce qui fait que quand on ouvre le logiciel sur la machine où c’est installé : tout est directement lisible ! Ça ne demande pas à retaper le code ! (Ce que fait Skrifa à chaque démarrage.)
Du coup pas super quand ya des infos sensibles ou persos dedans… :(
Je ne retrouve plus le fil sur les #éditeurs de #notes si possible en #markdown.
En voilà un autre dont personne n’a l’air d’avoir parlé ici, #encrypté, bien sûr : #Skrifa
▻https://skrifa.xyz
The vanilla Skrifa, is all about keeping your privacy safe. With encryption to all of your notes by default using PGP, secure sharing of your notes and other PGP functionalities, this is the best note taking app for you and your privacy.
Dans la lignée de #Standard_notes
ah ouais ça a l’air cool
C’est un peu long chiffré, pour chaque action d’ouverture, sauvegarde, etc. Mais sinon ça a l’air de bien marché. Faut pas avoir à passer super souvent d’une note à une autre en permanence sinon c’est un peu chiant. Ou alors faut prendre la version sans chiffrage, qui est très rapide.
Un peu relou sur Ubuntu, je ne me souvenais plus du nom, et il n’y aucune méta-données associées au logiciel. Du coup quand dans le menu tu tapes « notes » ou « write » ou ce genre, tu ne trouves rien, il ne sort jamais. J’ai dû repasser par Seenthis pour retrouver ton seen, afin de rouvrir mes notes… :D
JAMstack | JavaScript, APIs, and Markup
▻https://jamstack.org
JAMstack: noun \’jam-stak’\
Modern web development architecture based on client-side JavaScript, reusable APIs, and prebuilt Markup.
When we talk about “The Stack,” we no longer talk about operating systems, specific web servers, backend programming languages, or databases.
The JAMstack is not about specific technologies. It’s a new way of building websites and apps that delivers better performance, higher security, lower cost of scaling, and a better developer experience.
Using A Static Site Generator At Scale: Lessons Learned – Smashing Magazine
▻https://www.smashingmagazine.com/2016/08/using-a-static-site-generator-at-scale-lessons-learned
Static site generators are pretty en vogue nowadays. It is as if developers around the world are suddenly realizing that, for most websites, a simple build process is easy enough to render the last 20 years of content management systems useless. All right, that’s a bit over the top. But for the average website without many moving parts, it’s pretty close!
What is a Headless CMS? | CSS-Tricks
▻https://css-tricks.com/what-is-a-headless-cms
Have you heard this term going around? It’s quite in vogue. It’s very related to The Big Conversation™ on the web the last many years. How are we going to handle bringing Our Stuff™ all these different devices/screens/inputs.
Responsive design says “let’s let our design and media accommodate as much variation in screens as possible.”
Progressive enhancement says “let’s make the functionality of this site work no matter what.”
Designing for accessibility says “let’s ensure everyone can use this regardless of their capabilities as a person.”
A headless CMS says “let’s not tie our data to any one way of doing things.”
Documentation generator for shell scripts (bash, sh, zsh) ▻https://github.com/reconquest/shdoc
A command-line based markdown presentation tool.
►https://github.com/visit1985/mdp
mdp, A command-line based #Markdown presentation tool.
Vega / Vega-Lite
Introducting Vega Lite
▻https://medium.com/hci-design-at-uw/introducing-vega-lite-438f9215f09e
▻http://idl.cs.washington.edu/files/2017-VegaLite-InfoVis.pdf
Visdown (taper du vega en #markdown + #yaml)
▻http://visdown.amitkaps.com
The Lyra Visualization Design Environment (VDE) ►http://idl.cs.washington.edu/projects/lyra
What I Learned Recreating One Chart Using 24 Tools - Features - Source : An OpenNews project
▻https://source.opennews.org/en-US/articles/what-i-learned-recreating-one-chart-using-24-tools
Vega Editor
▻http://vega.github.io/vega-editor/index.html?mode=vega&spec=force_drag
Exemple de specs
▻https://github.com/vega/vega/blob/master/spec/airports.vg.json
Roll your own charting system
▻https://blog.interactivethings.com/roll-your-own-charting-system-69f5753efc1c
Users mailing list
▻https://groups.google.com/forum/#!topic/vega-js/9EDKEFEZ8Zo
Interaction scenarios
▻https://github.com/vega/vega/wiki/Interaction-Scenarios
un block test
▻http://bl.ocks.org/espinielli/87047968c67c02dbcb8d
vega-lite et #R
▻http://rud.is/b/2016/02/27/create-vega-lite-specs-widgets-with-the-vegalite-package
–---
gganimate : animation avec ggplot2
▻https://www.youtube.com/watch?v=9Y7Y1s4-VdA
#Ghostwriter, an #Open-Source #Markdown Editor - OMG! Ubuntu!
▻http://www.omgubuntu.co.uk/2016/12/ghostwriter-stylish-open-source-markdown-editor
Ghostwriter is a free, open-source markdown editor for Linux and Windows.
Billed as being ‘distraction free’, the Qt based app doesn’t scrimp on features at the expense of looking minimal and stylish.
Pense bête #markdown · jekyll-fr/jekyll-fr.github.io Wiki
▻https://github.com/jekyll-fr/jekyll-fr.github.io/wiki/Pense-b%C3%AAte-Markdown
#cheatsheet
bookdown: Authoring Books with #R Markdown
▻https://bookdown.org/yihui/bookdown
The bookdown package was built on top of R Markdown (▻http://rmarkdown.rstudio.com), and inherited the simplicity of the #Markdown syntax (you can learn the basics in five minutes; see Section 2.1), as well as the possibility of multiple types of output formats (PDF/HTML/Word/…). It also added features like multi-page HTML output, numbering and cross-referencing figures/tables/sections/equations, inserting parts/appendices, and imported the GitBook style (►https://www.gitbook.com) to create elegant and appealing HTML book pages. This book itself is an example of how you can produce a book from a series of R Markdown documents, and both the printed version and the online version can look professional.
Stylish #Markdown Editor ’Typora’ Is Now Available for Ubuntu - OMG ! Ubuntu !
▻http://www.omgubuntu.co.uk/2016/09/typora-stylish-minimal-markdown-editor-now-available-ubuntu
Typora is both a reader and a writer at the same time. There’s no preview window to toggle on, no on-screen toolbar of formatting buttons, and you won’t see any markdown elements as you write.
Là, pour l’instant, il enfonce les autres pour sa simplicité d’usage quand on a besoin de taper au kilomètre. Je vais le rajouter à la liste des éditeurs.
Pour l’instant, c’est en bêta, ensuite, vu que le gars vient de l’écosystème Apple, ça devrait être vachement moins free et open…
@monolecte Oui j’utilise ce tag pour les logiciels qui sont en apparence libre ou jouent sur l’ambiguïté (dépôt Github, utilisation du mot « free ») mais qui se révèlent, après examen, privateurs. Ce n’est pas un jugement sur leur qualité.
Ici typiquement le dépôt Github ne contient pas les sources du logiciels mais des thèmes applicables au logiciel ▻https://github.com/typora. Et le mot free est utilisé au sens de gratuit, pas au sens de libre : « Free during beta » (en pied de page). En plus le logiciel a été porté sur linux et l’article est publié sur omgubuntu. Bref tout pour se faire passer pour un logiciel libre.
L’expression « Free as in free beer » est de Richard Stallman. Conscient de l’ambiguïté du mot en anglais il dit quelque chose du genre « Free as in free speech not free as in free beer » ▻https://www.gnu.org/philosophy/free-sw.en.html
Pour MacOS il y a ce logiciel libre d’édition markdown etc : ►http://macdown.uranusjr.com
Atom
►https://atom.io
Un éditeur de texte évolué, open-source, cross-platforms, avec un ensemble de plugins (packages) bien fournis et un système de snippets qui semble pratique...
La doc officielle : ▻http://flight-manual.atom.io
(dommage : pas de possibilité de traduction du core ou des packages : cf ▻https://github.com/atom/atom/issues/3103)
Package pour le Markdown : ▻https://atom.io/packages/markdown-writer
NB pour contourner l’installation sous Windows dans le AppData de l’utilisateur sans donner le choix (ce qui est bien naze pour un open-source !) :
– une fois l’installation terminée, déplacer le dossier c :\users\nom_utilisateur\AppData\atom vers l’endroit voulu
– modifier les chemins des raccourcis (menu Démarrer, bureau...)
– ajouter le chemin du dossier atom dans le PATH
Traitement de texte multicanal - Frank Taillandier
▻http://frank.taillandier.me/2016/08/28/traitement-de-texte-multicanal
Comme je l’expliquais dans la mouvance statique, il est important de bien choisir le format de fichier dans lesquels nous allons stocker nos écrits. C’est souvent la solution la plus simple qui est aussi la plus efficace : du texte brut mise en forme à l’aide d’une syntaxe elle aussi en #texte brut. #Markdown est de ce fait un format de fichier de plus en plus populaire car il assure une pérennité et une compatibilité à nos documents, tout en préservant une mise en forme au format texte. Markdown est le format par défaut des contenus dans la plupart des générateurs de site statique et il devrait devenir aussi le format par défaut dans lequel vous rédigez vos notes, vos rapports, vos articles de blog ou vos livres.