commit f6501517d569379e77d79fcd5c00a17855383834 Author: Pascal Le Merrer Date: Sat Dec 13 16:16:45 2025 +0100 First version diff --git a/.DS_Store b/.DS_Store new file mode 100644 index 0000000..fc23fd7 Binary files /dev/null and b/.DS_Store differ diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..202fa45 --- /dev/null +++ b/Makefile @@ -0,0 +1,75 @@ +PY?= +PELICAN?=pelican +PELICANOPTS= + +BASEDIR=$(CURDIR) +INPUTDIR=$(BASEDIR)/content +OUTPUTDIR=$(BASEDIR)/output +CONFFILE=$(BASEDIR)/pelicanconf.py +PUBLISHCONF=$(BASEDIR)/publishconf.py + + +DEBUG ?= 0 +ifeq ($(DEBUG), 1) + PELICANOPTS += -D +endif + +RELATIVE ?= 0 +ifeq ($(RELATIVE), 1) + PELICANOPTS += --relative-urls +endif + +SERVER ?= "0.0.0.0" + +PORT ?= 0 +ifneq ($(PORT), 0) + PELICANOPTS += -p $(PORT) +endif + + +help: + @echo 'Makefile for a pelican Web site ' + @echo ' ' + @echo 'Usage: ' + @echo ' make html (re)generate the web site ' + @echo ' make clean remove the generated files ' + @echo ' make regenerate regenerate files upon modification ' + @echo ' make publish generate using production settings ' + @echo ' make serve [PORT=8000] serve site at http://localhost:8000' + @echo ' make serve-global [SERVER=0.0.0.0] serve (as root) to $(SERVER):80 ' + @echo ' make devserver [PORT=8000] serve and regenerate together ' + @echo ' make devserver-global regenerate and serve on 0.0.0.0 ' + @echo ' ' + @echo 'Set the DEBUG variable to 1 to enable debugging, e.g. make DEBUG=1 html ' + @echo 'Set the RELATIVE variable to 1 to enable relative urls ' + @echo ' ' + +html: + "$(PELICAN)" "$(INPUTDIR)" -o "$(OUTPUTDIR)" -s "$(CONFFILE)" $(PELICANOPTS) + +clean: + [ ! -d "$(OUTPUTDIR)" ] || rm -rf "$(OUTPUTDIR)" + +regenerate: + "$(PELICAN)" -r "$(INPUTDIR)" -o "$(OUTPUTDIR)" -s "$(CONFFILE)" $(PELICANOPTS) + +serve: + "$(PELICAN)" -l "$(INPUTDIR)" -o "$(OUTPUTDIR)" -s "$(CONFFILE)" $(PELICANOPTS) + +serve-global: + "$(PELICAN)" -l "$(INPUTDIR)" -o "$(OUTPUTDIR)" -s "$(CONFFILE)" $(PELICANOPTS) -b $(SERVER) + +devserver: + "$(PELICAN)" -lr "$(INPUTDIR)" -o "$(OUTPUTDIR)" -s "$(CONFFILE)" $(PELICANOPTS) + +devserver-global: + "$(PELICAN)" -lr "$(INPUTDIR)" -o "$(OUTPUTDIR)" -s "$(CONFFILE)" $(PELICANOPTS) -b 0.0.0.0 + +publish: + "$(PELICAN)" "$(INPUTDIR)" -o "$(OUTPUTDIR)" -s "$(PUBLISHCONF)" $(PELICANOPTS) + rsync -e ssh -av --delete-after /Users/pascal/Documents/craft-letter/output/ craftletter@ssh-craftletter.alwaysdata.net:/home/craftletter/www + +ssh: + ssh craftletter@ssh-craftletter.alwaysdata.net + +.PHONY: html help clean regenerate serve serve-global devserver devserver-global publish diff --git a/__pycache__/pelicanconf.cpython-313.pyc b/__pycache__/pelicanconf.cpython-313.pyc new file mode 100644 index 0000000..22f157f Binary files /dev/null and b/__pycache__/pelicanconf.cpython-313.pyc differ diff --git a/__pycache__/publishconf.cpython-313.pyc b/__pycache__/publishconf.cpython-313.pyc new file mode 100644 index 0000000..6fd726f Binary files /dev/null and b/__pycache__/publishconf.cpython-313.pyc differ diff --git a/content/.DS_Store b/content/.DS_Store new file mode 100644 index 0000000..0538521 Binary files /dev/null and b/content/.DS_Store differ diff --git a/content/images/craftletter.svg b/content/images/craftletter.svg new file mode 100644 index 0000000..0f300a0 --- /dev/null +++ b/content/images/craftletter.svg @@ -0,0 +1,70 @@ + + + + + + + + + + + + + + + + + + + + + + diff --git a/content/newsletter/craft-letter-1.md b/content/newsletter/craft-letter-1.md new file mode 100644 index 0000000..ad70664 --- /dev/null +++ b/content/newsletter/craft-letter-1.md @@ -0,0 +1,65 @@ +Title: Lettre n°1 +Date: 2025-12-08 10:20 +Category: Newsletter + + + + +![Logo Craft Letter]({static}/images/craftletter.svg) + + + + + +## Édito + +J'ai découvert le développement logiciel alors que je n'étais qu'un adolescent. Cela m'a passionné, au point que j'en ai fait mon métier, et après plusieurs décennies, je le pratique avec un plaisir toujours renouvelé. Si mon intérêt pour le développement logiciel ne s'est pas émoussé au fil du temps, c'est grâce à la combinaison de plusieurs facteurs. + +Tout d'abord, j'apprends en permanence ; être toujours à jour en termes de technologies, d'outils et de pratiques me permet non seulement de rester pertinent, mais aussi de ne pas sombrer dans une routine dont je me lasserais inévitablement. Cela implique de pratiquer une veille technologique constante, sous de multiples formes : lecture d'articles de blogs, de livres, conférences, ateliers, projets personnels... Par chance, tout cela aussi est un plaisir pour moi. + + +Ensuite, j'essaie de créer des logiciels dont je suis fier : je mets en pratique certaines bonnes idées que je découvre au fil de ma veille, qu'elles soient techniques ou méthodologiques. Et je fais en sorte que les clients et utilisateurs de ces logiciels soient satisfaits. + +Enfin, je partage ce que j'apprends : j'ai donné plus d'une centaine de conférences, des dizaines de formations, écrit un livre, et je contribue à l'organisation d'événements : Meetup Software Craft Rennes, SoCraTes Rennes, Breizhcamp... J'apprécie particulièrement l'aspect social du développement, aussi bien le travail en équipe que les échanges au sein de communautés de professionnels. + + +Améliorer constamment ses compétences et connaissances, se montrer professionnel, et partager : c'est l'essence de l'artisanat logiciel —le _software craft_. Je suis un _crafter_, pour employer un de ces anglicismes dont nous sommes si friands dans ce milieu. + +Depuis plus de 15 ans, je partage une partie de mes trouvailles avec les gens qui m'entourent, que ce soient des collègues, ou les gens qui viennent voir mes conférences. La publication d'une newsletter participe de la même envie de diffuser ce qui a retenu mon attention récemment. Mes centres d'intérêt sont assez variés, cela devrait se refléter dans le contenu de la lettre au fil des semaines. Vous y trouverez des articles relatifs au développement logiciel d'une façon générale, qu'il soit front-end, back-end ou autre. Mais aussi des articles consacrés à l'architecture logicielle, la méthodologie, les outils, des projets open source, des conférences... Bref, tout ce qui fait le quotidien d'une développeuse ou d'un développeur. + +Bonne lecture ! + +Pascal + +## Quitter Github pour Codeberg + +[Ce retour d'expérience](https://eldred.fr/blog/forge-migration/) consacré à la migration de dépôts Git de Github vers Codeberg m'a interpelé, car j'ai migré récemment mes projets de Github vers une instance de Gitea (hébergée par Zaclys). Toutefois l'auteur de l'article est allé plus loin que le simple transfert de dépôts Git, car il a aussi migré des pipelines de CI, et les pages hébergées avec Github Pages. Il existe de nombreux scripts pour migrer tous vos dépôts d'un coup, de Github [vers ForgeJo](https://github.com/PatNei/GITHUB2FORGEJO) ou [vers Gitea](https://github.com/situ2001/gitea-bulk-migration). Je suis parti de celui-là, mais il en existe une version améliorée. + +Eldred Habert n'est le seul a avoir quitté Github : [les développeurs du langage Zig ont fait de même](https://ziglang.org/news/migrating-from-github-to-codeberg/), mettant en avant la dégradation du service qu'ils ont constaté ces dernières années. Mais cela engendre un risque sur le financement du projet, qui reposait en grande partie sur Github sponsors. + +## Gérer les effets de bord en 30 ligne de JavaScript + +Comment tester simplement un code qui fait des appels à des services externes, comme une base de données, ou une API ? La mise en oeuvre d'une [architecture functional core - imperative shell, en seulement 30 lignes de Javascript](https://lackofimagination.org/2025/11/managing-side-effects-a-javascript-effect-system-in-30-lines-or-less/), permet de tester la logique métier, sans base de données de test ni mocks. + +## L'opérateur pipe se répand + +A propos d'emprunts à la programmation fonctionnelle, l'opérateur pipe |> fait partie des [nouveautés de PHP 8.5](https://les-tilleuls.coop/blog/sortie-de-php-8-5-ce-quil-faut-retenir), et il est déjà [disponible en JavaScript](https://blog.openreplay.com/fr/javascript-pipeline-operateur-signifie/) (via Babel). C'est une des choses qui me manque le plus quand je code en Python ou d'autres langages non fonctionnels (le jeu de mot est volontaire). Il change totalement la façon de penser les fonctions, et les rend bien plus simples à lire une fois qu'on a assimilé la syntaxe. + +## Pourquoi GCC utilise-t-il des ou exclusifs pour mettre à 0 des registres ? + +Dans un [article court et abordable](https://xania.org/202512/01-xor-eax-eax) même quand on y connait pas grand chose en assembleur, Matt Godbolt explique avec beaucoup de pédagogie une optimisation effectuée par GCC. Et si vous vous piquez d'intérêt pour le sujet, il a lancé un calendrier de l'avent dédié à l'[optimisation lors de la compilation de code C ou C++](https://www.youtube.com/playlist?list=PL2HVqYf7If8cY4wLk7JUQ2f0JXY_xMQm2). + +## Le calendrier de l'avent HTMHell est de retour + +[Ce site](https://htmhell.dev/adventcalendar/?s=hell) initié par [Manuel Matuzović](https://mastodon.social/@matuzo@front-end.social) propose chaque jour jusqu'à Noël un article sur la sécurité, l'accessibilité, l'expérience utilisateur, ou les performances des pages Web. + +## Se protéger des attaques supply-chain en Javascript et en Python + +[Aikido Safe Chain](https://www.npmjs.com/package/@aikidosec/safe-chain) est un outil qui filtre les demandes de téléchargement de paquets JS et Python, et vérifie si le paquet demandé ne contient pas de code malveillant. A son lancement, en Juillet dernier, il était compatible avec npm, npx, et yarn ; aujourd'hui il fonctionne avec pnpm, pnpx, bun, bunx, mais aussi des outils du monde Python comme uv, pip , ou pip3. Et d'autres gestionnaires de paquets sont prévus. + +## Meilleur que JSON + +Dans [Meilleur que JSON](https://aloisdeniel.com/blog/better-than-json), Aloïs Deniel explique pourquoi il préfère Protobuf à l'omniprésent JSON : les données sont typées, leur format est vérifié et décrit par un schéma ; la compacité du format binaire améliore les performances. Et l'expérience développeur est améliorée par les générateurs de code. Ce qu'il ne mentionne pas, c'est qu'il existe d'autres formats du même type, comme [Apache Avro](https://avro.apache.org/). JsonToTable fournit une [comparaison détaillée des deux formats](https://jsontotable.org/blog/protobuf/protobuf-vs-avro), et indique dans quels cas d'usage chacun est plus pertinent. Spoiler : aucun des deux n'est meilleur dans tous les cas, mais les deux surpassent JSON. + + +Et voilà, c'est tout pour cette première lettre ! diff --git a/content/newsletter/craft-letter-2.md b/content/newsletter/craft-letter-2.md new file mode 100644 index 0000000..aa29415 --- /dev/null +++ b/content/newsletter/craft-letter-2.md @@ -0,0 +1,70 @@ +Title: Lettre n°2 +Date: 2025-12-15 09:00 +Category: Newsletter + + + + +![Logo Craft Letter]({static}/images/craftletter.svg) + + + + + +## Édito + +Alors que je publie ce second numéro de la Craft Letter, il s'est écoulé moins de deux semaines depuis j'ai eu l'idée de publier une newsletter. Dans un état d'esprit marqué par l'Agile des origines —pas l'adoption superfielle qualifiée de [Faux Agile](https://www.zdnet.fr/actualites/le-developpement-agile-plus-une-pretention-qu-une-realite-39870168.htm) 🇫🇷— et par Getting Real —dont je parle ci-dessous—, j'ai publié le premier numéro rapidement, avec le strict nécessaire. Le logo que j'ai créé ne me satisfait pas complètement ? Ce n'est pas grave, j'en changerai plus tard. Je n'avais pas le temps de créer [un site Web](https://www.craftletter.fr) ? Je l'ai fait après la publication du premier numéro. L'essentiel était là : j'avais du contenu intéressant à partager avec vous. + +Voici les articles et projets qui m'ont marqué cette semaine, agrémentés parfois de quelques réflexions issues de mon expérience ou des recherches que j'ai faites. + +Bonne lecture ! + + + +## Bebop + +Dans le premier numéro de la Craft Letter était citées des alternatives à Json, telles que Protobuf et Apache Avro. Ce sont des protocoles binaires et typés, donc plus compacts et performants que Json. Le typage permet une expérience développeur sympathique. [Bebop](https://bebop.sh), dont la première version date de 2020, se présente comme une version plus moderne de Protobuf, sorti en 2001 —mais [qui continue d'évoluer](https://protobuf.dev/news/). + +## Une comparaison de Go, Rust et Zig + +[Sinclair Target compare Go, Rust et Zig](https://sinclairtarget.com/blog/2025/08/thoughts-on-go-vs.-rust-vs.-zig/) 🇬🇧, après quelques quelques mois d'expérimentation sur ces trois langages. Ses réflexions sont intéressantes, bien qu'il n'ait pas pratiqué ces langages dans un cadre professionnel ni sur une longue durée. Il explique notamment ce qui rend Rust si compliqué à apprendre d'après lui : ce ne serait pas la gestion de la mémoire, mais la multplicité des concepts du langage. + +## Un algorithme de calcul de date hyper rapide + +Ben Joffe est un passionné d'algorithmie, et plus particulièrement d'algorithmes de calcul de date. Il vient de présenter un nouvel algorithme nettement plus rapide que l'état de l'art, pour calculer la date à partir du nombre de jours écoulés depuis le 1er Janvier 1970. + +Dans [A Very Fast 64–Bit Date Algorithm: 30–40% faster](https://www.benjoffe.com/fast-date-64) 🇬🇧, il décrit en détail le fonctionnement de ce nouvel algorithme, les nouveautés qui le distinguent des précédents, et ce qui le rend aussi rapide. + +## Pourquoi quitter Github ? + +Un billet sur le blog d'[Iroco](https://iroco.co/), un service mail Français éthique, nous explique pourquoi ils pensent qu'[il faut quitter Github](https://blog.iroco.co/pourquoi-quitter-github/) **:** ça parle d'IA générative, de souveraineté numérique, de colonialisme, de techno-autoritarisme... + +## Aerospace, un gestionnaire de fenêtre pour MacOS + +Si comme moi vous n'appréciez pas le gestionnaire de fenêtres de MacOS, vous serez peut-être intéressé·e par cet article de Seg6 qui explique, selon lui, comment [rendre MacOS supportable](https://seg6.space/posts/making-macos-bearable/) 🇬🇧. Seg6 y présente plusieurs outils pour se passer de la souris dans de nombreux cas, comme Aerospace et Vimium. [Aerospace](https://github.com/nikitabobko/AeroSpace) est inspiré de [i3](https://i3wm.org/), un gestionnaire de fenêtres pour Linux**.** [Vimium](https://vimium.github.io/) est une extension pour navigateur qui permet de naviguer presque uniquement au clavier. + +## Retour d'expérience sur Shape-up + +Shape-up est une alternative aux méthodes Agiles telles que Scrum, Kanban ou XP. Elle a été imaginée chez [37Signals](https://37signals.com) 🇬🇧, l'entreprise derrière Basecamp, et décrite dans un [livre disponible en ligne](https://basecamp.com/shapeup) 🇬🇧, gratuitement. Ce [résumé](https://www.le-ticket.fr/resume-shape-up-basecamp/2821/) 🇫🇷 vous donnera un aperçu, avant de découvrir le [retour d'expérience de Scale X](https://scalex.dev/blog/2-years-with-shape-up/) 🇬🇧. + +Un ouvrage de 37Signals qui m'a beaucoup influencé est [Getting Real](https://basecamp.com/books#gettingreal) 🇬🇧, le premier livre qui décrivait leur façon de travailler, bien avant qu'ils inventent Shape-Up. Les chapitres sont très courts, chacun présentant une idée souvent aussi iconoclaste que radicale, sur des sujets aussi divers que le financement d'une start-up, la priorisation des fonctionnalités, le recrutement, l'UX, etc. Contrairement à Shape-Up, ce n'est pas une méthode. Il s'agit plutôt une collection de trucs et astuces dont chacun peut être adopté indépendamment, et utilisé en complément de Scrum, XP ou autre. + +[Rework](https://basecamp.com/books#rework) 🇬🇧, paru quelques années après, reprend une grande partie du contenu de Getting Real, et n'y apporte pas grand chose de nouveau sur le fond. + +## Vous n'avez pas besoin de framework CSS + +Si vous n'avez pas suivi les évolutions du langage CSS ces dernières années, vous risquez d'être surpris·e par cette analyse de trois sites développés par 37Signals (oui, ceux qui ont créé Shape-up, mais ça n'a rien à voir les articles cités ci-dessus). Dans [Vanilla CSS is all you need](https://www.zolkos.com/2025/12/03/vanilla-css-is-all-you-need) 🇬🇧, Rob Zolkos montre comment 37Signals utilise les fonctionnalités récentes de CSS pour se passer de framework, de pré-processeur, et parfois de JavaScript ou d'images. + +La première question qui m'est venue à l'esprit à la lecture de cet article, c'est celle du support de ces fonctionnalités par les navigateurs. Une rapide recherche sur [Can I Use](https://caniuse.com) m'a permis d'identifier depuis quand elles sont supportées par les principaux navigateurs : + +- Native [custom properties](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties) (variables) : 2017 +- Native [nesting](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_nesting) : 2023 +- [Container queries](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_container_queries) : 2023 +- [:has()](https://developer.mozilla.org/en-US/docs/Web/CSS/:has) : 2023 +- [CSS Layers](https://developer.mozilla.org/en-US/docs/Web/CSS/@layer) : 2022 +- [color-mix()](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color-mix) : 2023 +- [clamp()](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/clamp), [min()](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/min), [max()](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/max) : 2020 + +## 100 000 transactions par seconde : l'efficacité déraisonnable de Sqlite + +Anders Murphy a réalisé un benchmark dans lequel il montre que [Sqlite peut être d'une efficacité redoutable](https://andersmurphy.com/2025/12/02/100000-tps-over-a-billion-rows-the-unreasonable-effectiveness-of-sqlite.html) 🇬🇧 par rapport aux SGBD traditionnels, du fait de l'absence de communications réseau. Il faut cependant garder à l'esprit que [Sqlite](https://sqlite.org/index.html), bien que ce soit [la base de donnée la plus utilisée au monde](https://sqlite.org/mostdeployed.html) 🇬🇧, n'est pas adaptée à tous les cas d'usage, et n'offre pas exactement les mêmes fonctionnalités. Juste à titre d'exemple, vous n'y trouverez pas d'ID auto-incrémenté. diff --git a/content/pages/index.md b/content/pages/index.md new file mode 100644 index 0000000..a7c3933 --- /dev/null +++ b/content/pages/index.md @@ -0,0 +1,37 @@ +Title: Accueil +Date: 2025-12-08 10:20 +URL: +save_as: index.html +Category: Home + +![Logo Craft Letter]({static}/images/craftletter.svg) + +La Craft Letter est une newsletter hebdomadaire dans laquelle je partage des articles +issues de ma veille technologique. Vous y trouverez des articles relatifs au développement logiciel d'une façon générale, qu'il soit front-end, back-end ou autre. Mais aussi des articles consacrés à l'architecture logicielle, la méthodologie, les outils, des projets open source, des conférences... + +Pour savoir qui je suis, ou pourquoi j'écris cette lettre, je vous invite à vous lire l'édito du [premier numéro]({filename}/newsletter/craft-letter-1.md). + + + + +
+ +--- + +# Archives + +* [Lettre n°2]({filename}/newsletter/craft-letter-2.md) +* [Lettre n°1]({filename}/newsletter/craft-letter-1.md) diff --git a/content/robots.txt b/content/robots.txt new file mode 100644 index 0000000..b73e272 --- /dev/null +++ b/content/robots.txt @@ -0,0 +1,20 @@ +User-agent: GPTBot +Disallow: / + +User-agent: ClaudeBot +Disallow: / + +User-agent: CCBot +Disallow: / + +User-agent: Google-Extended +Disallow: / + +User-agent: Bytespider +Disallow: / + +User-agent: PerplexityBot +Disallow: / + +User-agent: * +Sitemap: https://www.craftletter.fr/sitemap.xml diff --git a/devbox.json b/devbox.json new file mode 100644 index 0000000..498d337 --- /dev/null +++ b/devbox.json @@ -0,0 +1,13 @@ +{ + "$schema": "https://raw.githubusercontent.com/jetify-com/devbox/0.16.0/.schema/devbox.schema.json", + "packages": ["python313Packages.pip@latest"], + "shell": { + "init_hook": [ + ". venv/bin/activate.fish" ], + "scripts": { + "preview": [ + "pelican -r -l" + ] + } + } +} diff --git a/devbox.lock b/devbox.lock new file mode 100644 index 0000000..6090e38 --- /dev/null +++ b/devbox.lock @@ -0,0 +1,93 @@ +{ + "lockfile_version": "1", + "packages": { + "github:NixOS/nixpkgs/nixpkgs-unstable": { + "last_modified": "2025-11-26T06:22:50Z", + "resolved": "github:NixOS/nixpkgs/bb813de6d2241bcb1b5af2d3059f560c66329967?lastModified=1764138170&narHash=sha256-2bCmfCUZyi2yj9FFXYKwsDiaZmizN75cLhI%2FeWmf3tk%3D" + }, + "python313Packages.pip@latest": { + "last_modified": "2025-11-23T21:50:36Z", + "resolved": "github:NixOS/nixpkgs/ee09932cedcef15aaf476f9343d1dea2cb77e261#python313Packages.pip", + "source": "devbox-search", + "version": "25.0.1", + "systems": { + "aarch64-darwin": { + "outputs": [ + { + "name": "out", + "path": "/nix/store/mrzr287djclm6qbgcsq3gnslrz1xq9gk-python3.13-pip-25.0.1", + "default": true + }, + { + "name": "man", + "path": "/nix/store/z869269snssh427n3d4ymdbgv6z2s98m-python3.13-pip-25.0.1-man", + "default": true + }, + { + "name": "dist", + "path": "/nix/store/1iacclxznnylaldv1r8bbf79l5w6fbzl-python3.13-pip-25.0.1-dist" + } + ], + "store_path": "/nix/store/mrzr287djclm6qbgcsq3gnslrz1xq9gk-python3.13-pip-25.0.1" + }, + "aarch64-linux": { + "outputs": [ + { + "name": "out", + "path": "/nix/store/vvll99x1khg8v8biyckj3xwb1ca4ppvn-python3.13-pip-25.0.1", + "default": true + }, + { + "name": "man", + "path": "/nix/store/m6wzxsnzm3ip6zgmm9cdbpbklz4acgp1-python3.13-pip-25.0.1-man", + "default": true + }, + { + "name": "dist", + "path": "/nix/store/whzw332j5np5034pk6jv441bb11cqw3z-python3.13-pip-25.0.1-dist" + } + ], + "store_path": "/nix/store/vvll99x1khg8v8biyckj3xwb1ca4ppvn-python3.13-pip-25.0.1" + }, + "x86_64-darwin": { + "outputs": [ + { + "name": "out", + "path": "/nix/store/qqqsqw0iwdmxn45lr4dk00wh699ny6py-python3.13-pip-25.0.1", + "default": true + }, + { + "name": "man", + "path": "/nix/store/qmis4qangig7vrbn4idpmlz5pcjf77l1-python3.13-pip-25.0.1-man", + "default": true + }, + { + "name": "dist", + "path": "/nix/store/nzs1j69si6pmj10hqrnv86s6p6n3wqad-python3.13-pip-25.0.1-dist" + } + ], + "store_path": "/nix/store/qqqsqw0iwdmxn45lr4dk00wh699ny6py-python3.13-pip-25.0.1" + }, + "x86_64-linux": { + "outputs": [ + { + "name": "out", + "path": "/nix/store/6k8ghavfzfpcgs6angp98gy71xh2mrip-python3.13-pip-25.0.1", + "default": true + }, + { + "name": "man", + "path": "/nix/store/pm073whyjzrvh7sgjydf72j99ffm10wb-python3.13-pip-25.0.1-man", + "default": true + }, + { + "name": "dist", + "path": "/nix/store/6yc20w1yzz150ma4vgcagb3p8kg4ck7c-python3.13-pip-25.0.1-dist" + } + ], + "store_path": "/nix/store/6k8ghavfzfpcgs6angp98gy71xh2mrip-python3.13-pip-25.0.1" + } + } + } + } +} diff --git a/output/archives.html b/output/archives.html new file mode 100644 index 0000000..95dc9c3 --- /dev/null +++ b/output/archives.html @@ -0,0 +1,57 @@ + + + + + + Craft Letter | Archives + + + + + + + + + + + +
+ + +
+
+
+

Archives

+ + +

Dec 2025

+
+ +
+ +
+ +
+
+
+ + \ No newline at end of file diff --git a/output/author/pascal-le-merrer.html b/output/author/pascal-le-merrer.html new file mode 100644 index 0000000..29e8ce5 --- /dev/null +++ b/output/author/pascal-le-merrer.html @@ -0,0 +1,143 @@ + + + + + + Craft Letter | Articles by Pascal Le Merrer + + + + + + + + + + + +
+ + +
+
+

15 Dec 2025

+ +
+

+ Lettre n°2 +

+ + + + +

Logo Craft Letter

+

Édito

+

Alors que je publie ce second numéro de la Craft Letter, il s'est écoulé moins de deux semaines depuis j'ai eu l'idée de publier une newsletter. Dans un état d'esprit marqué par l'Agile des origines —pas l'adoption superfielle qualifiée de Faux Agile 🇫🇷— et par Getting Real —dont je parle ci-dessous—, j'ai publié le premier numéro rapidement, avec le strict nécessaire. Le logo que j'ai créé ne me satisfait pas complètement ? Ce n'est pas grave, j'en changerai plus tard. Je n'avais pas le temps de créer un site Web ? Je l'ai fait après la publication du premier numéro. L'essentiel était là : j'avais du contenu intéressant à partager avec vous.

+

Voici les articles et projets qui m'ont marqué cette semaine, agrémentés parfois de quelques réflexions issues de mon expérience ou des recherches que j'ai faites.

+

Bonne lecture !

+



+

Bebop

+

Dans le premier numéro de la Craft Letter était citées des alternatives à Json, telles que Protobuf et Apache Avro. Ce sont des protocoles binaires et typés, donc plus compacts et performants que Json. Le typage permet une expérience développeur sympathique. Bebop, dont la première version date de 2020, se présente comme une version plus moderne de Protobuf, sorti en 2001 —mais qui continue d'évoluer.

+

Une comparaison de Go, Rust et Zig

+

Sinclair Target compare Go, Rust et Zig 🇬🇧, après quelques quelques mois d'expérimentation sur ces trois langages. Ses réflexions sont intéressantes, bien qu'il n'ait pas pratiqué ces langages dans un cadre professionnel ni sur une longue durée. Il explique notamment ce qui rend Rust si compliqué à apprendre d'après lui : ce ne serait pas la gestion de la mémoire, mais la multplicité des concepts du langage.

+

Un algorithme de calcul de date hyper rapide

+

Ben Joffe est un passionné d'algorithmie, et plus particulièrement d'algorithmes de calcul de date. Il vient de présenter un nouvel algorithme nettement plus rapide que l'état de l'art, pour calculer la date à partir du nombre de jours écoulés depuis le 1er Janvier 1970.

+

Dans A Very Fast 64–Bit Date Algorithm: 30–40% faster 🇬🇧, il décrit en détail le fonctionnement de ce nouvel algorithme, les nouveautés qui le distinguent des précédents, et ce qui le rend aussi rapide.

+

Pourquoi quitter Github ?

+

Un billet sur le blog d'Iroco, un service mail Français éthique, nous explique pourquoi ils pensent qu'il faut quitter Github : ça parle d'IA générative, de souveraineté numérique, de colonialisme, de techno-autoritarisme...

+

Aerospace, un gestionnaire de fenêtre pour MacOS

+

Si comme moi vous n'appréciez pas le gestionnaire de fenêtres de MacOS, vous serez peut-être intéressé·e par cet article de Seg6 qui explique, selon lui, comment rendre MacOS supportable 🇬🇧. Seg6 y présente plusieurs outils pour se passer de la souris dans de nombreux cas, comme Aerospace et Vimium. Aerospace est inspiré de i3, un gestionnaire de fenêtres pour Linux. Vimium est une extension pour navigateur qui permet de naviguer presque uniquement au clavier.

+

Retour d'expérience sur Shape-up

+

Shape-up est une alternative aux méthodes Agiles telles que Scrum, Kanban ou XP. Elle a été imaginée chez 37Signals 🇬🇧, l'entreprise derrière Basecamp, et décrite dans un livre disponible en ligne 🇬🇧, gratuitement. Ce résumé 🇫🇷 vous donnera un aperçu, avant de découvrir le retour d'expérience de Scale X 🇬🇧.

+

Un ouvrage de 37Signals qui m'a beaucoup influencé est Getting Real 🇬🇧, le premier livre qui décrivait leur façon de travailler, bien avant qu'ils inventent Shape-Up. Les chapitres sont très courts, chacun présentant une idée souvent aussi iconoclaste que radicale, sur des sujets aussi divers que le financement d'une start-up, la priorisation des fonctionnalités, le recrutement, l'UX, etc. Contrairement à Shape-Up, ce n'est pas une méthode. Il s'agit plutôt une collection de trucs et astuces dont chacun peut être adopté indépendamment, et utilisé en complément de Scrum, XP ou autre.

+

Rework 🇬🇧, paru quelques années après, reprend une grande partie du contenu de Getting Real, et n'y apporte pas grand chose de nouveau sur le fond.

+

Vous n'avez pas besoin de framework CSS

+

Si vous n'avez pas suivi les évolutions du langage CSS ces dernières années, vous risquez d'être surpris·e par cette analyse de trois sites développés par 37Signals (oui, ceux qui ont créé Shape-up, mais ça n'a rien à voir les articles cités ci-dessus). Dans Vanilla CSS is all you need 🇬🇧, Rob Zolkos montre comment 37Signals utilise les fonctionnalités récentes de CSS pour se passer de framework, de pré-processeur, et parfois de JavaScript ou d'images.

+

La première question qui m'est venue à l'esprit à la lecture de cet article, c'est celle du support de ces fonctionnalités par les navigateurs. Une rapide recherche sur Can I Use m'a permis d'identifier depuis quand elles sont supportées par les principaux navigateurs :

+ +

100 000 transactions par seconde : l'efficacité déraisonnable de Sqlite

+

Anders Murphy a réalisé un benchmark dans lequel il montre que Sqlite peut être d'une efficacité redoutable 🇬🇧 par rapport aux SGBD traditionnels, du fait de l'absence de communications réseau. Il faut cependant garder à l'esprit que Sqlite, bien que ce soit la base de donnée la plus utilisée au monde 🇬🇧, n'est pas adaptée à tous les cas d'usage, et n'offre pas exactement les mêmes fonctionnalités. Juste à titre d'exemple, vous n'y trouverez pas d'ID auto-incrémenté.

+
+ + +

08 Dec 2025

+ +
+

+ Lettre n°1 +

+ + + + +

Logo Craft Letter

+

Édito

+

J'ai découvert le développement logiciel alors que je n'étais qu'un adolescent. Cela m'a passionné, au point que j'en ai fait mon métier, et après plusieurs décennies, je le pratique avec un plaisir toujours renouvelé. Si mon intérêt pour le développement logiciel ne s'est pas émoussé au fil du temps, c'est grâce à la combinaison de plusieurs facteurs.

+

Tout d'abord, j'apprends en permanence ; être toujours à jour en termes de technologies, d'outils et de pratiques me permet non seulement de rester pertinent, mais aussi de ne pas sombrer dans une routine dont je me lasserais inévitablement. Cela implique de pratiquer une veille technologique constante, sous de multiples formes : lecture d'articles de blogs, de livres, conférences, ateliers, projets personnels... Par chance, tout cela aussi est un plaisir pour moi.

+

Ensuite, j'essaie de créer des logiciels dont je suis fier : je mets en pratique certaines bonnes idées que je découvre au fil de ma veille, qu'elles soient techniques ou méthodologiques. Et je fais en sorte que les clients et utilisateurs de ces logiciels soient satisfaits.

+

Enfin, je partage ce que j'apprends : j'ai donné plus d'une centaine de conférences, des dizaines de formations, écrit un livre, et je contribue à l'organisation d'événements : Meetup Software Craft Rennes, SoCraTes Rennes, Breizhcamp... J'apprécie particulièrement l'aspect social du développement, aussi bien le travail en équipe que les échanges au sein de communautés de professionnels.

+

 +Améliorer constamment ses compétences et connaissances, se montrer professionnel, et partager : c'est l'essence de l'artisanat logiciel —le software craft. Je suis un crafter, pour employer un de ces anglicismes dont nous sommes si friands dans ce milieu.

+

Depuis plus de 15 ans, je partage une partie de mes trouvailles avec les gens qui m'entourent, que ce soient des collègues, ou les gens qui viennent voir mes conférences. La publication d'une newsletter participe de la même envie de diffuser ce qui a retenu mon attention récemment. Mes centres d'intérêt sont assez variés, cela devrait se refléter dans le contenu de la lettre au fil des semaines. Vous y trouverez des articles relatifs au développement logiciel d'une façon générale, qu'il soit front-end, back-end ou autre. Mais aussi des articles consacrés à l'architecture logicielle, la méthodologie, les outils, des projets open source, des conférences... Bref, tout ce qui fait le quotidien d'une développeuse ou d'un développeur.

+

Bonne lecture !

+

Pascal

+

Quitter Github pour Codeberg

+

Ce retour d'expérience consacré à la migration de dépôts Git de Github vers Codeberg m'a interpelé, car j'ai migré récemment mes projets de Github vers une instance de Gitea (hébergée par Zaclys). Toutefois l'auteur de l'article est allé plus loin que le simple transfert de dépôts Git, car il a aussi migré des pipelines de CI, et les pages hébergées avec Github Pages. Il existe de nombreux scripts pour migrer tous vos dépôts d'un coup, de Github vers ForgeJo ou vers Gitea. Je suis parti de celui-là, mais il en existe une version améliorée.

+

Eldred Habert n'est le seul a avoir quitté Github : les développeurs du langage Zig ont fait de même, mettant en avant la dégradation du service qu'ils ont constaté ces dernières années. Mais cela engendre un risque sur le financement du projet, qui reposait en grande partie sur Github sponsors.

+

Gérer les effets de bord en 30 ligne de JavaScript

+

Comment tester simplement un code qui fait des appels à des services externes, comme une base de données, ou une API ? La mise en oeuvre d'une architecture functional core - imperative shell, en seulement 30 lignes de Javascript, permet de tester la logique métier, sans base de données de test ni mocks.

+

L'opérateur pipe se répand

+

A propos d'emprunts à la programmation fonctionnelle, l'opérateur pipe |> fait partie des nouveautés de PHP 8.5, et il est déjà disponible en JavaScript (via Babel). C'est une des choses qui me manque le plus quand je code en Python ou d'autres langages non fonctionnels (le jeu de mot est volontaire). Il change totalement la façon de penser les fonctions, et les rend bien plus simples à lire une fois qu'on a assimilé la syntaxe.

+

Pourquoi GCC utilise-t-il des ou exclusifs pour mettre à 0 des registres ?

+

Dans un article court et abordable même quand on y connait pas grand chose en assembleur, Matt Godbolt explique avec beaucoup de pédagogie une optimisation effectuée par GCC. Et si vous vous piquez d'intérêt pour le sujet, il a lancé un calendrier de l'avent dédié à l'optimisation lors de la compilation de code C ou C++.

+

Le calendrier de l'avent HTMHell est de retour

+

Ce site initié par Manuel Matuzović propose chaque jour jusqu'à Noël un article sur la sécurité, l'accessibilité, l'expérience utilisateur, ou les performances des pages Web.

+

Se protéger des attaques supply-chain en Javascript et en Python

+

Aikido Safe Chain est un outil qui filtre les demandes de téléchargement de paquets JS et Python, et vérifie si le paquet demandé ne contient pas de code malveillant. A son lancement, en Juillet dernier, il était compatible avec npm, npx, et yarn ; aujourd'hui il fonctionne avec pnpm, pnpx, bun, bunx, mais aussi des outils du monde Python comme uv, pip , ou pip3. Et d'autres gestionnaires de paquets sont prévus.

+

Meilleur que JSON

+

Dans Meilleur que JSON, Aloïs Deniel explique pourquoi il préfère Protobuf à l'omniprésent JSON : les données sont typées, leur format est vérifié et décrit par un schéma ; la compacité du format binaire améliore les performances. Et l'expérience développeur est améliorée par les générateurs de code. Ce qu'il ne mentionne pas, c'est qu'il existe d'autres formats du même type, comme Apache Avro. JsonToTable fournit une comparaison détaillée des deux formats, et indique dans quels cas d'usage chacun est plus pertinent. Spoiler : aucun des deux n'est meilleur dans tous les cas, mais les deux surpassent JSON.

+

Et voilà, c'est tout pour cette première lettre !

+
+ + +
+ +
+ +
+
+
+ + \ No newline at end of file diff --git a/output/authors.html b/output/authors.html new file mode 100644 index 0000000..79b021a --- /dev/null +++ b/output/authors.html @@ -0,0 +1,50 @@ + + + + + + Craft Letter - Authors + + + + + + + + + + + +
+ + +
+
+

Authors on Craft Letter

+ + +
+ +
+
+
+ + \ No newline at end of file diff --git a/output/categories.html b/output/categories.html new file mode 100644 index 0000000..7144bf8 --- /dev/null +++ b/output/categories.html @@ -0,0 +1,50 @@ + + + + + + Craft Letter - Categories + + + + + + + + + + + +
+ + +
+
+

Categories on Craft Letter

+ + +
+ +
+
+
+ + \ No newline at end of file diff --git a/output/category/newsletter.html b/output/category/newsletter.html new file mode 100644 index 0000000..9d90d2e --- /dev/null +++ b/output/category/newsletter.html @@ -0,0 +1,143 @@ + + + + + + Craft Letter | articles in the "Newsletter" category + + + + + + + + + + + +
+ + +
+
+

15 Dec 2025

+ +
+

+ Lettre n°2 +

+ + + + +

Logo Craft Letter

+

Édito

+

Alors que je publie ce second numéro de la Craft Letter, il s'est écoulé moins de deux semaines depuis j'ai eu l'idée de publier une newsletter. Dans un état d'esprit marqué par l'Agile des origines —pas l'adoption superfielle qualifiée de Faux Agile 🇫🇷— et par Getting Real —dont je parle ci-dessous—, j'ai publié le premier numéro rapidement, avec le strict nécessaire. Le logo que j'ai créé ne me satisfait pas complètement ? Ce n'est pas grave, j'en changerai plus tard. Je n'avais pas le temps de créer un site Web ? Je l'ai fait après la publication du premier numéro. L'essentiel était là : j'avais du contenu intéressant à partager avec vous.

+

Voici les articles et projets qui m'ont marqué cette semaine, agrémentés parfois de quelques réflexions issues de mon expérience ou des recherches que j'ai faites.

+

Bonne lecture !

+



+

Bebop

+

Dans le premier numéro de la Craft Letter était citées des alternatives à Json, telles que Protobuf et Apache Avro. Ce sont des protocoles binaires et typés, donc plus compacts et performants que Json. Le typage permet une expérience développeur sympathique. Bebop, dont la première version date de 2020, se présente comme une version plus moderne de Protobuf, sorti en 2001 —mais qui continue d'évoluer.

+

Une comparaison de Go, Rust et Zig

+

Sinclair Target compare Go, Rust et Zig 🇬🇧, après quelques quelques mois d'expérimentation sur ces trois langages. Ses réflexions sont intéressantes, bien qu'il n'ait pas pratiqué ces langages dans un cadre professionnel ni sur une longue durée. Il explique notamment ce qui rend Rust si compliqué à apprendre d'après lui : ce ne serait pas la gestion de la mémoire, mais la multplicité des concepts du langage.

+

Un algorithme de calcul de date hyper rapide

+

Ben Joffe est un passionné d'algorithmie, et plus particulièrement d'algorithmes de calcul de date. Il vient de présenter un nouvel algorithme nettement plus rapide que l'état de l'art, pour calculer la date à partir du nombre de jours écoulés depuis le 1er Janvier 1970.

+

Dans A Very Fast 64–Bit Date Algorithm: 30–40% faster 🇬🇧, il décrit en détail le fonctionnement de ce nouvel algorithme, les nouveautés qui le distinguent des précédents, et ce qui le rend aussi rapide.

+

Pourquoi quitter Github ?

+

Un billet sur le blog d'Iroco, un service mail Français éthique, nous explique pourquoi ils pensent qu'il faut quitter Github : ça parle d'IA générative, de souveraineté numérique, de colonialisme, de techno-autoritarisme...

+

Aerospace, un gestionnaire de fenêtre pour MacOS

+

Si comme moi vous n'appréciez pas le gestionnaire de fenêtres de MacOS, vous serez peut-être intéressé·e par cet article de Seg6 qui explique, selon lui, comment rendre MacOS supportable 🇬🇧. Seg6 y présente plusieurs outils pour se passer de la souris dans de nombreux cas, comme Aerospace et Vimium. Aerospace est inspiré de i3, un gestionnaire de fenêtres pour Linux. Vimium est une extension pour navigateur qui permet de naviguer presque uniquement au clavier.

+

Retour d'expérience sur Shape-up

+

Shape-up est une alternative aux méthodes Agiles telles que Scrum, Kanban ou XP. Elle a été imaginée chez 37Signals 🇬🇧, l'entreprise derrière Basecamp, et décrite dans un livre disponible en ligne 🇬🇧, gratuitement. Ce résumé 🇫🇷 vous donnera un aperçu, avant de découvrir le retour d'expérience de Scale X 🇬🇧.

+

Un ouvrage de 37Signals qui m'a beaucoup influencé est Getting Real 🇬🇧, le premier livre qui décrivait leur façon de travailler, bien avant qu'ils inventent Shape-Up. Les chapitres sont très courts, chacun présentant une idée souvent aussi iconoclaste que radicale, sur des sujets aussi divers que le financement d'une start-up, la priorisation des fonctionnalités, le recrutement, l'UX, etc. Contrairement à Shape-Up, ce n'est pas une méthode. Il s'agit plutôt une collection de trucs et astuces dont chacun peut être adopté indépendamment, et utilisé en complément de Scrum, XP ou autre.

+

Rework 🇬🇧, paru quelques années après, reprend une grande partie du contenu de Getting Real, et n'y apporte pas grand chose de nouveau sur le fond.

+

Vous n'avez pas besoin de framework CSS

+

Si vous n'avez pas suivi les évolutions du langage CSS ces dernières années, vous risquez d'être surpris·e par cette analyse de trois sites développés par 37Signals (oui, ceux qui ont créé Shape-up, mais ça n'a rien à voir les articles cités ci-dessus). Dans Vanilla CSS is all you need 🇬🇧, Rob Zolkos montre comment 37Signals utilise les fonctionnalités récentes de CSS pour se passer de framework, de pré-processeur, et parfois de JavaScript ou d'images.

+

La première question qui m'est venue à l'esprit à la lecture de cet article, c'est celle du support de ces fonctionnalités par les navigateurs. Une rapide recherche sur Can I Use m'a permis d'identifier depuis quand elles sont supportées par les principaux navigateurs :

+ +

100 000 transactions par seconde : l'efficacité déraisonnable de Sqlite

+

Anders Murphy a réalisé un benchmark dans lequel il montre que Sqlite peut être d'une efficacité redoutable 🇬🇧 par rapport aux SGBD traditionnels, du fait de l'absence de communications réseau. Il faut cependant garder à l'esprit que Sqlite, bien que ce soit la base de donnée la plus utilisée au monde 🇬🇧, n'est pas adaptée à tous les cas d'usage, et n'offre pas exactement les mêmes fonctionnalités. Juste à titre d'exemple, vous n'y trouverez pas d'ID auto-incrémenté.

+
+ + +

08 Dec 2025

+ +
+

+ Lettre n°1 +

+ + + + +

Logo Craft Letter

+

Édito

+

J'ai découvert le développement logiciel alors que je n'étais qu'un adolescent. Cela m'a passionné, au point que j'en ai fait mon métier, et après plusieurs décennies, je le pratique avec un plaisir toujours renouvelé. Si mon intérêt pour le développement logiciel ne s'est pas émoussé au fil du temps, c'est grâce à la combinaison de plusieurs facteurs.

+

Tout d'abord, j'apprends en permanence ; être toujours à jour en termes de technologies, d'outils et de pratiques me permet non seulement de rester pertinent, mais aussi de ne pas sombrer dans une routine dont je me lasserais inévitablement. Cela implique de pratiquer une veille technologique constante, sous de multiples formes : lecture d'articles de blogs, de livres, conférences, ateliers, projets personnels... Par chance, tout cela aussi est un plaisir pour moi.

+

Ensuite, j'essaie de créer des logiciels dont je suis fier : je mets en pratique certaines bonnes idées que je découvre au fil de ma veille, qu'elles soient techniques ou méthodologiques. Et je fais en sorte que les clients et utilisateurs de ces logiciels soient satisfaits.

+

Enfin, je partage ce que j'apprends : j'ai donné plus d'une centaine de conférences, des dizaines de formations, écrit un livre, et je contribue à l'organisation d'événements : Meetup Software Craft Rennes, SoCraTes Rennes, Breizhcamp... J'apprécie particulièrement l'aspect social du développement, aussi bien le travail en équipe que les échanges au sein de communautés de professionnels.

+

 +Améliorer constamment ses compétences et connaissances, se montrer professionnel, et partager : c'est l'essence de l'artisanat logiciel —le software craft. Je suis un crafter, pour employer un de ces anglicismes dont nous sommes si friands dans ce milieu.

+

Depuis plus de 15 ans, je partage une partie de mes trouvailles avec les gens qui m'entourent, que ce soient des collègues, ou les gens qui viennent voir mes conférences. La publication d'une newsletter participe de la même envie de diffuser ce qui a retenu mon attention récemment. Mes centres d'intérêt sont assez variés, cela devrait se refléter dans le contenu de la lettre au fil des semaines. Vous y trouverez des articles relatifs au développement logiciel d'une façon générale, qu'il soit front-end, back-end ou autre. Mais aussi des articles consacrés à l'architecture logicielle, la méthodologie, les outils, des projets open source, des conférences... Bref, tout ce qui fait le quotidien d'une développeuse ou d'un développeur.

+

Bonne lecture !

+

Pascal

+

Quitter Github pour Codeberg

+

Ce retour d'expérience consacré à la migration de dépôts Git de Github vers Codeberg m'a interpelé, car j'ai migré récemment mes projets de Github vers une instance de Gitea (hébergée par Zaclys). Toutefois l'auteur de l'article est allé plus loin que le simple transfert de dépôts Git, car il a aussi migré des pipelines de CI, et les pages hébergées avec Github Pages. Il existe de nombreux scripts pour migrer tous vos dépôts d'un coup, de Github vers ForgeJo ou vers Gitea. Je suis parti de celui-là, mais il en existe une version améliorée.

+

Eldred Habert n'est le seul a avoir quitté Github : les développeurs du langage Zig ont fait de même, mettant en avant la dégradation du service qu'ils ont constaté ces dernières années. Mais cela engendre un risque sur le financement du projet, qui reposait en grande partie sur Github sponsors.

+

Gérer les effets de bord en 30 ligne de JavaScript

+

Comment tester simplement un code qui fait des appels à des services externes, comme une base de données, ou une API ? La mise en oeuvre d'une architecture functional core - imperative shell, en seulement 30 lignes de Javascript, permet de tester la logique métier, sans base de données de test ni mocks.

+

L'opérateur pipe se répand

+

A propos d'emprunts à la programmation fonctionnelle, l'opérateur pipe |> fait partie des nouveautés de PHP 8.5, et il est déjà disponible en JavaScript (via Babel). C'est une des choses qui me manque le plus quand je code en Python ou d'autres langages non fonctionnels (le jeu de mot est volontaire). Il change totalement la façon de penser les fonctions, et les rend bien plus simples à lire une fois qu'on a assimilé la syntaxe.

+

Pourquoi GCC utilise-t-il des ou exclusifs pour mettre à 0 des registres ?

+

Dans un article court et abordable même quand on y connait pas grand chose en assembleur, Matt Godbolt explique avec beaucoup de pédagogie une optimisation effectuée par GCC. Et si vous vous piquez d'intérêt pour le sujet, il a lancé un calendrier de l'avent dédié à l'optimisation lors de la compilation de code C ou C++.

+

Le calendrier de l'avent HTMHell est de retour

+

Ce site initié par Manuel Matuzović propose chaque jour jusqu'à Noël un article sur la sécurité, l'accessibilité, l'expérience utilisateur, ou les performances des pages Web.

+

Se protéger des attaques supply-chain en Javascript et en Python

+

Aikido Safe Chain est un outil qui filtre les demandes de téléchargement de paquets JS et Python, et vérifie si le paquet demandé ne contient pas de code malveillant. A son lancement, en Juillet dernier, il était compatible avec npm, npx, et yarn ; aujourd'hui il fonctionne avec pnpm, pnpx, bun, bunx, mais aussi des outils du monde Python comme uv, pip , ou pip3. Et d'autres gestionnaires de paquets sont prévus.

+

Meilleur que JSON

+

Dans Meilleur que JSON, Aloïs Deniel explique pourquoi il préfère Protobuf à l'omniprésent JSON : les données sont typées, leur format est vérifié et décrit par un schéma ; la compacité du format binaire améliore les performances. Et l'expérience développeur est améliorée par les générateurs de code. Ce qu'il ne mentionne pas, c'est qu'il existe d'autres formats du même type, comme Apache Avro. JsonToTable fournit une comparaison détaillée des deux formats, et indique dans quels cas d'usage chacun est plus pertinent. Spoiler : aucun des deux n'est meilleur dans tous les cas, mais les deux surpassent JSON.

+

Et voilà, c'est tout pour cette première lettre !

+
+ + +
+ +
+ +
+
+
+ + \ No newline at end of file diff --git a/output/feeds/all.rss.xml b/output/feeds/all.rss.xml new file mode 100644 index 0000000..730c51a --- /dev/null +++ b/output/feeds/all.rss.xml @@ -0,0 +1,6 @@ + +Craft Letterhttps://www.craftletter.fr/Mon, 15 Dec 2025 09:00:00 +0100Lettre n°2https://www.craftletter.fr/lettre-ndeg2.html<p><img alt="Logo Craft Letter" src="https://www.craftletter.fr/images/craftletter.svg"></p> +<h2>Édito</h2> +<p>Alors que je publie ce second numéro de la Craft Letter, il s'est écoulé moins de deux semaines depuis j'ai eu l'idée de publier une newsletter. Dans un état d'esprit marqué par l'Agile des origines —pas l'adoption superfielle qualifiée de <a href="https://www.zdnet.fr/actualites/le-developpement-agile-plus-une-pretention-qu-une-realite-39870168.htm">Faux Agile</a> 🇫🇷— et par Getting Real —dont je parle …</p>Pascal Le MerrerMon, 15 Dec 2025 09:00:00 +0100tag:www.craftletter.fr,2025-12-15:/lettre-ndeg2.htmlNewsletterLettre n°1https://www.craftletter.fr/lettre-ndeg1.html<p><img alt="Logo Craft Letter" src="https://www.craftletter.fr/images/craftletter.svg"></p> +<h2>Édito</h2> +<p>J'ai découvert le développement logiciel alors que je n'étais qu'un adolescent. Cela m'a passionné, au point que j'en ai fait mon métier, et après plusieurs décennies, je le pratique avec un plaisir toujours renouvelé. Si mon intérêt pour le développement logiciel ne s'est pas émoussé au fil du temps …</p>Pascal Le MerrerMon, 08 Dec 2025 10:20:00 +0100tag:www.craftletter.fr,2025-12-08:/lettre-ndeg1.htmlNewsletter \ No newline at end of file diff --git a/output/images/craftletter.svg b/output/images/craftletter.svg new file mode 100644 index 0000000..0f300a0 --- /dev/null +++ b/output/images/craftletter.svg @@ -0,0 +1,70 @@ + + + + + + + + + + + + + + + + + + + + + + diff --git a/output/index.html b/output/index.html new file mode 100644 index 0000000..b7a1670 --- /dev/null +++ b/output/index.html @@ -0,0 +1,75 @@ + + + + + + +Craft Letter | Accueil + + + + + + + + + + + +
+ + +
+
+
+
+

Accueil

+

Logo Craft Letter

+

La Craft Letter est une newsletter hebdomadaire dans laquelle je partage des articles +issues de ma veille technologique. Vous y trouverez des articles relatifs au développement logiciel d'une façon générale, qu'il soit front-end, back-end ou autre. Mais aussi des articles consacrés à l'architecture logicielle, la méthodologie, les outils, des projets open source, des conférences...

+

Pour savoir qui je suis, ou pourquoi j'écris cette lettre, je vous invite à vous lire l'édito du premier numéro.

+ +
+
+

Archives

+ +
+
+ +
+
+
+ + \ No newline at end of file diff --git a/output/lettre-ndeg1.html b/output/lettre-ndeg1.html new file mode 100644 index 0000000..3d047b6 --- /dev/null +++ b/output/lettre-ndeg1.html @@ -0,0 +1,84 @@ + + + + + + +Craft Letter | Lettre n°1 + + + + + + + + + + + +
+ + +
+
+

08 Dec 2025

+
+

+Lettre n°1 +

+

Logo Craft Letter

+

Édito

+

J'ai découvert le développement logiciel alors que je n'étais qu'un adolescent. Cela m'a passionné, au point que j'en ai fait mon métier, et après plusieurs décennies, je le pratique avec un plaisir toujours renouvelé. Si mon intérêt pour le développement logiciel ne s'est pas émoussé au fil du temps, c'est grâce à la combinaison de plusieurs facteurs.

+

Tout d'abord, j'apprends en permanence ; être toujours à jour en termes de technologies, d'outils et de pratiques me permet non seulement de rester pertinent, mais aussi de ne pas sombrer dans une routine dont je me lasserais inévitablement. Cela implique de pratiquer une veille technologique constante, sous de multiples formes : lecture d'articles de blogs, de livres, conférences, ateliers, projets personnels... Par chance, tout cela aussi est un plaisir pour moi.

+

Ensuite, j'essaie de créer des logiciels dont je suis fier : je mets en pratique certaines bonnes idées que je découvre au fil de ma veille, qu'elles soient techniques ou méthodologiques. Et je fais en sorte que les clients et utilisateurs de ces logiciels soient satisfaits.

+

Enfin, je partage ce que j'apprends : j'ai donné plus d'une centaine de conférences, des dizaines de formations, écrit un livre, et je contribue à l'organisation d'événements : Meetup Software Craft Rennes, SoCraTes Rennes, Breizhcamp... J'apprécie particulièrement l'aspect social du développement, aussi bien le travail en équipe que les échanges au sein de communautés de professionnels.

+

 +Améliorer constamment ses compétences et connaissances, se montrer professionnel, et partager : c'est l'essence de l'artisanat logiciel —le software craft. Je suis un crafter, pour employer un de ces anglicismes dont nous sommes si friands dans ce milieu.

+

Depuis plus de 15 ans, je partage une partie de mes trouvailles avec les gens qui m'entourent, que ce soient des collègues, ou les gens qui viennent voir mes conférences. La publication d'une newsletter participe de la même envie de diffuser ce qui a retenu mon attention récemment. Mes centres d'intérêt sont assez variés, cela devrait se refléter dans le contenu de la lettre au fil des semaines. Vous y trouverez des articles relatifs au développement logiciel d'une façon générale, qu'il soit front-end, back-end ou autre. Mais aussi des articles consacrés à l'architecture logicielle, la méthodologie, les outils, des projets open source, des conférences... Bref, tout ce qui fait le quotidien d'une développeuse ou d'un développeur.

+

Bonne lecture !

+

Pascal

+

Quitter Github pour Codeberg

+

Ce retour d'expérience consacré à la migration de dépôts Git de Github vers Codeberg m'a interpelé, car j'ai migré récemment mes projets de Github vers une instance de Gitea (hébergée par Zaclys). Toutefois l'auteur de l'article est allé plus loin que le simple transfert de dépôts Git, car il a aussi migré des pipelines de CI, et les pages hébergées avec Github Pages. Il existe de nombreux scripts pour migrer tous vos dépôts d'un coup, de Github vers ForgeJo ou vers Gitea. Je suis parti de celui-là, mais il en existe une version améliorée.

+

Eldred Habert n'est le seul a avoir quitté Github : les développeurs du langage Zig ont fait de même, mettant en avant la dégradation du service qu'ils ont constaté ces dernières années. Mais cela engendre un risque sur le financement du projet, qui reposait en grande partie sur Github sponsors.

+

Gérer les effets de bord en 30 ligne de JavaScript

+

Comment tester simplement un code qui fait des appels à des services externes, comme une base de données, ou une API ? La mise en oeuvre d'une architecture functional core - imperative shell, en seulement 30 lignes de Javascript, permet de tester la logique métier, sans base de données de test ni mocks.

+

L'opérateur pipe se répand

+

A propos d'emprunts à la programmation fonctionnelle, l'opérateur pipe |> fait partie des nouveautés de PHP 8.5, et il est déjà disponible en JavaScript (via Babel). C'est une des choses qui me manque le plus quand je code en Python ou d'autres langages non fonctionnels (le jeu de mot est volontaire). Il change totalement la façon de penser les fonctions, et les rend bien plus simples à lire une fois qu'on a assimilé la syntaxe.

+

Pourquoi GCC utilise-t-il des ou exclusifs pour mettre à 0 des registres ?

+

Dans un article court et abordable même quand on y connait pas grand chose en assembleur, Matt Godbolt explique avec beaucoup de pédagogie une optimisation effectuée par GCC. Et si vous vous piquez d'intérêt pour le sujet, il a lancé un calendrier de l'avent dédié à l'optimisation lors de la compilation de code C ou C++.

+

Le calendrier de l'avent HTMHell est de retour

+

Ce site initié par Manuel Matuzović propose chaque jour jusqu'à Noël un article sur la sécurité, l'accessibilité, l'expérience utilisateur, ou les performances des pages Web.

+

Se protéger des attaques supply-chain en Javascript et en Python

+

Aikido Safe Chain est un outil qui filtre les demandes de téléchargement de paquets JS et Python, et vérifie si le paquet demandé ne contient pas de code malveillant. A son lancement, en Juillet dernier, il était compatible avec npm, npx, et yarn ; aujourd'hui il fonctionne avec pnpm, pnpx, bun, bunx, mais aussi des outils du monde Python comme uv, pip , ou pip3. Et d'autres gestionnaires de paquets sont prévus.

+

Meilleur que JSON

+

Dans Meilleur que JSON, Aloïs Deniel explique pourquoi il préfère Protobuf à l'omniprésent JSON : les données sont typées, leur format est vérifié et décrit par un schéma ; la compacité du format binaire améliore les performances. Et l'expérience développeur est améliorée par les générateurs de code. Ce qu'il ne mentionne pas, c'est qu'il existe d'autres formats du même type, comme Apache Avro. JsonToTable fournit une comparaison détaillée des deux formats, et indique dans quels cas d'usage chacun est plus pertinent. Spoiler : aucun des deux n'est meilleur dans tous les cas, mais les deux surpassent JSON.

+

Et voilà, c'est tout pour cette première lettre !

+
+ +
+
+ +
+
+
+ + \ No newline at end of file diff --git a/output/lettre-ndeg2.html b/output/lettre-ndeg2.html new file mode 100644 index 0000000..5198fa2 --- /dev/null +++ b/output/lettre-ndeg2.html @@ -0,0 +1,92 @@ + + + + + + +Craft Letter | Lettre n°2 + + + + + + + + + + + +
+ + +
+
+

15 Dec 2025

+
+

+Lettre n°2 +

+

Logo Craft Letter

+

Édito

+

Alors que je publie ce second numéro de la Craft Letter, il s'est écoulé moins de deux semaines depuis j'ai eu l'idée de publier une newsletter. Dans un état d'esprit marqué par l'Agile des origines —pas l'adoption superfielle qualifiée de Faux Agile 🇫🇷— et par Getting Real —dont je parle ci-dessous—, j'ai publié le premier numéro rapidement, avec le strict nécessaire. Le logo que j'ai créé ne me satisfait pas complètement ? Ce n'est pas grave, j'en changerai plus tard. Je n'avais pas le temps de créer un site Web ? Je l'ai fait après la publication du premier numéro. L'essentiel était là : j'avais du contenu intéressant à partager avec vous.

+

Voici les articles et projets qui m'ont marqué cette semaine, agrémentés parfois de quelques réflexions issues de mon expérience ou des recherches que j'ai faites.

+

Bonne lecture !

+



+

Bebop

+

Dans le premier numéro de la Craft Letter était citées des alternatives à Json, telles que Protobuf et Apache Avro. Ce sont des protocoles binaires et typés, donc plus compacts et performants que Json. Le typage permet une expérience développeur sympathique. Bebop, dont la première version date de 2020, se présente comme une version plus moderne de Protobuf, sorti en 2001 —mais qui continue d'évoluer.

+

Une comparaison de Go, Rust et Zig

+

Sinclair Target compare Go, Rust et Zig 🇬🇧, après quelques quelques mois d'expérimentation sur ces trois langages. Ses réflexions sont intéressantes, bien qu'il n'ait pas pratiqué ces langages dans un cadre professionnel ni sur une longue durée. Il explique notamment ce qui rend Rust si compliqué à apprendre d'après lui : ce ne serait pas la gestion de la mémoire, mais la multplicité des concepts du langage.

+

Un algorithme de calcul de date hyper rapide

+

Ben Joffe est un passionné d'algorithmie, et plus particulièrement d'algorithmes de calcul de date. Il vient de présenter un nouvel algorithme nettement plus rapide que l'état de l'art, pour calculer la date à partir du nombre de jours écoulés depuis le 1er Janvier 1970.

+

Dans A Very Fast 64–Bit Date Algorithm: 30–40% faster 🇬🇧, il décrit en détail le fonctionnement de ce nouvel algorithme, les nouveautés qui le distinguent des précédents, et ce qui le rend aussi rapide.

+

Pourquoi quitter Github ?

+

Un billet sur le blog d'Iroco, un service mail Français éthique, nous explique pourquoi ils pensent qu'il faut quitter Github : ça parle d'IA générative, de souveraineté numérique, de colonialisme, de techno-autoritarisme...

+

Aerospace, un gestionnaire de fenêtre pour MacOS

+

Si comme moi vous n'appréciez pas le gestionnaire de fenêtres de MacOS, vous serez peut-être intéressé·e par cet article de Seg6 qui explique, selon lui, comment rendre MacOS supportable 🇬🇧. Seg6 y présente plusieurs outils pour se passer de la souris dans de nombreux cas, comme Aerospace et Vimium. Aerospace est inspiré de i3, un gestionnaire de fenêtres pour Linux. Vimium est une extension pour navigateur qui permet de naviguer presque uniquement au clavier.

+

Retour d'expérience sur Shape-up

+

Shape-up est une alternative aux méthodes Agiles telles que Scrum, Kanban ou XP. Elle a été imaginée chez 37Signals 🇬🇧, l'entreprise derrière Basecamp, et décrite dans un livre disponible en ligne 🇬🇧, gratuitement. Ce résumé 🇫🇷 vous donnera un aperçu, avant de découvrir le retour d'expérience de Scale X 🇬🇧.

+

Un ouvrage de 37Signals qui m'a beaucoup influencé est Getting Real 🇬🇧, le premier livre qui décrivait leur façon de travailler, bien avant qu'ils inventent Shape-Up. Les chapitres sont très courts, chacun présentant une idée souvent aussi iconoclaste que radicale, sur des sujets aussi divers que le financement d'une start-up, la priorisation des fonctionnalités, le recrutement, l'UX, etc. Contrairement à Shape-Up, ce n'est pas une méthode. Il s'agit plutôt une collection de trucs et astuces dont chacun peut être adopté indépendamment, et utilisé en complément de Scrum, XP ou autre.

+

Rework 🇬🇧, paru quelques années après, reprend une grande partie du contenu de Getting Real, et n'y apporte pas grand chose de nouveau sur le fond.

+

Vous n'avez pas besoin de framework CSS

+

Si vous n'avez pas suivi les évolutions du langage CSS ces dernières années, vous risquez d'être surpris·e par cette analyse de trois sites développés par 37Signals (oui, ceux qui ont créé Shape-up, mais ça n'a rien à voir les articles cités ci-dessus). Dans Vanilla CSS is all you need 🇬🇧, Rob Zolkos montre comment 37Signals utilise les fonctionnalités récentes de CSS pour se passer de framework, de pré-processeur, et parfois de JavaScript ou d'images.

+

La première question qui m'est venue à l'esprit à la lecture de cet article, c'est celle du support de ces fonctionnalités par les navigateurs. Une rapide recherche sur Can I Use m'a permis d'identifier depuis quand elles sont supportées par les principaux navigateurs :

+ +

100 000 transactions par seconde : l'efficacité déraisonnable de Sqlite

+

Anders Murphy a réalisé un benchmark dans lequel il montre que Sqlite peut être d'une efficacité redoutable 🇬🇧 par rapport aux SGBD traditionnels, du fait de l'absence de communications réseau. Il faut cependant garder à l'esprit que Sqlite, bien que ce soit la base de donnée la plus utilisée au monde 🇬🇧, n'est pas adaptée à tous les cas d'usage, et n'offre pas exactement les mêmes fonctionnalités. Juste à titre d'exemple, vous n'y trouverez pas d'ID auto-incrémenté.

+
+ +
+
+ +
+
+
+ + \ No newline at end of file diff --git a/output/robots.txt b/output/robots.txt new file mode 100644 index 0000000..b73e272 --- /dev/null +++ b/output/robots.txt @@ -0,0 +1,20 @@ +User-agent: GPTBot +Disallow: / + +User-agent: ClaudeBot +Disallow: / + +User-agent: CCBot +Disallow: / + +User-agent: Google-Extended +Disallow: / + +User-agent: Bytespider +Disallow: / + +User-agent: PerplexityBot +Disallow: / + +User-agent: * +Sitemap: https://www.craftletter.fr/sitemap.xml diff --git a/output/tags.html b/output/tags.html new file mode 100644 index 0000000..b76e8bb --- /dev/null +++ b/output/tags.html @@ -0,0 +1,48 @@ + + + + + + Craft Letter + + + + + + + + + + + +
+ + +
+
+
    +
+ +
+ +
+
+
+ + \ No newline at end of file diff --git a/output/theme/css/print.css b/output/theme/css/print.css new file mode 100644 index 0000000..c63a87b --- /dev/null +++ b/output/theme/css/print.css @@ -0,0 +1,4 @@ +* { background: #fff; } +body { font-family: georgia, times, serif; color: black; } +blockquote { font-style: italic; color: black; } +a:link, a:visited { border-bottom-width: 1px; border-bottom-style: solid; } diff --git a/output/theme/css/pygments.css b/output/theme/css/pygments.css new file mode 100644 index 0000000..91ae326 --- /dev/null +++ b/output/theme/css/pygments.css @@ -0,0 +1,87 @@ +/* Solarized Dark + +For use with Jekyll and Pygments + +http://ethanschoonover.com/solarized + +SOLARIZED HEX ROLE +--------- -------- ------------------------------------------ +base03 #002b36 background +base01 #586e75 comments / secondary content +base1 #93a1a1 body text / default code / primary content +orange #cb4b16 constants +red #dc322f regex, special keywords +blue #268bd2 reserved keywords +cyan #2aa198 strings, numbers +green #859900 operators, other keywords +*/ + +.highlight { background-color: #002b36; color: #93a1a1 } +.highlight .c { color: #586e75 } /* Comment */ +.highlight .err { color: #93a1a1 } /* Error */ +.highlight .g { color: #93a1a1 } /* Generic */ +.highlight .k { color: #859900 } /* Keyword */ +.highlight .l { color: #93a1a1 } /* Literal */ +.highlight .n { color: #93a1a1 } /* Name */ +.highlight .o { color: #859900 } /* Operator */ +.highlight .x { color: #cb4b16 } /* Other */ +.highlight .p { color: #93a1a1 } /* Punctuation */ +.highlight .cm { color: #586e75 } /* Comment.Multiline */ +.highlight .cp { color: #859900 } /* Comment.Preproc */ +.highlight .c1 { color: #586e75 } /* Comment.Single */ +.highlight .cs { color: #859900 } /* Comment.Special */ +.highlight .gd { color: #2aa198 } /* Generic.Deleted */ +.highlight .ge { color: #93a1a1; font-style: italic } /* Generic.Emph */ +.highlight .gr { color: #dc322f } /* Generic.Error */ +.highlight .gh { color: #cb4b16 } /* Generic.Heading */ +.highlight .gi { color: #859900 } /* Generic.Inserted */ +.highlight .go { color: #93a1a1 } /* Generic.Output */ +.highlight .gp { color: #93a1a1 } /* Generic.Prompt */ +.highlight .gs { color: #93a1a1; font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #cb4b16 } /* Generic.Subheading */ +.highlight .gt { color: #93a1a1 } /* Generic.Traceback */ +.highlight .kc { color: #cb4b16 } /* Keyword.Constant */ +.highlight .kd { color: #268bd2 } /* Keyword.Declaration */ +.highlight .kn { color: #859900 } /* Keyword.Namespace */ +.highlight .kp { color: #859900 } /* Keyword.Pseudo */ +.highlight .kr { color: #268bd2 } /* Keyword.Reserved */ +.highlight .kt { color: #dc322f } /* Keyword.Type */ +.highlight .ld { color: #93a1a1 } /* Literal.Date */ +.highlight .m { color: #2aa198 } /* Literal.Number */ +.highlight .s { color: #2aa198 } /* Literal.String */ +.highlight .na { color: #93a1a1 } /* Name.Attribute */ +.highlight .nb { color: #B58900 } /* Name.Builtin */ +.highlight .nc { color: #268bd2 } /* Name.Class */ +.highlight .no { color: #cb4b16 } /* Name.Constant */ +.highlight .nd { color: #268bd2 } /* Name.Decorator */ +.highlight .ni { color: #cb4b16 } /* Name.Entity */ +.highlight .ne { color: #cb4b16 } /* Name.Exception */ +.highlight .nf { color: #268bd2 } /* Name.Function */ +.highlight .nl { color: #93a1a1 } /* Name.Label */ +.highlight .nn { color: #93a1a1 } /* Name.Namespace */ +.highlight .nx { color: #93a1a1 } /* Name.Other */ +.highlight .py { color: #93a1a1 } /* Name.Property */ +.highlight .nt { color: #268bd2 } /* Name.Tag */ +.highlight .nv { color: #268bd2 } /* Name.Variable */ +.highlight .ow { color: #859900 } /* Operator.Word */ +.highlight .w { color: #93a1a1 } /* Text.Whitespace */ +.highlight .mf { color: #2aa198 } /* Literal.Number.Float */ +.highlight .mh { color: #2aa198 } /* Literal.Number.Hex */ +.highlight .mi { color: #2aa198 } /* Literal.Number.Integer */ +.highlight .mo { color: #2aa198 } /* Literal.Number.Oct */ +.highlight .sb { color: #586e75 } /* Literal.String.Backtick */ +.highlight .sc { color: #2aa198 } /* Literal.String.Char */ +.highlight .sd { color: #93a1a1 } /* Literal.String.Doc */ +.highlight .s2 { color: #2aa198 } /* Literal.String.Double */ +.highlight .se { color: #cb4b16 } /* Literal.String.Escape */ +.highlight .sh { color: #93a1a1 } /* Literal.String.Heredoc */ +.highlight .si { color: #2aa198 } /* Literal.String.Interpol */ +.highlight .sx { color: #2aa198 } /* Literal.String.Other */ +.highlight .sr { color: #dc322f } /* Literal.String.Regex */ +.highlight .s1 { color: #2aa198 } /* Literal.String.Single */ +.highlight .ss { color: #2aa198 } /* Literal.String.Symbol */ +.highlight .bp { color: #268bd2 } /* Name.Builtin.Pseudo */ +.highlight .vc { color: #268bd2 } /* Name.Variable.Class */ +.highlight .vg { color: #268bd2 } /* Name.Variable.Global */ +.highlight .vi { color: #268bd2 } /* Name.Variable.Instance */ +.highlight .il { color: #2aa198 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/output/theme/css/screen.css b/output/theme/css/screen.css new file mode 100644 index 0000000..9321a87 --- /dev/null +++ b/output/theme/css/screen.css @@ -0,0 +1,356 @@ +/* http://meyerweb.com/eric/tools/css/reset/ +v2.0 | 20110126 +License: none (public domain) + */ +/* Mockingbird Theme by Nevan Scott nevanscott.com */ +/* Modified by Jody Frankowski */ +/* Modified by ix5 */ +/* Modified by Pascal Le Merrer */ + +html, body, div, span, applet, object, iframe, +h1, h2, h3, h4, h5, h6, p, blockquote, pre, +a, abbr, acronym, address, big, cite, code, +del, dfn, em, img, ins, kbd, q, s, samp, +small, strike, strong, sub, sup, tt, var, +b, u, i, center, +dl, dt, dd, li, +fieldset, form, label, legend, +table, caption, tbody, tfoot, thead, tr, th, td, +article, aside, canvas, details, embed, +figure, figcaption, footer, header, hgroup, +menu, nav, output, ruby, section, summary, +time, mark, audio, video { + margin: 0; + padding: 0; + border: 0; + font-size: 100%; + font: inherit; + vertical-align: baseline; +} +em { + font-style: italic; +} +strong { + font-weight: bold; +} +/* HTML5 display-role reset for older browsers */ +article, aside, details, figcaption, figure, +footer, header, hgroup, menu, nav, section { + display: block; +} +body { + line-height: 1; +} +ol, ul { + list-style: none; +} +blockquote, q { + quotes: none; +} +blockquote:before, blockquote:after, +q:before, q:after { + content: ''; + content: none; +} +table { + border-collapse: collapse; + border-spacing: 0; +} + +body { + font-family: Georgia, serif; + font-size: 16px; + line-height: 1.5em; + color: #444; +} + +header, #wrapper { + padding: 0 10px; + min-width: 500px; + max-width: 910px; + margin: auto; +} + +a { + box-shadow: inset 0 0 0 0 #801515; + color: #801515; + padding: 0 .25rem; + margin: 0 -.25rem; + transition: color .3s ease-in-out, box-shadow .3s ease-in-out; +} + +a:hover { + color: #fff; + box-shadow: inset 800px 0 0 0 #801515; +} + +ul { + list-style: outside disc; +} + +ol { + list-style: outside decimal; +} + +h1, h2, h3, h4, h5, h6 { + font-family: sans-serif; + font-weight: bold; +} +h1, h2, h3 { + font-size: 1.5em; + line-height: 1em; + margin: 1em 0; +} + +img, p, .post > .highlight, .highlighttable, h4, h5, h6 { + margin-top: 1.2em; +} + +blockquote { + margin: 1.5em 1.5em 1.5em .75em; + padding-left: .75em; + border-left: 1px solid #EEE; +} + +.date { + color: #CCC; + float: left; + clear: both; + width: 130px; + font-size: 1.5em; + line-height: 1em; + margin: 0 20px 1em 0; +} + +.info { + margin-top: 1.3em; + font-family: sans-serif; + text-align: right; + color: #BBB; +} +.info a { + color: inherit; +} +.info a.tags { + background: #CCC; + color: #FFF; + display: inline-block; + padding: 0 .3em; + border: 1px transparent solid; + border-radius: 5px; + margin: 0 0 0.3em 0; +} +.info a.tags:hover { + background: inherit; + color: inherit; +} +.info a.tags.selected { + border: 1px #999 solid; +} + +.post { + margin: 0 0 4.5em 150px; +} +.post.archives { + margin-bottom: 1.5em; + margin-left: 160px; +} +.post p { + text-align: justify; +} + +.page { + margin: 0 90px; +} + +.highlight { + border-radius: 3px; +} +.code > .highlight { + border-radius: 0px 3px 3px 0px; +} +.linenos { + border-radius: 3px 0px 0px 3px; + background-color: #073642; + border-right: 1px solid #00232C; + color: #586E75; + text-shadow: 0px -1px #021014; +} +td.code { + width: 100%; + max-width: 100px; +} +.linenos a { + color: #586E75; +} + +img { + border-radius: 0.3em; + max-width: 100%; + display: block; + margin-left: auto; + margin-right: auto; + margin-top: 6rem; + margin-bottom: 6rem; +} + +/*sub and sup stolen from Twitter bootstrap.*/ +sub, sup { + position: relative; + font-size: 75%; + line-height: 0; + vertical-align: baseline; +} + +sup { + top: -0.5em; +} + +sub { + bottom: -0.25em; +} + +.post pre, .page pre { + padding: .8em; + font-size: 12px; + font-family: Monospace; + line-height: 1.1em; + overflow: auto; +} + +form.inline_edit { + clear: both; + margin: 4.5em 0; + background-color: #DDD; + color: #000; + padding: 20px; + border-radius: 5px; +} +.inline_edit .sub { + color: #888; + white-space: nowrap; +} +.inline_edit label { + float: left; + clear: both; + width: 140px; + margin-right: 20px; +} +.inline_edit .buttons { + display: block; + text-align: right; +} + +nav ul { + float: right; + list-style: none; + margin: 0 0 0 3em; + padding: 0; +} +nav li { + float: left; +} +nav a { + color: #801515; + display: block; + padding: 4.5em 10px 10px 10px; +} +nav a:hover { + color: #801515; + text-decoration: underline; + background-color: #d3d3d3; + color: #FFF; +} +nav li.selected a { + background-color: #801515; + color: #FFF; +} + +header .header_box { + padding-top: 4.5em; +} +header h1 { + font-size: 1.5em; + line-height: 1em; + margin: 0; +} +header h2 { + font-size: 1em; + margin: .3em 0; + color: #DDD; +} + +#content { + margin-top: 3em; +} + +.pages { + font-family: sans-serif; + line-height: 2.5em; + margin: 4.5em 0 3em; + background-color: #F9F9F9; + color: #444; + border-radius: 5px; +} +.pages a.next_page { + float: right; + width: 140px; + text-align: center; + border-top-right-radius: 5px; + border-bottom-right-radius: 5px; + background-color: #EEE; +} +.pages a.prev_page { + float: left; + width: 140px; + text-align: center; + border-top-left-radius: 5px; + border-bottom-left-radius: 5px; + background-color: #EEE; +} +.pages a { + color: inherit; + border: none; +} +.pages a:hover { + background-color: #DDD; +} + +.pages span { + display: block; + margin: 0 160px; + text-align: center; +} + +code { + background-color: #F9F2F4; + border-bottom-left-radius: 4px; + border-bottom-right-radius: 4px; + border-top-left-radius: 4px; + border-top-right-radius: 4px; + box-sizing: border-box; + color: #C7254E; + font-family: Monaco,Menlo,Consolas,"Courier New",monospace; + font-size: 12.6px; + line-height: 18px; + padding-bottom: 2px; + padding-left: 4px; + padding-right: 4px; + padding-top: 2px; + white-space: nowrap; +} + +footer { + font-family: sans-serif; + line-height: 2.5em; + text-align: center; + color: #BBB; + margin: 3em 0; + border: 1px solid #EEE; + border-radius: 5px; +} +footer p { margin: 0; } + +.right { float: right; } + +.clear { clear: both; } diff --git a/pelicanconf.py b/pelicanconf.py new file mode 100644 index 0000000..de33ec7 --- /dev/null +++ b/pelicanconf.py @@ -0,0 +1,45 @@ +AUTHOR = 'Pascal Le Merrer' +SITENAME = 'Craft Letter' +SITEURL = "https://www.craftletter.fr" + +PATH = "content" + +TIMEZONE = 'Europe/Paris' + +DEFAULT_LANG = 'fr' + +# Feed generation is usually not desired when developing +FEED_ALL_RSS = "feeds/all.rss.xml" +FEED_ALL_ATOM = None +CATEGORY_FEED_ATOM = None +TRANSLATION_FEED_ATOM = None +AUTHOR_FEED_ATOM = None +AUTHOR_FEED_RSS = None + +# Blogroll +LINKS = ( + ("S'abonner à la lettre de veille", "https://craftletter.sender.site"), +) + +# Social widget +SOCIAL = ( + ("Linkedin", "https://www.linkedin.com/in/pascal-le-merrer/"), + ("Mastodon", "https://mastodon.social/@pascal_le_merrer"), +) + +DEFAULT_PAGINATION = 10 + +# Uncomment following line if you want document-relative URLs when developing +# RELATIVE_URLS = True + +THEME = "themes/blue-penguin" + +JINJA_ENVIRONMENT = { + 'extensions': ['jinja2.ext.i18n'], +} + +STATIC_PATHS = ['images', 'robots.txt'] + +# SEO +SEO_ENHANCER_SITEMAP_URL = "https://www.craftletter.fr/sitemap.xml" +SEO_ENHANCER = True # SEO enhancer is disabled by default diff --git a/publishconf.py b/publishconf.py new file mode 100644 index 0000000..83b3308 --- /dev/null +++ b/publishconf.py @@ -0,0 +1,24 @@ +# This file is only used if you use `make publish` or +# explicitly specify it as your config file. + +import os +import sys + +sys.path.append(os.curdir) +from pelicanconf import * + +# If your site is available via HTTPS, make sure SITEURL begins with https:// +SITEURL = "https://www.craftletter.fr" +RELATIVE_URLS = False + +FEED_ALL_RSS = "feeds/all.rss.xml" +FEED_ALL_ATOM = None +CATEGORY_FEED_ATOM = None + +DELETE_OUTPUT_DIRECTORY = True + +# Following items are often useful when publishing + +# DISQUS_SITENAME = "" +# GOOGLE_ANALYTICS = "" + diff --git a/seo_report.html b/seo_report.html new file mode 100644 index 0000000..ccb4c63 --- /dev/null +++ b/seo_report.html @@ -0,0 +1,324 @@ + + + + SEO Report + + + + +
+

SEO report - Craft Letter

+
+ +
+ + +
+ +
+

lettre-ndeg2.html

+ + 2025-12-15 09:00 + +
+ + + +

Page title analysis

+ + + + + + + + + + + + + + + + + + + + + + +
GoodYou have declared a title. Nice job!
To improveYour title is too short. The recommended length is 70 characters.
+ + + +

Page description analysis

+ + + + + + + + + + + + + + + +
ProblemsYou need to declare a description to improve SEO.
+ + + +

Content title analysis

+ + + + + + + + + + + + + + + +
ProblemsYou're missing a content title.
+ + + +

Internal link analysis

+ + + + + + + + + + + + + + + +
GoodYou've included 1 internal links. Nice job!
+ + + +
+ +
+ +
+

lettre-ndeg1.html

+ + 2025-12-08 10:20 + +
+ + + +

Page title analysis

+ + + + + + + + + + + + + + + + + + + + + + +
GoodYou have declared a title. Nice job!
To improveYour title is too short. The recommended length is 70 characters.
+ + + +

Page description analysis

+ + + + + + + + + + + + + + + +
ProblemsYou need to declare a description to improve SEO.
+ + + +

Content title analysis

+ + + + + + + + + + + + + + + +
ProblemsYou're missing a content title.
+ + + +

Internal link analysis

+ + + + + + + + + + + + + + + +
ProblemsIt's better to include internal links.
+ + + +
+ +
+ +
+

+ + 2025-12-08 10:20 + +
+ + + +

Page title analysis

+ + + + + + + + + + + + + + + + + + + + + + +
GoodYou have declared a title. Nice job!
To improveYour title is too short. The recommended length is 70 characters.
+ + + +

Page description analysis

+ + + + + + + + + + + + + + + +
ProblemsYou need to declare a description to improve SEO.
+ + + +

Content title analysis

+ + + + + + + + + + + + + + + +
GoodYou have declared a content title. Nice job!
+ + + +

Internal link analysis

+ + + + + + + + + + + + + + + +
GoodYou've included 3 internal links. Nice job!
+ + + +
+ + +
+ + + + + \ No newline at end of file diff --git a/tasks.py b/tasks.py new file mode 100644 index 0000000..bed1437 --- /dev/null +++ b/tasks.py @@ -0,0 +1,145 @@ +import os +import shlex +import shutil +import sys + +from invoke import task +from invoke.main import program +from pelican import main as pelican_main +from pelican.server import ComplexHTTPRequestHandler, RootedHTTPServer +from pelican.settings import DEFAULT_CONFIG, get_settings_from_file + +OPEN_BROWSER_ON_SERVE = True +SETTINGS_FILE_BASE = "pelicanconf.py" +SETTINGS = {} +SETTINGS.update(DEFAULT_CONFIG) +LOCAL_SETTINGS = get_settings_from_file(SETTINGS_FILE_BASE) +SETTINGS.update(LOCAL_SETTINGS) + +CONFIG = { + "settings_base": SETTINGS_FILE_BASE, + "settings_publish": "publishconf.py", + # Output path. Can be absolute or relative to tasks.py. Default: 'output' + "deploy_path": SETTINGS["OUTPUT_PATH"], + # Host and port for `serve` + "host": "localhost", + "port": 8000, +} + + +@task +def clean(c): + """Remove generated files""" + if os.path.isdir(CONFIG["deploy_path"]): + shutil.rmtree(CONFIG["deploy_path"]) + os.makedirs(CONFIG["deploy_path"]) + + +@task +def build(c): + """Build local version of site""" + pelican_run("-s {settings_base}".format(**CONFIG)) + + +@task +def rebuild(c): + """`build` with the delete switch""" + pelican_run("-d -s {settings_base}".format(**CONFIG)) + + +@task +def regenerate(c): + """Automatically regenerate site upon file modification""" + pelican_run("-r -s {settings_base}".format(**CONFIG)) + + +@task +def serve(c): + """Serve site at http://$HOST:$PORT/ (default is localhost:8000)""" + + class AddressReuseTCPServer(RootedHTTPServer): + allow_reuse_address = True + + server = AddressReuseTCPServer( + CONFIG["deploy_path"], + (CONFIG["host"], CONFIG["port"]), + ComplexHTTPRequestHandler, + ) + + if OPEN_BROWSER_ON_SERVE: + # Open site in default browser + import webbrowser + + webbrowser.open("http://{host}:{port}".format(**CONFIG)) + + sys.stderr.write("Serving at {host}:{port} ...\n".format(**CONFIG)) + server.serve_forever() + + +@task +def reserve(c): + """`build`, then `serve`""" + build(c) + serve(c) + + +@task +def preview(c): + """Build production version of site""" + pelican_run("-s {settings_publish}".format(**CONFIG)) + +@task +def livereload(c): + """Automatically reload browser tab upon file modification.""" + from livereload import Server + + def cached_build(): + cmd = "-s {settings_base} -e CACHE_CONTENT=true LOAD_CONTENT_CACHE=true" + pelican_run(cmd.format(**CONFIG)) + + cached_build() + server = Server() + theme_path = SETTINGS["THEME"] + watched_globs = [ + CONFIG["settings_base"], + f"{theme_path}/templates/**/*.html", + ] + + content_file_extensions = [".md", ".rst"] + for extension in content_file_extensions: + content_glob = "{}/**/*{}".format(SETTINGS["PATH"], extension) + watched_globs.append(content_glob) + + static_file_extensions = [".css", ".js"] + for extension in static_file_extensions: + static_file_glob = f"{theme_path}/static/**/*{extension}" + watched_globs.append(static_file_glob) + + for glob in watched_globs: + server.watch(glob, cached_build) + + if OPEN_BROWSER_ON_SERVE: + # Open site in default browser + import webbrowser + + webbrowser.open("http://{host}:{port}".format(**CONFIG)) + + server.serve(host=CONFIG["host"], port=CONFIG["port"], root=CONFIG["deploy_path"]) + + +@task +def publish(c): + """Publish to production via rsync""" + pelican_run("-s {settings_publish}".format(**CONFIG)) + c.run( + 'rsync --delete --exclude ".DS_Store" -pthrvz -c ' + '-e "ssh -p {ssh_port}" ' + "{} {ssh_user}@{ssh_host}:{ssh_path}".format( + CONFIG["deploy_path"].rstrip("/") + "/", **CONFIG + ) + ) + + +def pelican_run(cmd): + cmd += " " + program.core.remainder # allows to pass-through args to pelican + pelican_main(shlex.split(cmd)) diff --git a/themes/.github/workflows/build-preview-site.yml b/themes/.github/workflows/build-preview-site.yml new file mode 100644 index 0000000..0759f56 --- /dev/null +++ b/themes/.github/workflows/build-preview-site.yml @@ -0,0 +1,76 @@ +name: Build pelican-themes preview site + +# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages +permissions: + contents: read + pages: write + id-token: write + +# Allow one concurrent deployment +concurrency: + group: "pages" + cancel-in-progress: true + +on: + # Triggers the workflow on push or pull request events but only for the "main" branch + push: + branches: [ "master" ] + # Allows you to run this workflow manually from the Actions tab + workflow_dispatch: + +jobs: + build: + runs-on: ubuntu-latest + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + + steps: + - name: Checkout repo + uses: actions/checkout@v3 + with: + fetch-depth: 1 + submodules: recursive + - name: Checkout pelican + uses: actions/checkout@v3 + with: + repository: getpelican/pelican + path: _pelican + fetch-depth: 1 + - name: Setup python-3.10 + uses: actions/setup-python@v4 + with: + python-version: "3.10" + - name: Cache Playwright browsers + uses: actions/cache@v3 + with: + path: ~/.cache/ms-playwright/ + key: ${{ runner.os }}-browsers + - name: Install pelican, plugins and shot-scraper + run: pip install pelican[markdown] pelican-webassets cssmin shot-scraper + - name: Setup shot-scraper + run: shot-scraper install + - name: Generate output + run: python build-theme-previews.py + + # Rsync to server hosting pelicanthemes.com + - name: Install SSH key + uses: shimataro/ssh-key-action@v2 + with: + key: ${{ secrets.SSH_PRIVATE_KEY }} + known_hosts: unnecessary + - name: Adding known hosts + run: ssh-keyscan -p 22 -H pelicanthemes.com >> ~/.ssh/known_hosts + - name: Deploy with rsync + run: rsync -avz ./_output/ deploy@pelicanthemes.com:~/roles/caddy/sites/pelicanthemes.com/ + + # Deploy to Github Pages + - name: Setup Pages + uses: actions/configure-pages@v2 + - name: Upload artifact + uses: actions/upload-pages-artifact@v1 + with: + path: '_output' + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v1 diff --git a/themes/.gitignore b/themes/.gitignore new file mode 100644 index 0000000..ba5436c --- /dev/null +++ b/themes/.gitignore @@ -0,0 +1,22 @@ +# OS generated files # +###################### +.DS_Store +.DS_Store? +._* +.Spotlight-V100 +.Trashes +Icon? +ehthumbs.db +Thumbs.db + +# Editor temp files # +##################### +.*~ +*~ +.swp +.*.swp + +# Preview artifacts # +##################### +_pelican +_output diff --git a/themes/.gitmodules b/themes/.gitmodules new file mode 100644 index 0000000..be5cfc5 --- /dev/null +++ b/themes/.gitmodules @@ -0,0 +1,272 @@ +[submodule "pelicanthemes-generator"] + path = pelicanthemes-generator + url = https://github.com/badele/pelicanthemes-generator.git +[submodule "Responsive-Pelican"] + path = Responsive-Pelican + url = https://github.com/ir193/Responsive-Pelican.git +[submodule "hauntr"] + path = hauntr + url = https://github.com/kura/hauntr.git +[submodule "ghastly"] + path = ghastly + url = https://github.com/kura/ghastly.git +[submodule "svbtle"] + path = svbtle + url = https://github.com/wting/pelican-svbtle.git +[submodule "chunk"] + path = chunk + url = https://github.com/tbunnyman/pelican-chunk.git +[submodule "iris"] + path = iris + url = https://github.com/slok/iris.git +[submodule "relapse"] + path = relapse + url = https://github.com/wamonite/relapse.git +[submodule "neat"] + path = neat + url = https://github.com/BYK/pelican-neat.git +[submodule "pelican-mockingbird"] + path = pelican-mockingbird + url = https://github.com/wrl/pelican-mockingbird.git +[submodule "bold"] + path = bold + url = https://github.com/demianbrecht/pelican-bold.git +[submodule "lannisport"] + path = lannisport + url = https://github.com/siovene/lannisport.git +[submodule "Editorial"] + path = Editorial + url = https://gitlab.com/Mimoza/editorial.git +[submodule "fresh"] + path = fresh + url = https://github.com/jsliang/pelican-fresh.git +[submodule "variant-note"] + path = pelican-variant-note + url = https://github.com/mpancorbo/pelican-variant-note.git +[submodule "water-iris"] + path = water-iris + url = https://github.com/jarv/water-iris.git +[submodule "whispers"] + path = whispersTheme + url = https://github.com/deBorn/whispersTheme.git +[submodule "bluegrasshopper"] + path = bluegrasshopper + url = https://github.com/gregseth/pelican-bgh.git +[submodule "pelican-cait"] + path = pelican-cait + url = https://github.com/hdra/pelican-cait.git +[submodule "irfan"] + path = irfan + url = https://github.com/erfaan/pelican-theme-irfan.git +[submodule "svbhack"] + path = svbhack + url = https://github.com/gfidente/pelican-svbhack.git +[submodule "html5-dopetrope"] + path = html5-dopetrope + url = https://github.com/PierrePaul/html5-dopetrope.git +[submodule "plumage"] + path = plumage + url = https://github.com/kdeldycke/plumage.git +[submodule "sundown"] + path = sundown + url = https://github.com/keningle/pelican-sundown.git +[submodule "crowsfoot"] + path = crowsfoot + url = https://github.com/porterjamesj/crowsfoot.git +[submodule "elegant"] + path = elegant + url = https://github.com/Pelican-Elegant/elegant.git + branch = master +[submodule "niu-x2"] + path = niu-x2 + url = https://github.com/wilbur-ma/niu-x2.git +[submodule "storm"] + path = storm + url = https://github.com/redVi/storm.git +[submodule "jesuislibre"] + path = jesuislibre + url = https://github.com/badele/pelican-theme-jesuislibre.git +[submodule "sora"] + path = sora + url = https://github.com/if1live/pelican-sora.git +[submodule "pelican-simplegrey"] + path = pelican-simplegrey + url = https://github.com/fle/pelican-simplegrey.git +[submodule "pujangga"] + path = pujangga + url = https://github.com/habibillah/pujangga.git +[submodule "lovers"] + path = lovers + url = https://github.com/chdoig/pelican-bootstrap3-lovers.git +[submodule "BT3-Flat"] + path = BT3-Flat + url = https://github.com/KenMercusLai/BT3-Flat.git +[submodule "voidy-bootstrap"] + path = voidy-bootstrap + url = https://github.com/robulouski/voidy-bootstrap.git +[submodule "burrito"] + path = burrito + url = https://github.com/fly/burrito.git +[submodule "maggner-pelican"] + path = maggner-pelican + url = https://github.com/kplaube/maggner-pelican.git +[submodule "pelican-sober"] + path = pelican-sober + url = https://github.com/fle/pelican-sober.git +[submodule "twenty-html5up"] + path = twenty-html5up + url = https://github.com/frankV/twenty-pelican-html5up.git +[submodule "lazystrap"] + path = lazystrap + url = https://github.com/lazycoder-ru/lazystrap.git +[submodule "pelican-twitchy"] + path = pelican-twitchy + url = https://github.com/ingwinlu/pelican-twitchy.git +[submodule "dev-random3"] + path = dev-random3 + url = https://github.com/22decembre/dev-random3.git +[submodule "blue-penguin"] + path = blue-penguin + url = https://github.com/jody-frankowski/blue-penguin.git +[submodule "nikhil-theme"] + path = nikhil-theme + url = https://github.com/gunchu/nikhil-theme.git +[submodule "chameleon"] + path = chameleon + url = https://github.com/yuex/pelican-iliork.git +[submodule "mg"] + path = mg + url = https://github.com/lucachr/pelican-mg.git +[submodule "martin-pelican"] + path = martin-pelican + url = https://github.com/cpaulik/martin-pelican.git +[submodule "nest"] + path = nest + url = https://github.com/molivier/nest.git +[submodule "alchemy"] + path = alchemy + url = https://github.com/nairobilug/pelican-alchemy.git +[submodule "pjport"] + path = pjport + url = https://github.com/xm3ron/pjport.git +[submodule "cid"] + path = cid + url = https://github.com/hdra/Pelican-Cid.git +[submodule "Flex"] + path = Flex + url = https://github.com/alexandrevicenzi/Flex.git +[submodule "octopress"] + path = octopress + url = https://github.com/MrSenko/pelican-octopress-theme +[submodule "smoothie"] + path = smoothie + url = https://github.com/kdheepak89/pelican-smoothie.git +[submodule "material"] + path = material + url = https://github.com/greizgh/pelican-material.git +[submodule "w3-personal-blog"] + path = w3-personal-blog + url = https://github.com/samael500/w3-personal-blog.git +[submodule "free-agent"] + path = free-agent + url = https://github.com/callmefish/pelican-free-agent.git +[submodule "mediumfox"] + path = mediumfox + url = https://github.com/cprieto/pelican-mediumfox.git +[submodule "medius"] + path = medius + url = https://github.com/onuraslan/medius.git +[submodule "materialistic"] + path = materialistic + url = https://github.com/eswarm/materialistic-pelican.git +[submodule "hyde"] + path = hyde + url = https://github.com/jvanz/pelican-hyde.git +[submodule "clean-blog"] + path = clean-blog + url = https://github.com/gilsondev/pelican-clean-blog.git +[submodule "semantic-ui"] + path = semantic-ui + url = https://github.com/ellisonleao/pelican-semantic-ui.git +[submodule "yapeme"] + path = yapeme + url = https://github.com/kplaube/yapeme.git +[submodule "pelican-blue"] + path = pelican-blue + url = https://github.com/Parbhat/pelican-blue.git +[submodule "pelican-hss"] + path = pelican-hss + url = https://github.com/laughk/pelican-hss.git +[submodule "nice-blog"] + path = nice-blog + url = https://github.com/guilherme-toti/nice-blog.git +[submodule "apricot"] + path = apricot + url = https://github.com/livibetter-backup/apricot.git +[submodule "eevee"] + path = eevee + url = https://github.com/kura/eevee.git +[submodule "voce"] + path = voce + url = https://github.com/limbenjamin/voce.git +[submodule "genus"] + path = genus + url = https://github.com/vaiski/genus.git +[submodule "attila"] + path = attila + url = https://github.com/arulrajnet/attila +[submodule "bulrush"] + path = bulrush + url = https://github.com/textbook/bulrush.git +[submodule "jojo"] + path = jojo + url = https://github.com/dokelung/jojo.git +[submodule "supersimple"] + path = supersimple + url = https://github.com/hlrossato/supersimple.git +[submodule "resume"] + path = resume + url = https://github.com/suheb/resume.git +[submodule "taman"] + path = taman + url = https://github.com/karambir/taman.git +[submodule "MinimalXY"] + path = MinimalXY + url = https://github.com/petrnohejl/MinimalXY.git +[submodule "pelican-fh5co-marble"] + path = pelican-fh5co-marble + url = https://github.com/claudio-walser/pelican-fh5co-marble.git +[submodule "grid-focus"] + path = grid-focus + url = https://github.com/oulenz/pelican-grid-focus.git +[submodule "brutalist"] + path = brutalist + url = https://github.com/mamcmanus/brutalist.git +[submodule "simplify-theme"] + path = simplify-theme + url = https://github.com/vuquangtrong/simplify-theme.git +[submodule "buruma"] + path = buruma + url = https://github.com/ivanhercaz/buruma.git + branch = pelican-themes +[submodule "pelican-b-side"] + path = pelican-b-side + url = https://gitlab.com/jhauh/pelican_b_side.git +[submodule "stirring"] + path = stirring + url = https://github.com/hansliu/pelican-stirring.git +[submodule "Papyrus"] + path = Papyrus + url = https://github.com/aleylara/Papyrus +[submodule "blue-penguin-dark"] + path = blue-penguin-dark + url = https://github.com/tcarwash/blue-penguin-dark.git +[submodule "pelican-haerwu-theme"] + path = pelican-haerwu-theme + url = https://github.com/hrw/pelican-haerwu-theme.git +[submodule "Piccolo"] + path = piccolo + url = https://github.com/iamjameswalters/piccolo.git +[submodule "WhatsTheScoop"] + path = WhatsTheScoop + url = git@github.com:SarahRogue81/WhatsTheScoop.git diff --git a/themes/blue-penguin/CONTRIBUTORS.md b/themes/blue-penguin/CONTRIBUTORS.md new file mode 100644 index 0000000..56da1f2 --- /dev/null +++ b/themes/blue-penguin/CONTRIBUTORS.md @@ -0,0 +1,17 @@ +# Contributors + +* [Nevan Scott](https://github.com/nevanscott/Mockingbird) (original author) +* [wrl](http://ghttps://github.com/guikcdithub.com/wrl) (port to pelican, pelican-mockingbird) +* [Jody Frankowski](http://github.com/jody-frankowski) (Blue Penguin) +* [Grimbox](https://github.com/Grimbox) +* [ix5](https://github.com/ix5) +* [dn0](https://github.com/dn0) +* [anhtuann](https://github.com/anhtuann) +* [aperep](https://github.com/aperep) +* [iranzo](https://github.com/iranzo) +* [thetlk](https://github.com/thetlk) +* [SnorlaxYum](https://github.com/SnorlaxYum) +* [guikcd](https://github.com/guikcd) +* [jorgesumle](https://github.com/jorgesumle) +* [crxxn](https://github.com/crxxn) +* [Pascal Le Merrer](https://www.craftletter.fr) diff --git a/themes/blue-penguin/README.md b/themes/blue-penguin/README.md new file mode 100644 index 0000000..831bfc3 --- /dev/null +++ b/themes/blue-penguin/README.md @@ -0,0 +1,53 @@ +![screenshot](screenshot.png) + +# Blue Penguin for pelican +A simple theme for pelican. Solarized pygments. Feeds support. + +## Settings +```python +# all the following settings are *optional* + +# HTML metadata +SITEDESCRIPTION = '' + +# all defaults to True. +DISPLAY_HEADER = True +DISPLAY_FOOTER = True +DISPLAY_HOME = True +DISPLAY_MENU = True + +# provided as examples, they make ‘clean’ urls. used by MENU_INTERNAL_PAGES. +TAGS_URL = 'tags' +TAGS_SAVE_AS = 'tags/index.html' +AUTHORS_URL = 'authors' +AUTHORS_SAVE_AS = 'authors/index.html' +CATEGORIES_URL = 'categories' +CATEGORIES_SAVE_AS = 'categories/index.html' +ARCHIVES_URL = 'archives' +ARCHIVES_SAVE_AS = 'archives/index.html' + +# use those if you want pelican standard pages to appear in your menu +MENU_INTERNAL_PAGES = ( + ('Tags', TAGS_URL, TAGS_SAVE_AS), + ('Authors', AUTHORS_URL, AUTHORS_SAVE_AS), + ('Categories', CATEGORIES_URL, CATEGORIES_SAVE_AS), + ('Archives', ARCHIVES_URL, ARCHIVES_SAVE_AS), +) +# additional menu items +MENUITEMS = ( + ('GitHub', 'https://github.com/'), + ('Linux Kernel', 'https://www.kernel.org/'), +) +``` + +## How to contribute +Contributions are very welcome. Keep in mind that this theme goal is to be +minimalistic/simple. Contributions will be accepted through Github Pull +Requests. If you don’t have a Github account you can suggest me your +changes by email (which you can find on my github profile). + +## Contributors +See [CONTRIBUTORS.md](CONTRIBUTORS.md). + +## License +Public domain. diff --git a/themes/blue-penguin/screenshot.png b/themes/blue-penguin/screenshot.png new file mode 100644 index 0000000..fc5c406 Binary files /dev/null and b/themes/blue-penguin/screenshot.png differ diff --git a/themes/blue-penguin/static/css/print.css b/themes/blue-penguin/static/css/print.css new file mode 100644 index 0000000..c63a87b --- /dev/null +++ b/themes/blue-penguin/static/css/print.css @@ -0,0 +1,4 @@ +* { background: #fff; } +body { font-family: georgia, times, serif; color: black; } +blockquote { font-style: italic; color: black; } +a:link, a:visited { border-bottom-width: 1px; border-bottom-style: solid; } diff --git a/themes/blue-penguin/static/css/pygments.css b/themes/blue-penguin/static/css/pygments.css new file mode 100644 index 0000000..91ae326 --- /dev/null +++ b/themes/blue-penguin/static/css/pygments.css @@ -0,0 +1,87 @@ +/* Solarized Dark + +For use with Jekyll and Pygments + +http://ethanschoonover.com/solarized + +SOLARIZED HEX ROLE +--------- -------- ------------------------------------------ +base03 #002b36 background +base01 #586e75 comments / secondary content +base1 #93a1a1 body text / default code / primary content +orange #cb4b16 constants +red #dc322f regex, special keywords +blue #268bd2 reserved keywords +cyan #2aa198 strings, numbers +green #859900 operators, other keywords +*/ + +.highlight { background-color: #002b36; color: #93a1a1 } +.highlight .c { color: #586e75 } /* Comment */ +.highlight .err { color: #93a1a1 } /* Error */ +.highlight .g { color: #93a1a1 } /* Generic */ +.highlight .k { color: #859900 } /* Keyword */ +.highlight .l { color: #93a1a1 } /* Literal */ +.highlight .n { color: #93a1a1 } /* Name */ +.highlight .o { color: #859900 } /* Operator */ +.highlight .x { color: #cb4b16 } /* Other */ +.highlight .p { color: #93a1a1 } /* Punctuation */ +.highlight .cm { color: #586e75 } /* Comment.Multiline */ +.highlight .cp { color: #859900 } /* Comment.Preproc */ +.highlight .c1 { color: #586e75 } /* Comment.Single */ +.highlight .cs { color: #859900 } /* Comment.Special */ +.highlight .gd { color: #2aa198 } /* Generic.Deleted */ +.highlight .ge { color: #93a1a1; font-style: italic } /* Generic.Emph */ +.highlight .gr { color: #dc322f } /* Generic.Error */ +.highlight .gh { color: #cb4b16 } /* Generic.Heading */ +.highlight .gi { color: #859900 } /* Generic.Inserted */ +.highlight .go { color: #93a1a1 } /* Generic.Output */ +.highlight .gp { color: #93a1a1 } /* Generic.Prompt */ +.highlight .gs { color: #93a1a1; font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #cb4b16 } /* Generic.Subheading */ +.highlight .gt { color: #93a1a1 } /* Generic.Traceback */ +.highlight .kc { color: #cb4b16 } /* Keyword.Constant */ +.highlight .kd { color: #268bd2 } /* Keyword.Declaration */ +.highlight .kn { color: #859900 } /* Keyword.Namespace */ +.highlight .kp { color: #859900 } /* Keyword.Pseudo */ +.highlight .kr { color: #268bd2 } /* Keyword.Reserved */ +.highlight .kt { color: #dc322f } /* Keyword.Type */ +.highlight .ld { color: #93a1a1 } /* Literal.Date */ +.highlight .m { color: #2aa198 } /* Literal.Number */ +.highlight .s { color: #2aa198 } /* Literal.String */ +.highlight .na { color: #93a1a1 } /* Name.Attribute */ +.highlight .nb { color: #B58900 } /* Name.Builtin */ +.highlight .nc { color: #268bd2 } /* Name.Class */ +.highlight .no { color: #cb4b16 } /* Name.Constant */ +.highlight .nd { color: #268bd2 } /* Name.Decorator */ +.highlight .ni { color: #cb4b16 } /* Name.Entity */ +.highlight .ne { color: #cb4b16 } /* Name.Exception */ +.highlight .nf { color: #268bd2 } /* Name.Function */ +.highlight .nl { color: #93a1a1 } /* Name.Label */ +.highlight .nn { color: #93a1a1 } /* Name.Namespace */ +.highlight .nx { color: #93a1a1 } /* Name.Other */ +.highlight .py { color: #93a1a1 } /* Name.Property */ +.highlight .nt { color: #268bd2 } /* Name.Tag */ +.highlight .nv { color: #268bd2 } /* Name.Variable */ +.highlight .ow { color: #859900 } /* Operator.Word */ +.highlight .w { color: #93a1a1 } /* Text.Whitespace */ +.highlight .mf { color: #2aa198 } /* Literal.Number.Float */ +.highlight .mh { color: #2aa198 } /* Literal.Number.Hex */ +.highlight .mi { color: #2aa198 } /* Literal.Number.Integer */ +.highlight .mo { color: #2aa198 } /* Literal.Number.Oct */ +.highlight .sb { color: #586e75 } /* Literal.String.Backtick */ +.highlight .sc { color: #2aa198 } /* Literal.String.Char */ +.highlight .sd { color: #93a1a1 } /* Literal.String.Doc */ +.highlight .s2 { color: #2aa198 } /* Literal.String.Double */ +.highlight .se { color: #cb4b16 } /* Literal.String.Escape */ +.highlight .sh { color: #93a1a1 } /* Literal.String.Heredoc */ +.highlight .si { color: #2aa198 } /* Literal.String.Interpol */ +.highlight .sx { color: #2aa198 } /* Literal.String.Other */ +.highlight .sr { color: #dc322f } /* Literal.String.Regex */ +.highlight .s1 { color: #2aa198 } /* Literal.String.Single */ +.highlight .ss { color: #2aa198 } /* Literal.String.Symbol */ +.highlight .bp { color: #268bd2 } /* Name.Builtin.Pseudo */ +.highlight .vc { color: #268bd2 } /* Name.Variable.Class */ +.highlight .vg { color: #268bd2 } /* Name.Variable.Global */ +.highlight .vi { color: #268bd2 } /* Name.Variable.Instance */ +.highlight .il { color: #2aa198 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/themes/blue-penguin/static/css/screen.css b/themes/blue-penguin/static/css/screen.css new file mode 100644 index 0000000..9321a87 --- /dev/null +++ b/themes/blue-penguin/static/css/screen.css @@ -0,0 +1,356 @@ +/* http://meyerweb.com/eric/tools/css/reset/ +v2.0 | 20110126 +License: none (public domain) + */ +/* Mockingbird Theme by Nevan Scott nevanscott.com */ +/* Modified by Jody Frankowski */ +/* Modified by ix5 */ +/* Modified by Pascal Le Merrer */ + +html, body, div, span, applet, object, iframe, +h1, h2, h3, h4, h5, h6, p, blockquote, pre, +a, abbr, acronym, address, big, cite, code, +del, dfn, em, img, ins, kbd, q, s, samp, +small, strike, strong, sub, sup, tt, var, +b, u, i, center, +dl, dt, dd, li, +fieldset, form, label, legend, +table, caption, tbody, tfoot, thead, tr, th, td, +article, aside, canvas, details, embed, +figure, figcaption, footer, header, hgroup, +menu, nav, output, ruby, section, summary, +time, mark, audio, video { + margin: 0; + padding: 0; + border: 0; + font-size: 100%; + font: inherit; + vertical-align: baseline; +} +em { + font-style: italic; +} +strong { + font-weight: bold; +} +/* HTML5 display-role reset for older browsers */ +article, aside, details, figcaption, figure, +footer, header, hgroup, menu, nav, section { + display: block; +} +body { + line-height: 1; +} +ol, ul { + list-style: none; +} +blockquote, q { + quotes: none; +} +blockquote:before, blockquote:after, +q:before, q:after { + content: ''; + content: none; +} +table { + border-collapse: collapse; + border-spacing: 0; +} + +body { + font-family: Georgia, serif; + font-size: 16px; + line-height: 1.5em; + color: #444; +} + +header, #wrapper { + padding: 0 10px; + min-width: 500px; + max-width: 910px; + margin: auto; +} + +a { + box-shadow: inset 0 0 0 0 #801515; + color: #801515; + padding: 0 .25rem; + margin: 0 -.25rem; + transition: color .3s ease-in-out, box-shadow .3s ease-in-out; +} + +a:hover { + color: #fff; + box-shadow: inset 800px 0 0 0 #801515; +} + +ul { + list-style: outside disc; +} + +ol { + list-style: outside decimal; +} + +h1, h2, h3, h4, h5, h6 { + font-family: sans-serif; + font-weight: bold; +} +h1, h2, h3 { + font-size: 1.5em; + line-height: 1em; + margin: 1em 0; +} + +img, p, .post > .highlight, .highlighttable, h4, h5, h6 { + margin-top: 1.2em; +} + +blockquote { + margin: 1.5em 1.5em 1.5em .75em; + padding-left: .75em; + border-left: 1px solid #EEE; +} + +.date { + color: #CCC; + float: left; + clear: both; + width: 130px; + font-size: 1.5em; + line-height: 1em; + margin: 0 20px 1em 0; +} + +.info { + margin-top: 1.3em; + font-family: sans-serif; + text-align: right; + color: #BBB; +} +.info a { + color: inherit; +} +.info a.tags { + background: #CCC; + color: #FFF; + display: inline-block; + padding: 0 .3em; + border: 1px transparent solid; + border-radius: 5px; + margin: 0 0 0.3em 0; +} +.info a.tags:hover { + background: inherit; + color: inherit; +} +.info a.tags.selected { + border: 1px #999 solid; +} + +.post { + margin: 0 0 4.5em 150px; +} +.post.archives { + margin-bottom: 1.5em; + margin-left: 160px; +} +.post p { + text-align: justify; +} + +.page { + margin: 0 90px; +} + +.highlight { + border-radius: 3px; +} +.code > .highlight { + border-radius: 0px 3px 3px 0px; +} +.linenos { + border-radius: 3px 0px 0px 3px; + background-color: #073642; + border-right: 1px solid #00232C; + color: #586E75; + text-shadow: 0px -1px #021014; +} +td.code { + width: 100%; + max-width: 100px; +} +.linenos a { + color: #586E75; +} + +img { + border-radius: 0.3em; + max-width: 100%; + display: block; + margin-left: auto; + margin-right: auto; + margin-top: 6rem; + margin-bottom: 6rem; +} + +/*sub and sup stolen from Twitter bootstrap.*/ +sub, sup { + position: relative; + font-size: 75%; + line-height: 0; + vertical-align: baseline; +} + +sup { + top: -0.5em; +} + +sub { + bottom: -0.25em; +} + +.post pre, .page pre { + padding: .8em; + font-size: 12px; + font-family: Monospace; + line-height: 1.1em; + overflow: auto; +} + +form.inline_edit { + clear: both; + margin: 4.5em 0; + background-color: #DDD; + color: #000; + padding: 20px; + border-radius: 5px; +} +.inline_edit .sub { + color: #888; + white-space: nowrap; +} +.inline_edit label { + float: left; + clear: both; + width: 140px; + margin-right: 20px; +} +.inline_edit .buttons { + display: block; + text-align: right; +} + +nav ul { + float: right; + list-style: none; + margin: 0 0 0 3em; + padding: 0; +} +nav li { + float: left; +} +nav a { + color: #801515; + display: block; + padding: 4.5em 10px 10px 10px; +} +nav a:hover { + color: #801515; + text-decoration: underline; + background-color: #d3d3d3; + color: #FFF; +} +nav li.selected a { + background-color: #801515; + color: #FFF; +} + +header .header_box { + padding-top: 4.5em; +} +header h1 { + font-size: 1.5em; + line-height: 1em; + margin: 0; +} +header h2 { + font-size: 1em; + margin: .3em 0; + color: #DDD; +} + +#content { + margin-top: 3em; +} + +.pages { + font-family: sans-serif; + line-height: 2.5em; + margin: 4.5em 0 3em; + background-color: #F9F9F9; + color: #444; + border-radius: 5px; +} +.pages a.next_page { + float: right; + width: 140px; + text-align: center; + border-top-right-radius: 5px; + border-bottom-right-radius: 5px; + background-color: #EEE; +} +.pages a.prev_page { + float: left; + width: 140px; + text-align: center; + border-top-left-radius: 5px; + border-bottom-left-radius: 5px; + background-color: #EEE; +} +.pages a { + color: inherit; + border: none; +} +.pages a:hover { + background-color: #DDD; +} + +.pages span { + display: block; + margin: 0 160px; + text-align: center; +} + +code { + background-color: #F9F2F4; + border-bottom-left-radius: 4px; + border-bottom-right-radius: 4px; + border-top-left-radius: 4px; + border-top-right-radius: 4px; + box-sizing: border-box; + color: #C7254E; + font-family: Monaco,Menlo,Consolas,"Courier New",monospace; + font-size: 12.6px; + line-height: 18px; + padding-bottom: 2px; + padding-left: 4px; + padding-right: 4px; + padding-top: 2px; + white-space: nowrap; +} + +footer { + font-family: sans-serif; + line-height: 2.5em; + text-align: center; + color: #BBB; + margin: 3em 0; + border: 1px solid #EEE; + border-radius: 5px; +} +footer p { margin: 0; } + +.right { float: right; } + +.clear { clear: both; } diff --git a/themes/blue-penguin/templates/analytics.html b/themes/blue-penguin/templates/analytics.html new file mode 100644 index 0000000..ba174fc --- /dev/null +++ b/themes/blue-penguin/templates/analytics.html @@ -0,0 +1,11 @@ +{% if GOOGLE_ANALYTICS %} + + +{% endif %} \ No newline at end of file diff --git a/themes/blue-penguin/templates/archives.html b/themes/blue-penguin/templates/archives.html new file mode 100644 index 0000000..73c53ba --- /dev/null +++ b/themes/blue-penguin/templates/archives.html @@ -0,0 +1,22 @@ +{% extends "base.html" %} + +{% block title %}{{ SITENAME }} | Archives{% endblock %} +{% block content %} + +

Archives

+ + {# based on http://stackoverflow.com/questions/12764291/jinja2-group-by-month-year #} + + {% for year, year_group in dates|groupby('date.year')|reverse %} + {% for month, month_group in year_group|groupby('date.month')|reverse %} +

{{ (month_group|first).date|strftime('%b %Y') }}

+
+ +
+ {% endfor %} + {% endfor %} +{% endblock %} diff --git a/themes/blue-penguin/templates/article.html b/themes/blue-penguin/templates/article.html new file mode 100644 index 0000000..d8e7071 --- /dev/null +++ b/themes/blue-penguin/templates/article.html @@ -0,0 +1,17 @@ +{% extends "base.html" %} + +{% block head %} + {{ super() }} + {% if article.tags %} + + {% endif %} + {% if article.description %} + + {% endif %} +{% endblock %} + +{% block title %}{{ SITENAME }} | {{ article.title }}{% endblock %} + +{% block content %} +{% include "article_stub.html" %} +{% endblock %} diff --git a/themes/blue-penguin/templates/article_stub.html b/themes/blue-penguin/templates/article_stub.html new file mode 100644 index 0000000..eb32852 --- /dev/null +++ b/themes/blue-penguin/templates/article_stub.html @@ -0,0 +1,37 @@ + {% if not articles_page or first_article_of_day %} +

{{ article.date.strftime("%d %b %Y") }}

+ {% endif %} + +
+ {% if article.title %} +

+ {{ article.title }} +

+ {% endif %} + + {% if not articles_page %} + {% include "translations.html" %} + {% endif %} + + + {{ article.content }} +
+ +
+ Publié à {{ article.date.strftime("%H:%M") }} + {% if article.category.name != "misc" %} +  ·  + {% endif %} + {% if article.tags %} +  · + {% for t in article.tags %} +  {{ t }} + {% endfor %} + {% endif %} +
+ {% if articles_page and DISQUS_SITENAME %} + Click to read and post comments + {% else %} + {% include "disqus.html" %} + {% endif %} +
diff --git a/themes/blue-penguin/templates/author.html b/themes/blue-penguin/templates/author.html new file mode 100644 index 0000000..b9ff61e --- /dev/null +++ b/themes/blue-penguin/templates/author.html @@ -0,0 +1,7 @@ +{% extends "index.html" %} + +{% block title %}{{ SITENAME }} | Articles by {{ author }}{% endblock %} +{% block ephemeral_nav %} + + {{ ephemeral_nav_link(author, output_file, True) }} +{% endblock %} diff --git a/themes/blue-penguin/templates/base.html b/themes/blue-penguin/templates/base.html new file mode 100644 index 0000000..fd01780 --- /dev/null +++ b/themes/blue-penguin/templates/base.html @@ -0,0 +1,105 @@ +{% macro ephemeral_nav_link(what, where, selected=False) -%} +
  • {{what}}
  • +{%- endmacro -%} + + + + + {% block head %} + + + {% block title %}{{ SITENAME }}{% endblock title %} + {# favicon #} + + + {% if FEED_ALL_ATOM %} + + {% endif %} + {% if FEED_ALL_RSS %} + + {% endif %} + {% if FEED_ATOM %} + + {% endif %} + {% if FEED_RSS %} + + {% endif %} + {% if CATEGORY_FEED_ATOM and category %} + + {% endif %} + {% if CATEGORY_FEED_RSS and category %} + + {% endif %} + {% if TAG_FEED_ATOM and tag %} + + {% endif %} + {% if TAG_FEED_RSS and tag %} + + {% endif %} + + + + + + + {% endblock head %} + + + {% if DISPLAY_HEADER or DISPLAY_HEADER is not defined %} +
    + {% if DISPLAY_MENU or DISPLAY_MENU is not defined %} + + {% endif %} +
    +

    {{ SITENAME }}

    + {% if SITESUBTITLE %} +

    {{ SITESUBTITLE }}

    + {% endif %} +
    +
    + {% endif %} +
    +
    + {%- block content -%}{%- endblock %} + + {% if DISPLAY_FOOTER or DISPLAY_FOOTER is not defined %} +
    + + {% endif %} +
    +
    +
    +{% include 'analytics.html' %} + + diff --git a/themes/blue-penguin/templates/category.html b/themes/blue-penguin/templates/category.html new file mode 100644 index 0000000..6587d98 --- /dev/null +++ b/themes/blue-penguin/templates/category.html @@ -0,0 +1,6 @@ +{% extends "index.html" %} +{% block title %}{{ SITENAME }} | articles in the "{{ category }}" category{% if articles_page.number != 1 %} | Page {{ articles_page.number }}{% endif %}{% endblock %} +{% block ephemeral_nav %} + + {{ ephemeral_nav_link(category, output_file, True) }} +{% endblock %} diff --git a/themes/blue-penguin/templates/disqus.html b/themes/blue-penguin/templates/disqus.html new file mode 100644 index 0000000..b4093e5 --- /dev/null +++ b/themes/blue-penguin/templates/disqus.html @@ -0,0 +1,12 @@ +{% if DISQUS_SITENAME %} +
    + + +{% endif %} diff --git a/themes/blue-penguin/templates/index.html b/themes/blue-penguin/templates/index.html new file mode 100644 index 0000000..b8b40f4 --- /dev/null +++ b/themes/blue-penguin/templates/index.html @@ -0,0 +1,17 @@ +{% extends "base.html" %} + +{% block title %}{{ SITENAME }}{% if articles_page.number != 1 %} | Page {{ articles_page.number }}{% endif %}{% endblock %} +{% block content %} +{% set date = None %} +{% for article in articles_page.object_list %} +{% if date != article.date.date() %} +{% set first_article_of_day = True %} +{% else %} +{% set first_article_of_day = False %} +{% endif %} +{% set date = article.date.date() %} +{% include "article_stub.html" %} +{% endfor %} + +{% include "pagination.html" %} +{% endblock %} diff --git a/themes/blue-penguin/templates/page.html b/themes/blue-penguin/templates/page.html new file mode 100644 index 0000000..c285678 --- /dev/null +++ b/themes/blue-penguin/templates/page.html @@ -0,0 +1,11 @@ +{% extends "base.html" %} + +{% block title %}{{ SITENAME }} | {{ page.title }}{% endblock %} + +{% block content %} + +
    +

    {{ page.title }}

    + {{ page.content }} +
    +{% endblock %} diff --git a/themes/blue-penguin/templates/pagination.html b/themes/blue-penguin/templates/pagination.html new file mode 100644 index 0000000..69eac10 --- /dev/null +++ b/themes/blue-penguin/templates/pagination.html @@ -0,0 +1,38 @@ +{# Use PAGINATION_PATTERNS or pagination may break #} +{% if DEFAULT_PAGINATION and (articles_page.has_previous() or articles_page.has_next()) %} + +
    +
    + {% if PAGINATION_PATTERNS[0][0] != 0 %} + {%- if articles_page.has_previous() %} + {% if articles_page.previous_page_number() == 1 %} + + ← Previous + {%- else %} + + ← Previous + {%- endif %} + {%- endif %} + {%- if articles_page.has_next() %} + + Next → + {%- endif %} + {% else %} + {%- if articles_page.has_previous() %} + {% if articles_page.previous_page_number() == 1 %} + + ← Previous + {%- else %} + + ← Previous + {%- endif %} + {%- endif %} + {%- if articles_page.has_next() %} + + Next → + {%- endif %} + {% endif %} + + Page {{ articles_page.number }} of {{ articles_paginator.num_pages }} +
    +{% endif %} diff --git a/themes/blue-penguin/templates/tag.html b/themes/blue-penguin/templates/tag.html new file mode 100644 index 0000000..92c3439 --- /dev/null +++ b/themes/blue-penguin/templates/tag.html @@ -0,0 +1,5 @@ +{% extends "index.html" %} +{% block title %}{{ SITENAME }} | articles tagged "{{ tag }}"{% if articles_page.number != 1 %} | Page {{ articles_page.number }}{% endif %}{% endblock %} +{% block ephemeral_nav %} + {{ ephemeral_nav_link(tag, output_file, True) }} +{% endblock %} diff --git a/themes/blue-penguin/templates/tags.html b/themes/blue-penguin/templates/tags.html new file mode 100644 index 0000000..ac65722 --- /dev/null +++ b/themes/blue-penguin/templates/tags.html @@ -0,0 +1,8 @@ +{% extends "base.html" %} +{% block content %} + +{% endblock %} diff --git a/themes/blue-penguin/templates/translations.html b/themes/blue-penguin/templates/translations.html new file mode 100644 index 0000000..f0a0fa2 --- /dev/null +++ b/themes/blue-penguin/templates/translations.html @@ -0,0 +1,6 @@ +{% if article.translations %} +Translations: + {% for translation in article.translations %} + {{ translation.lang }} + {% endfor %} +{% endif %} \ No newline at end of file