Ça veut dire quoi, colophon ?
Un colophon est la note finale d'un manuscrit ou d'un incunable donnant généralement des indications sur le titre de l'œuvre, l'auteur, parfois sur le copiste et la date de copie ou bien sur l'imprimeur et la date d'impression. Il sera par la suite remplacé par la page de titre.
Source : la page Colophon (livre), chez Wikipédia
Pour résumer, sur cette page je vous dévoile comment sont faites les pages que vous lisez.
Ma page personnelle et ses autres pages
Ma page personnelle et ses autres pages sont faites entiérement en HTML et CSS.
Feuille de style
La feuille de style est faite en CSS, en m’aidant en partie de ce qui existe déjà : mon blog, sur lequel j’ai passé plusieurs heures pour le rendre tel qu’il est.
La feuille de style du site différe du blog dans la mesure où elle existe avec deux thèmes : un thème sombre, celui par défaut, et un thème clair. Selon vos préférences de navigation, et d’utilisation de votre système d’exploitation, vous aurez donc un des deux thèmes.
Les pages
Vous l’aurez sans doute noté, les pages sont faites uniquement en HTML. Seule la partie centrale change en fonction des pages. Afin de ne pas avoir à penser à modifier chaque page à chaque modification au niveau de l’entête ou du pied de page, les pages sont découpées en parties, puis elles sont concaténées à l’aide d’une boucle en Bash.
Le script Bash, le plus basique possible, utilisé pour générer les pages est le suivant :
#!/bin/bash
pages='index colophon projets'
for page in $pages
do
cat part.{haut,$page,bas}.html > $page.html
done
Ainsi il me suffit, pour chaque nouvelle page, de modifier la variable pages, et d’exécuter le script.
Le blog
Mon blog est généré avec le générateur de blog statique Jekyll, écrit en langage Ruby.
Feuille de style
N’étant ni designer ni intégrateurice, bien que je me défende, son apparence est basé sur une ancienne version du framework CSS KNACSS :
/*! * www.KNACSS.com v7.1.2 (january, 30 2019) @author: Alsacreations, Raphael Goetter * Licence WTFPL http://www.wtfpl.net/ */
Gem utilisées
Les gems utilisées actuellement pour générer les billets et pages du blog sont celles présentes dans le Gemfile suivant :
# frozen_string_literal: true
source "https://rubygems.org"
git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
gem "jekyll", "~> 4.0"
group :jekyll_plugins do
gem 'jekyll-sitemap'
gem 'jekyll-feed'
gem 'jekyll-import'
gem 'jekyll-paginate'
gem 'jekyll-toc'
end
L’utilisation de la gem jekyll-import est expliquée dans le billet Migration du blog de PluXML vers Jekyll
Rédaction des billets
Les billets sont rédigés au format Markdown avant d’être compilés par Jekyll et servis en pages HTML.
Une fois que les billets et les pages sont rédigés et prêts à être publiés, la compilation et le déploiement sont lancés à partir d’un fichier Makefile comme celui présenté ici, merci à aeris pour ce fichier :
.DEFAULT_GOAL := deploy build: bundle exec jekyll build rm _site/Makefile .PHONY: build deploy: build rsync -6 -axPv --delete _site/ root@[ipv6]:/var/www/votre_page_perso/blog/ .PHONY: deploy