Le journal

https://hackmd.io/oczkF6aEQdSSTGWlBav0qg#

Maquillage

Un thème Jekyll pour publier des contributions issues de l'éco-système Daktary.

Utiliser le thème

Contexte

J'ai des ressources markdown hébergées dans un dépôt Github et je souhaite les présenter au reste du monde en réduisant le bruit visuel.

Par exemple, je pourrais avoir un compte github : mezig
Et un dépôt : crenshaw qui contiendrait plein de fiches très inspirantes sur l'intersectionnalité.

Construire rapidement un site avec le thème maquillage

Créer un fichier _config.yml en insérant la ligne :

remote_theme: daktary-team/maquillage

Pour que mon site soit accessible en ligne, je dois activer github-pages.

Dans settings :

Je sélectionne la branche master et je clique sur save

En reprennant l'exemple proposé, après quelques secondes, mes contributions deviennent consultables à l'adresse : mezig.github.io/crenshaw

Pour fignoler un peu

Je peux rajouter la personalisation des erreurs 404 en ajoutant un fichier 404.html avec à l'intérieur :

---
permalink: /404.html
layout: 404
---

FAQ

Pourquoi c'est sur Github et pas sur une plateforme libre ?

On a commencé là en se disant que ce serait facile à migrer. Bientôt on passera sur gitlab.com.

Pourquoi je dois faire des trucs techniques comme créer des fichiers yaml ?

Avec coup de pinceau ça se passera en un clic. On y travaille tranquillement.

Et si je galère, je fais comment ?

Plein de solutions s'offrent à toi, parmi lesquelles :

• on pourrait organiser un walkingdev.com
• tu peux contacter Stéphane
• on pourrait programmer une exploration collective un peu comme un devopensud.fr

**Et la suite, c'est quoi ?

on utilise la grainerie pour prioriser nos idées.

Quelques explications sur le "projet"

À quoi on aspire ?

Présenter convenablement des ressources markdown en renseignant un fichier de configuration minimaliste.

Qui seraient intéressé·e·s ?

• Pour les utilisat·eur·rice·s de multibao.
• Pour les petit·e·s blogueu·r·se·s.
• Pour les collectifs sensibles aux pratiques collaboratives.

Pour quoi faire ?

• Pour associer mes contributions à ma personne ou à mon collectif.
• Pour montrer à mes proches la facilité de mise en œuvre d'une gestion de documentation collaborative.
• Pour me débarrasser de mon ancien outil sans trop sacrifier la présentation.

Ce serait une expérience réussie, si...

• Si après avoir installé le produit, Bénédicte décide de remplir les métas de 50% de ses fiches
• Si cinq contribut·eur·rice·s décident d'accepter des PR pour installer la solution.
• Si on utilise ce thème pour coup-de-pinceau

Pour aller plus loin techniquement

Pour tester ce thème en local, lancer bundle exec jekyll serve dans un terminal.

Installation dans un site Jekyll

Pour utiliser ce thème dans un site utilisant Jekyll, vous pouvez ajouter cette ligne dans votre fichier Gemfile:

gem "maquillage"

Et ajouter la ligne suivante _config.yml:

theme: maquillage

Puis exécuter :

bundle

Ou bien, installer par vous même :

gem install maquillage

License

CC0-1.0