refonte des cahiers pour mise à jour complète #6

Closed
opened 2 years ago by arpinux · 1 comments
arpinux commented 2 years ago
Owner

je prévois une refonte des cahiers :

  • mise à jour complète des images et organisation en sous-dossiers
  • relecture du texte et correction
  • mise à jour de la méthode de construction (reporté)
  • mise en place d'une page d'accueil pour la version html standalone qui servira de version en-ligne "officielle"
  • mise en place d'un guide des contributions pour préciser :
    • la syntaxe Markdown : comment ajouter du code, pourquoi ne pas faire des lignes de 300 caractères, pourquoi respecter la hiérarchie des sections...
    • la taille et la qualité des images pouvant être ajoutées,
    • les principes de construction de la version PDF : sauts de page, choix des illustrations, choix des lignes vides pour permettre une mise en page cohérente pour le lecteur...
    • les principes des version ePub et html : feuille de style css, balises html...
    • les principes de conversion pandoc
    • comment tester et vérifier chaque format après une modification...

je vais attaquer ça tranquille dès maintenant en installant des versions par défaut de Debian buster pour chaque bureau...

je prévois une refonte des cahiers : - [x] mise à jour complète des images et organisation en sous-dossiers - [x] relecture du texte et correction - mise à jour de la méthode de construction (reporté) - [x] mise en place d'une page d'accueil pour la version html standalone qui servira de version en-ligne "officielle" - [x] mise en place d'un guide des contributions pour préciser : - la syntaxe Markdown : comment ajouter du code, pourquoi ne pas faire des lignes de 300 caractères, pourquoi respecter la hiérarchie des sections... - la taille et la qualité des images pouvant être ajoutées, - les principes de construction de la version PDF : sauts de page, choix des illustrations, choix des lignes vides pour permettre une mise en page cohérente pour le lecteur... - les principes des version ePub et html : feuille de style css, balises html... - les principes de conversion pandoc - comment tester et vérifier chaque format après une modification... je vais attaquer ça tranquille dès maintenant en installant des versions par défaut de Debian buster pour chaque bureau...
arpinux self-assigned this 2 years ago
Poster
Owner

précision sur la méthodologie développée pour cette refonte

le pourquoi du "je taf dans mon coin comme un ermite"... :

  • installation des versions Debian Buster par défaut : un VBOX pour chaque session (Gnome, KDE, XFCE, Cinnamon, Mate, LXDE, LXQt) afin d'avoir des sessions témoins des environnements par défaut
  • mise en place des sous-dossiers pour les images et suppression des images obsolètes
  • relecture rapide des cahiers, identification des images et shots en continu pour collecter les images nécessaires à la rédaction des cahiers. cette phase sert aussi de première vérification des procédures expliquées dans les cahiers
  • traitement (900px width maxi, 96dpi) et classement des images dans des sous-dossiers correspondants à chaque chapitre
  • mise en place des nouvelles images dans les sources et dans le texte
  • relecture appuyée avec mise en page : il faut parfois "jouer" avec le texte pour faire passer une image d'une page à l'autre, offrir une mise en page propre sans trop de blancs...
  • vérification des informations : test de toutes les procédures indiquées dans les cahiers sur des sessions par défaut sans ajout ni configuration perso. au besoin, installation en dur (pas en VBOX) sur une machine de test (un vieil IBM T60 en 1024x768 fera l'affaire et a l'avantage d'avoir les mêmes caractéristiques qu'une VBOX de base pour les shots)
  • vérification de la structure d'ensemble : contrôler la cohérence des sections et l'enchainement des informations livrées. les cahiers doivent pouvoir être consultés en continu ou en piochant un chapitre si besoin.
  • relecture cosmétique pour les derniers détails (petits logos, smileys, identation des textes, cohérence graphique générale)
  • mise à jour de la méthode de construction (reporté)
  • rédaction de la page d'accueil de la version en ligne
  • rédaction du guide de contribution
  • relecture orthographique externe par des gentils humains (a déjà été relu 10 fois en 4 ans ... les derniers ajouts ont été minutieusement vérifiés)
  • corrections / modifications
  • dernière relecture générale orthographique et cosmétique
  • dernières corrections / modifications
  • publication ... et hop https://debian-facile.org/projets/lescahiersdudebutant/ merci @captnfab :)

oui, je suis un poil exigeant sur la qualité et la cohérence des cahiers, d'où cette méthodologie qui peut paraître contraignante... mais quand on veut offrir un produit correct, bah faut s'en donner les moyens ;)

ça vous donne un aperçu de ce que va être le "guide de contribution" :)

afin de permettre le suivi complet de la refonte, je tenterais de faire des git push aussi souvent que possible avec des messages explicatifs, mais pas pour chaque image :)

je me donne deux semaines avant la relecture externe... c'est parti :D

## précision sur la méthodologie développée pour cette refonte #### le pourquoi du "je taf dans mon coin comme un ermite"... : - [x] installation des versions Debian Buster par défaut : un VBOX pour chaque session (Gnome, KDE, XFCE, Cinnamon, Mate, LXDE, LXQt) afin d'avoir des sessions témoins des environnements par défaut - [x] mise en place des sous-dossiers pour les images et suppression des images obsolètes - [x] relecture rapide des cahiers, identification des images et shots en continu pour collecter les images nécessaires à la rédaction des cahiers. cette phase sert aussi de première vérification des procédures expliquées dans les cahiers - [x] traitement (900px width maxi, 96dpi) et classement des images dans des sous-dossiers correspondants à chaque chapitre - [x] mise en place des nouvelles images dans les sources et dans le texte - [x] relecture appuyée avec mise en page : il faut parfois "jouer" avec le texte pour faire passer une image d'une page à l'autre, offrir une mise en page propre sans trop de blancs... - [x] vérification des informations : test de toutes les procédures indiquées dans les cahiers sur des sessions par défaut sans ajout ni configuration perso. au besoin, installation en dur (pas en VBOX) sur une machine de test (un vieil IBM T60 en 1024x768 fera l'affaire et a l'avantage d'avoir les mêmes caractéristiques qu'une VBOX de base pour les shots) - [x] vérification de la structure d'ensemble : contrôler la cohérence des sections et l'enchainement des informations livrées. les cahiers doivent pouvoir être consultés en continu ou en piochant un chapitre si besoin. - [x] relecture cosmétique pour les derniers détails (petits logos, smileys, identation des textes, cohérence graphique générale) - mise à jour de la méthode de construction (reporté) - [x] rédaction de la page d'accueil de la version en ligne - [x] rédaction du guide de contribution - [x] relecture orthographique externe par des gentils humains (a déjà été relu 10 fois en 4 ans ... les derniers ajouts ont été minutieusement vérifiés) - [x] corrections / modifications - [x] dernière relecture générale orthographique et cosmétique - [x] dernières corrections / modifications - [x] publication ... et hop https://debian-facile.org/projets/lescahiersdudebutant/ merci @captnfab :) oui, je suis un poil exigeant sur la qualité et la cohérence des cahiers, d'où cette méthodologie qui peut paraître contraignante... mais quand on veut offrir un produit correct, bah faut s'en donner les moyens ;) ça vous donne un aperçu de ce que va être le "guide de contribution" :) afin de permettre le suivi complet de la refonte, je tenterais de faire des git push aussi souvent que possible avec des messages explicatifs, mais pas pour chaque image :) je me donne deux semaines avant la relecture externe... c'est parti :D
arpinux added the due date 2020-04-10 2 years ago
arpinux closed this issue 2 years ago
This repo is archived. You cannot comment on issues.
No Label
No Milestone
No Assignees
1 Participants
Due Date

2020-04-10

Blocks
#2 Version web des cahiers : pas de lien pour l'instant
ProjetsDF/lescahiersdudebutant---buster
Loading…
There is no content yet.