blogtini

blogtini

Diapositives / présentation

https://traceypooh.github.io/slides/dweb-2022 (exposé de Tracey sur https://dwebcamp.org)

Site en direct sur :

• https://blogtini.com
• https://traceypooh.github.io/blogtini/

Crochets

• Chaque fois que vous créez ou supprimez une publication, nous souhaitons que votre sitemap soit mis à jour.
• Chaque fois que quelqu'un commente votre site, nous exécutons un petit script.

Ainsi, nous vous suggérons d'utiliser nos « hooks » git « pré-commit » et « post-fusion » pour automatiser le « ménage » ci-dessus. Vous pouvez les configurer comme ceci :

git config --local core.hooksPath bin/

RSS

Si vous souhaitez un fichier RSS index.xml généré avec le script bin/sitemap, lors de chaque hook "pre commit" (ci-dessus), vous devrez avoir le script yq installé sur votre machine.

Les deux meilleures options de configuration de site Web/blog

Référentiel source de blog qui utilise le markdown dans les fichiers de balisage HTML

• /2022/01/j'ai-cuit-une-tarte/
• /2022/01/i-baked-a-pie/index.html
  • commencer par la première partie
    • y compris comment: <script src="../theme.js" type="module" charset="utf-8"></script>
  • vous pouvez alors avoir la belle url https://example.com/2022/01/i-baked-a-pie/ où le JS inclus transforme le markdown en balisage
• votre /sitemap.xml peut référencer chacune de vos URL de répertoire
• gérez votre /sitemap.xml manuellement ou exécutez le script /bin/sitemap chaque fois que vous créez ou supprimez une publication. Le script /bin/sitemap peut être trouvé sur le site blogtini.
• demandez à /theme.js d' import le thème que vous désirez

Référentiel source de blog qui utilise des fichiers markdown

• /2022/01/i-baked-a-pie.md
  • jekyll transformera automatiquement votre démarque en balisage et en une URL comme https://example.com/2022/01/i-baked-a-pie.html
  • tracey travaille avec jekyll pour obtenir les URL https://example.com/2022/01/i-baked-a-pie.md afin qu'elles soient également copiées textuellement à partir de votre source - afin que la démarque originale avec les éléments préliminaires puisse être utilisée et analysé

Développement local

Option 1

safari est sympa, vous pouvez gérer le site localement en

• Outils de développement activés
• Develop le menu
  • cochez Disable Cross-Origin Restrictions pendant le développement
  • recharger la page html
  • décochez Disable Cross-Origin Restrictions lorsque vous avez terminé
• exemple : fichier:///Users/tracey/dev/blogtini/index.html

Option 2

(n'importe quel serveur Web de fichiers statiques de base fera l'affaire) :

( sleep 3 ; open http://localhost:8000 ) &
python3 -m http.server

Vous pouvez forcer une nouvelle analyse des articles et des pages en ajoutant un argument CGI facultatif ?recache=1

Exemples d'URL utilisant des pages GitHub ou GitLab

Si vous utilisez l'intégration gratuite des « Pages » de https://github.com ou https://gitlab.com, vous obtiendrez des URL que vous pourrez aimer comme ceci :

• https://traceypooh.github.io/blogtini/
• https://traceypooh.gitlab.io/blogtini/

Vous pouvez choisir d'utiliser votre propre nom de domaine (généralement ~ 20 USD/an) pour une URL plus courte/plus agréable qui pointe vers le déploiement de Pages ci-dessus (c'est ce que fait https://blogtini.com)

À faire / Fixmes

• git grep xxxxx priorités les plus élevées
• git grep xxx