« 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.
doctoc: generate table of content for markdown files
▻https://github.com/thlorenz/doctoc
Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github or other sites.
ParvulaCMS
▻https://github.com/ParvulaCMS/parvula
#PHP, config en #yaml, pages en #markdown #sans_base_de_données ...
Je viens de l’installer sur mon ordi, mais ça m’embête un peu le markdown. Je préfèrerais pouvoir gérer direct le html en ce qui me concerne ;-)
Je me dis que si j’ai le temps, je vais configurer un CMS pour qu’il puisse être réutilisable sur différents projets. Il suffirait d’ajouter les briques nécessaires à chaque fois, plutôt que toujours repartir de zéro et faire des maquettes purement statiques
Si je comprends en regardant un peu mieux, c’est la partie themes qu’il faut configurer, pour avoir des choses déjà préfaites et à partir de là, on s’embête beaucoup moins
À noter que Kirby (un CMS n’utilisant pas une base de données mais des fichiers #Markdown) n’est pas du logiciel libre.
ah oui bien vu — les sources sont disponibles mais pas libres
You can try Kirby on your local machine as long as you want and the source is available on Github. But as soon as you want to use Kirby in production, you must purchase a license.
Utiliser #pandoc pour écrire une lettre en #markdown
▻http://namok.be/blog/?post/2016/03/25/pandoc-lettre-markdown
Pour écrire une lettre, on peut utiliser un traitement de texte si l’on veut. Par contre, si l’on a l’habitude d’écrire avec un éditeur de texte, que l’on aime écrire en markdown et que pandoc est déjà installé sur la machine, voici une alternative.
Je veux pouvoir écrire une lettre très rapidement en ouvrant un éditeur de texte et en y mettant quelque chose à l’allure suivante :
author : François Pignon from : - Passerelle des champions du monde, 1 - 1000 Bruxelles - fpignon@example.org to : - Éditions ACME - Pierre Brochan - Ruelle incroyable, 112 - 1000 Bien bien loin object : L’objet de ma lettre vref : Vos références mref : Mes références opening : Monsieur, closing : Salutem dicit
L’incroyable contenu de ma lettre.
Les parties de ma lettre sont clairement identifiées (et facultatives). Elles (...)
Les #RFC sur le format de balisage #Markdown sont sortis : RFC 7763 « The text/markdown Media Type » <▻http://www.bortzmeyer.org/7763.html> et RFC 7764 « Guidance on Markdown : Design Philosophies, Stability Strategies, and Select Registrations » <▻http://www.bortzmeyer.org/7764.html>
À quand un mécanisme pour écrire ses articles SeenThis en Markdown ? :-)
bah seenthis a volontairement très peu de mises en forme possible (et même au départ @arno voulait pas non plus l’italique et gras), au départ il devait juste y avoir citation/pas citation
par contre pour SPIP ça existe :)
►https://github.com/Cerdic/markdown
Un point qui me parait important : les variantes (c’est bien d’avoir un moyen standard et officiel de le préciser).
Le plus important est sans doute variant qui désigne le dialecte Markdown particulier utilisé. Ce fut l’une des plus chaudes discussions à l’IETF avant la sortie de ce RFC. Notamment, fallait-il un registre IANA des variantes (une sorte de catalogue des dialectes) ou bien laisser les auteurs mettre ce qu’ils veulent, ce qui correspondait mieux au côté très peu organisé de la « communauté » Markdown, très informelle ? (Différentes versions du draft qui a mené à ce RFC faisaient des choix différents.) Le paramètre variant a finalement un registre (section 6.1) mais l’émetteur n’est pas obligé de se limiter aux valeurs de ce registre. Il faut considérer la valeur de ce paramètre comme une simple indication. Parmi les valeurs actuellement enregistrées : Original (le Markdown des débuts, celui de Gruber), GFM (celui de GitHub), pandoc (celui de ce logiciel), CommonMark (le candidat à la normalisation) etc.