Chargé de communication chez Framasoft, j’ai voulu aborder Duniter et la G1 en étant le plus ingénu possible afin de donner des retours pour faciliter la présentation de la monnaie et des concepts qui la sous-tendent.
La licence y est présente d’emblée, ce qui est une excellente chose.
Par contre, elle est présentée comme les autres licences (iTunes, Google et consorts) : dans un cadre “bloc notes”, sans retour à la ligne, lecture avec des ascenseurs…
Or mon réflexe instinctif (éduqué par quelques années de “oui-c’est-bon-j’accepte-vos-conditions-générales”), c’est de surtout ne pas lire les licences présentées ainsi… D’habitude, c’est un texte imbittable qui de toutes façons va m’arnaquer mais que j’ai pas le choix, donc je veux surtout pas le lire (je schématise l’impression, hein ^^).
Le texte de la licence, justement, est très joliement formulé : il fait sérieux et humain à la fois.
Du coup, je propose qu’on le mette en page autrement, a minima avec les CSS usuelles du wiki, voire dans un cadre de type panel ou jumbotron… (il me semble qu’on est sur du Bootstrap ?)
Je pense que c’est une très bonne idée Le format texte est utile pour l’avoir le plus brut possible, mais l’affichage joliement (dans une page dédiée à la limite) ça serait très bien !
En fait, j’ai produit la licence sous ce format car j’avais 3 contraintes :
pouvoir afficher la licence
pouvoir télécharger la licence
pouvoir modifier la licence à un endroit, et que cela se répercute sur 1. et 2. automatiquement
Alors j’ai mis le fichier de licence dans les sources téléchargeables, et puis je cale ce même fichier dans une iframe pour l’affichage, et donne un lien pour le téléchargement. Mais c’est vrai que esthétiquement, c’est rebutant. Même nous pour la modifier, on ne sait pas où aller ! (contrairement à toutes les pages du site qui ont un bouton « Modifier cette page »).
Je vais tenter une autre approche demain, sans casser les URL.
Je comprends très bien ta problématique et que ce soit fait comme ça, du coup, et merci d’entendre le retour et d’en tenir compte
Je n’ai pas de connaissances techniques poussées, mais si je peux aider d’une manière ou d’une autre, n’hésite surtout pas à me pinguer (j’aime pas faire de yakafokon sans mettre la main à la pâte).
On peut imaginer un bon vieux replace en python d’un tag ##LICENCE## par le fichier avant que Pelican se déclenche, vu que Pélican lui-même ne gère pas les includes de texte brut.
La suggestion de @Pouhiou d’un jumbotron est bonne à tester je pense !
Je préparerai dans le train tout à l’heure le replace.py qui fait ça !
Ce n’est pas du Markdown, mais du reStructuredText (RST) ! Je préfère ce format quand il s’agit de lecture du format brut pour humains, par rapport au markdown.
Tous les autres articles sont en markdown par contre, vu que la lecture se fait après transformation par Pelican, et donc que le format Markdown importe peu : à la fin, la lecture se fait en HTML.
@florck : sais-tu déjà où je dois placer ton fichier pour qu’il soit exécuté par Pelican ?
Non, je pensais ajouter dans le README.md qu’il faut le jouer régulièrement à la main, idéalement avant chaque build.
Je vais quand même regarder pelican pour voir s’ils ont possibilité d’ajouter des custom pre-hooks.
Pour le moment il n’y a pas de CI/CD sur le blog ?
2 points qui restent à traiter avant de l’accepter si l’approche convient :
Je pense qu’on aurait intéret à wrapper les lignes dans la licence pour ne pas dépasser les 80 caractères par ligne. Globalement pour la lecture du fichier brut cela ne nuirait pas, et sur le site, ça permettrait d’éviter le slider horizontal
Je n’ai pas trouvé où modifier la cd pour lancer le script replace.py avant chaque exécution.
Une fois incluse dans une page du site de façon classique, il n’y a plus aucun slider nulle part, sauf pour les textes de code (au sein de balises ```code ``` ou >). Donc ça ne devrait pas poser de problème.
Oui je n’avais pas mis le script dans les sources.
Je vais faire tout cela soit cet après-midi, soit demain.
Ok ! De mon côté j’avais mise entre 3 backquotes, c’est pour ça…
Je vais essayer de l’inclure sans backquotes, et du coup, si nécessaire, convertir le Restructured en Markdown et trouver comment bien mettre en valeur.
Tu veux modifier le contenu du fichier de licence téléchargé ? Ou bien modifier le contenu à la volée, pour qu’il soit inclus en markdown dans la page de licence ?
Si c’est ce dernier point, on peut tout aussi bien avoir la page web de licence écrite en RST à la place du markdown. On fait comme on veut pour chaque page du site.