đïž Open Source
Par OctoSpacc
Prudence
Le contenu de cette page a Ă©tĂ© entiĂšrement et automatiquement traduit en français, Ă partir de Italiano. Il peut donc contenir toutes sortes d’erreurs.
Bien que le site ctt ait Ă©tĂ© créé principalement dans l’intention d’ĂȘtre un bel endroit pour mon expression numĂ©rique personnelle (ce n’est pas un hasard il s’appelait initialement postoctt), Je lâai Ă©galement conçu comme un bien public et une ressource pour tous.
Pour garantir cela (et parce que d’ailleurs, avoir tout comme ça me facilite la gestion technique), tout le code qui fait fonctionner le site (de la compilation Ă l’affichage) est laissĂ© complĂštement ouvert, et les diffĂ©rents contenus sont dĂ©clarĂ©s ci-dessous comme libres.
Licences et droits d’auteur
Tout le contenu de ce site que j’ai créé (mes propres Ă©crits, les mĂ©dias originaux et la plupart du code source) est sous licence “PaternitĂ© Creative Commons - Partager dans les mĂȘmes conditions 4.0 International” (CC BY-SA 4.0) (
), une licence gratuite qui favorise le partage, et non cela porte atteinte aux droits lĂ©gitimes Ă la culture et Ă la collaboration de lâhumanitĂ© en gĂ©nĂ©ral.
Cependant, il y a aussi des contenus qui ne mâappartiennent pas.
En rĂšgle gĂ©nĂ©rale, si quelque chose sort de ma main, il n’y aura aucun crĂ©dit Ă proximitĂ©.
Cependant, pour les objets empruntĂ©s, dans la mesure du possible, la source d’oĂč je les ai pris et la licence de l’objet seront toujours indiquĂ©es, qu’il s’agisse du domaine public, de Creative Commons ou non spĂ©cifiĂ©.
Attention, je laisse souvent les crĂ©dits pour les Ă©lĂ©ments HTML et CSS uniquement dans les sources de la page. Donc, au cas oĂč, vĂ©rifiez lĂ ce genre de crĂ©dits. Cependant, pour des Ă©lĂ©ments comme les images ou les textes, les crĂ©dits sont souvent une partie visible de la page, proche de l’Ă©lĂ©ment empruntĂ© (comme une description) ; d’autres fois, le mĂȘme objet est un lien qui, si vous cliquez dessus, vous ramĂšne Ă la source.
DépÎts
Toutes les sources du site peuvent ĂȘtre tĂ©lĂ©chargĂ©es depuis les rĂ©fĂ©rentiels Git respectifs (GitLab.com) (ainsi divisĂ©s pour garder l’historique propre), dans les conditions dĂ©crites ci-dessus :
- Principal : https://gitlab.com/octtspacc/sitoctt
- Médias : https://gitlab.com/octtspacc/sitoctt-assets
Quelques miroirs mis Ă jour, toujours prĂ©sents au cas oĂč un patatrac arriverait aux rĂ©fĂ©rentiels principaux :
- GitHub : https://github.com/octospacc/sitoctt, https://github.com/octospacc/sitoctt-assets
- Gitea.it : https://gitea.it/octospacc/sitoctt, https://gitea.it/octospacc/sitoctt-assets
Structure des sources
Le rĂ©fĂ©rentiel secondaire sert uniquement Ă accumuler les fichiers multimĂ©dias intĂ©grĂ©s au site (Ă la fois dans les pages et dans la mise en page), les Ă©ventuels tĂ©lĂ©chargements, etc. Il nâest pas structurĂ© en plusieurs branches et les commits ne sont pas pertinents.
Le référentiel principal est structuré selon ces branches :
sitoctt-next
(principal)
Il s’agit de la branche dĂ©sormais dĂ©finie par dĂ©faut, qui hĂ©berge les fichiers principaux du site, depuis qu’elle a Ă©tĂ© migrĂ©e vers le gĂ©nĂ©rateur de site statique Hugo :
- Sources des pages et des articles (principalement au format Markdown)
- Sources de mise en page, donc modĂšles HTML avec syntaxe Go et feuilles de style CSS
- Autres éléments de base de la page, tels que les scripts cÎté client et les petites icÎnes
- Script trĂšs personnalisĂ© pour chaque phase du processus de compilation du site : obtention des dĂ©pendances, compilation des pages, synchronisation des donnĂ©es externes, etc…
sitoctt-old
(ancien main
)
C’Ă©tait la branche principale du site avant la migration vers Hugo, lorsque celle-ci Ă©tait encore gĂ©rĂ©e par mon gĂ©nĂ©rateur, statique.
La structure gĂ©nĂ©ralisĂ©e est la mĂȘme quâaujourdâhui, mais Ă©videmment les dossiers et fichiers Ă©taient un peu diffĂ©rents.
traduction-cache
Branche oĂč je stocke les versions traduites automatiquement des diffĂ©rentes pages et articles du site. Ils sont stockĂ©s sĂ©parĂ©ment car ce sont des fichiers qui peuvent ĂȘtre rĂ©gĂ©nĂ©rĂ©s Ă tout moment, et cela n’a donc aucun sens pour eux de salir l’historique des commits rĂ©els du site. Il faut cependant les conserver, car les gĂ©nĂ©rer de toutes piĂšces Ă chaque compilation du site prendrait des heures…
exigences-cache
Branche que j’utilise un peu comme rĂ©fĂ©rentiel pour diverses dĂ©pendances de build ou d’exĂ©cution du site, car certaines sont extrĂȘmement fragiles et d’autres sont peut-ĂȘtre simplement pratiques pour les sauvegarder. Mais cela n’a pas beaucoup d’importance.