Bidouille est un thème didactique pour Pelican

Bidouiller: bricoler, trafiquer, arranger…

Le thème bidouille est créé dans l'idée de le rendre didactique pour parcourir un ensemble d'éléments qui rentrent en compte dans la création d'un site Internet constitué

• de pages web statiques² (des fichiers HTML, du texte, quelques images, quelques fichiers à télécharger), peut-être une vidéo ou l'autre, pourquoi pas un iframe (mais c'est un appel vers un autre site) avec un agenda, etc.
• sans CDN, gogol fonts, jsdelivery ou autres appels à des ressources externes au domaine (expliquer avec uMatrix?). c'est dans le respect de l'intimité numérique de chaque visiteur ou visiteuse.

Ce n'est pas un didacticiel pour découvrir le fonctionnement de gestionnaires de contenus qui nécessitent un moteur de base de données. Nous travaillerons uniquement avec des fichiers en texte brut³.

Malgré les apparences, ce projet suit le Principe K.I.S.S¹ et vous propose d'explorer ce qui fait d'une page web ce qu'elle est. Peut-être aussi de vous permettre d'en créer vous même.

Tout le contenu de ce site est encore brouillon (mars 2024)

Avant de bidouiller

• revisiter le terminal
• revisiter un explorateur de fichiers
• revisiter un éditeur de texte brute
• revisiter un navigateur web comme Firefox
• installer virtualenv (activer / désactiver)
• installer Pelican

Soit…

• créer un premier site avec pelican-quickstart dedans
• démarrer le serveur web de Pelican pour voir le(s) résultat(s) quand vous voulez
• télécharger le contenu de demo de le dossier du site
• télécharger les quelques thèmes dans le dossier du site
• télécharger quelques thèmes avec des appels externes

Ou bien…

• télécharger tout demo ?

Pour…

• tester le site avec l'un ou l'autre thème respectueux

Et…

• installer uMatrix
• tester le site avec l'un ou l'autre thème moins respectueux

Ensuite… pour bidouiller le contenu

• expliquer un peu le pelicanconf.py
• voir on ont été écrites les réponses données lors du quickinstall (titre, auteur,… )
• définir les dossiers statiques pour fichiers et images
• définir le thème bidouille dans le pelicanconf.py
• faire une page index
• parler du markdown
• faire une catégorie et quelques articles
• parler des variables dans les fichiers md (titre, date, status, …)
• les images
• les fichiers téléchargeables
• les liens internes, externes, pour les images, pour les fichiers (attentions aux changements + rappel search/replace dans les éditeurs)

Pour bidouiller le thème

• utiliser le navigateur pour afficher les sources html
• expliquer les éléments de base utilisés head, body, article,…
• tester le mode smartbidule et en sortir
• activer les outil de dev
• montrer le code et l'éditeur css
• montrer où est le bidouille.css

Pour aller plus loin…

• découvrir le css
• découvrir le html
• découvrir le jinja
• découvrir les polices de caractère
• découvrir forkawsome

Pour publier le résultat…

• Nom de domaine
• Hébergement
• make ftp_upload ou make rsync de Pelican et/ou expliquer Filezilla/Nemo/Thunar/lftp… aussi ?

Encore plus loin…

• Les plugins ?

Et quid de…

• faire des backups et y revenir ?
• expliquer comment changer de favicon

Comment présenter les choses

Pour chaque techno

• une brève explication
• les trucs de bases
• les trucs plus avancés (genre rechercher / remplacer dans un éditeur de texte)
• liens vers la documentation

Technologies utilisées

• les licences des logiciels et technologies utilisées ?
• ou juste lister les choses et pointer vers Wikipédia ou des pages locales ?

Pourquoi bidouille n'est pas dans la liste des thèmes Pelican ?

Parce qu'ils sont rassemblés sur Github® et que je n'y ait plus de compte depuis que Microsoft® a racheté la plateforme en 2018 et que je refuse leurs conditions générales d'utilisation.