Exile on Keyboard St. - Blog sur Linux et Debian

Aller au contenu | Aller au menu | Aller à la recherche

jeudi 21 juin 2018

Le Festival Pas Sage en Seine arrive bientôt

Le Festival Pas Sage en Seine aura lieu du 28 Juin au 1er Juillet prochain.

Pas Sage en Seine est un évènement qui organise un ensemble de conférences dans le domaine du numérique, de l’activisme et de la protection de la vie privée. Il a lieu en région parisienne, à Choisy-le-roi.

J'ai repéré pour vous une petite sélection de conférences qui m'intéressent et qui vous intéresserons peut-être aussi:

Jeudi 28 Juin

  • 11:00 -> 11:55 - Architecture Zero Knowledge et Webapps : est-ce possible ?
  • 13:00 -> 13:55 - Full-remote : guide de survie en environnement distant
  • 15:00 -> 15:55 - Du pseudonymat au pseudonyme, retour d’expérience

Vendredi 29 Juin

  • 10:00 -> 10:55 - Privacy by design
  • 12:00 -> 12:55 - Vos traces, dans la pratique
  • 13:00 -> 13:55 - L’autohebergement c’est trop bien
  • 14:00 -> 14:55 - L’idiot du village g00gle
  • 16:00 -> 16:55 - Un panda roux peut-il avoir une vie privée ?
  • 18:00 -> 18:55 - Modéliser le contrôle des utilisateurs sur leurs données personnelles

Samedi 30 Juin

  • 12:00 -> 12:55 - Installation et prise en main de ZeroNet
  • 13:00 -> 13:55 - Qualité logicielle et dette technique : quand et comment doit-on s’en préoccuper ?
  • 15:00 -> 15:55 - Le café, le marc et ses usages
  • 18:00 -> 18:55 - L’impact spatial et énergétique des data-centers
  • 19:00 -> 19:55 - Petite histoire de la surveillance, ou comment en sommes-nous arrivé·es là ?

Si vous ne pouvez pas vous rendre à l'édition 2018 de Pas Sage en Seine, vous pouvez regarder le streaming depuis chez vous ou visionner les enregistrements vidéos de l'édition 2017.

samedi 24 décembre 2016

Vérifier la syntaxe des fichiers Markdown avec markdownlint

Les fichiers README des projets open source (ou non) sont maintenant (presque) toujours écrits avec le langage de balisage Markdown qu'on ne présente plus.

Après avoir trouvé un éditeur pour les fichiers Markdown et cherché comment convertir un document Markdown en HTML je me suis demandé comment vérifier les erreurs de syntaxe dans les fichiers README.

Il y a énormément d'éditeurs de Markdown en ligne, par contre les outils de vérification de syntaxe ne sont pas très nombreux. J'en ai quand même trouvé un sur GitHub.

Il s'agit de markdownlint disponible à l'adresse suivante: markdownlint.

markdownlint étant écrit en Ruby, il faut procéder comme suit pour l'installer:

sudo apt-get install rubygems
sudo gem install mdl

La vérification d'un fichier README se fait alors avec la commande mdl:

mdl README.md

Et on obtient les erreurs suivantes, par exemple:

README.md:291: MD013 Line length
README.md:19: MD012 Multiple consecutive blank lines
README.md:187: MD009 Trailing spaces
README.md:223: MD014 Dollar signs used before commands without showing output
README.md:15: MD034 Bare URL used

La première erreur MD013 vérifiant que les lignes n'excèdent pas 80 caractères est à mon avis discutable pour un fichier README.

Pour exclure cette règle, on peut procéder comme suit:

mdl -r ~MD013 README.md 

Ceci étant dit, il est facile d'inclure un appel à la commande mdl dans un processus de build logiciel ou d'intégration continue afin de vérifier la non transgression d'un certain nombre de règles.

Afin d'approfondir le sujet, ci-joint l'aide de la commande mdl:

mdl --help
Usage: mdl [options] [FILE.md|DIR ...]
    -c, --config FILE                The configuration file to use
    -g, --git-recurse                Only process files known to git when given a directory
    -i, --[no-]ignore-front-matter   Ignore YAML front matter
    -l, --list-rules                 Don't process any files, just list enabled rules
    -r, --rules RULE1,RULE2          Only process these rules
    -u, --rulesets RULESET1,RULESET2 Specify additional ruleset files to load
    -a, --[no-]show-aliases          Show rule alias instead of rule ID when viewing rules
    -w, --[no-]warnings              Show kramdown warnings
    -d, --skip-default-ruleset       Don't load the default markdownlint ruleset
    -s, --style STYLE                Load the given style
    -t, --tags TAG1,TAG2             Only process rules with these tags
    -v, --[no-]verbose               Increase verbosity
    -h, --help                       Show this message
    -V, --version                    Show version

mercredi 31 août 2016

Remarkable, un éditeur de Markdown très chouette pour Linux

On ne présente plus le langage de balisage Markdown qui est très utilisé dans les projets open source pour rédiger les fichiers README ou même de la documentation.

Mais la syntaxe de Markdown a beau être simple, on préfère quand même vérifier ce que l'on tape. Il nous faut un éditeur WYSIWYG (What You See Is What You Get), c'est à dire disposant de la fonctionnalité Live Preview: Etre obligé d'exporter le document périodiquement en HTML ou PDF n'est pas tenable.

J'ai découvert récemment un éditeur open source, écrit en Python, et fonctionnant sous Linux. Il s’appelle Remarkable et dispose (entre autres) des fonctionnalités suivantes:

  • Gestion du Markdown de GitHub
  • Coloration syntaxique
  • Export en PDF et HTML
  • Live Preview
  • CSS personnalisé
  • Différents thèmes pour le Live Preview et l'Export
  • Barre d'outils pour la mise en italique, gras, ...

Remarkable s'installe facilement, il est écrit en Python et vous aurez donc besoin d'installer quelques paquets relatifs à Python avant de pouvoir l'installer.

Vous trouverez le projet Remarkable sur GitHub.

Je lui ai néanmoins trouvé un petit défaut, c'est que la synchronisation des vues Edtion et Preview semble dysfonctionner par moments. Le site parle de synchronized scrolling, je suis un peu sceptique ... Cela étant dit, c'est le meilleur éditeur de Markdown que j'ai trouvé jusque là pour Linux, et ce n'est pas le premier que j'installe.

Je vous invite donc à l'essayer !

- page 1 de 2