ajout des voeux 2025 et annonce d'AG

Reviewed-on: AXUL/axul-site#8

archetypes/guides.md

@@ -0,0 +1,6 @@
+---
+title: "{{ replace .File.ContentBaseName "-" " " | title }}"
+summary: ""
+tags: []
+author: ""
+---

content/blog/bonne-annee-2021.md

@@ -1,10 +1,10 @@
 ---
 title: "Bonne année 2021"
 date: 2021-01-12T05:01:00+01:00
-tags: []
+tags: ["Communication", "Vœux"]
 summary: ""
 author: "Président"
 ---
 Nous avons pu effectuer une réunion de visu le samedi 9 janvier au centre social.
 
-La prochaine réunion sera **l'AG le vendredi 15 janvier** mais en **virtuel**.
+La prochaine réunion sera **l'AG le vendredi 15 janvier** mais en **virtuel**.

content/blog/bonne-annee-2025.md

@@ -0,0 +1,30 @@
+---
+title: "Bonnes fêtes de fin d'année 2024"
+date: 2024-12-22T15:50:13+01:00
+tags: ["Communication", "Vœux"]
+summary: "Joyeux noël 2024, meilleurs vœux pour 2025 et annonce de l'AG 2025"
+author: "Olivier"
+---
+Bonjour à tous,
+
+On arrive à la fin de l'année, j'espère qu'elle a été bénéfique pour vous, et que vous puissiez célébrer sa fin dignement avec les fêtes de Noël et du nouvel an qui arrivent.
+
+À l'axul, nous avons maintenu l'activité pour vous porter assistance du mieux que nous puissions, et nous regardons déjà vers l'année prochaine.  
+En effet, nous préparons l'**Assemblée Générale** pour le **samedi 11 janvier 2025**, de 10h à 13h. Cette réunion est, comme toutes nos réunions, ouverte au public, cependant vous aurez besoin d'être membre de l'association à jour dans vos cotisations pour participer aux votes et décisions prises ce jour là. Voici le programme à l'ordre du jour :
+
+ - 10h00 - 10h15 : Accueil
+ - 10h15 - 13h00 : *Assemblée Générale*
+    - Rapport moral du Président
+    - Rapport financier du Trésorier
+    - Projets pour 2025
+    - Élection des nouveaux membres du CA
+    - Élection par le CA des nouveaux membres du Bureau
+    - Moyens de communication de l'Axul
+    - Questions diverses (n'hésitez pas à les proposer par courriel)
+ - 13h00 - 14h00 : Déjeuner en commun
+ - 14h00 - 16h00 : Suite éventuelle de l'AG et interventions sur demande
+
+ Nous vous présentons tous **nos meilleurs vœux pour 2025** et espérons vous voir nombreux lors de l'assemblée générale.
+
+À bientôt,
+Librement vôtre

content/blog/fichier.md

@@ -1,10 +0,0 @@
----
-title: "Linky"
-date: 20241011
-tags: []
-summary: ""
-author: "Blagoï"
----
-# Free Linky !
-
-Salut l'Axul liberons les linkys !

content/blog/guides_et_telethon.md

@@ -0,0 +1,18 @@
+---
+title: "Guides et Téléthon"
+date: 2024-10-24T18:46:39+02:00
+tags: []
+summary: "Ouverture de la section \"guides\" et aux discussions sur la participation aux évènements Téléthon du Tholonet"
+author: "Olivier"
+---
+
+Bonjour à tous,
+
+Lors de ce vendredi 11 octobre, j'ai pu présenter le flux de travail pour ajouter un article sur ce site. Je l'ai maintenant écrit et ouvert [une section "Guides"](/guides) dans laquelle vous pourrez retrouver ce genre de tutoriel (et j'ai une idée pour le prochain).
+
+Nous avons également eu une sollicitation de la Mairie du Tholonet pour nous proposer de participer aux évènements du Téléthon. Cette réunion a été l'occasion de discuter de notre position en tant qu'association, et Jean a formulé une réponse proposant de participer aux rencontres avec les autres associations pour monter un projet commun.
+
+Enfin, nous avons eu le plaisir de revoir une personne rencontrée lors du forum des associations. Veillons à soigner nôtre accueil.
+
+à bientôt !
+Librement vôtre.

content/blog/octobre_2024.md

@@ -1,9 +1,9 @@
 ---
 title: "Les évènements d'Octobre 2024"
-date: 1984-09-26T17:21:17+02:00
+date: 2024-09-26T17:21:17+02:00
 tags: []
-summary: "Pas de samedi libre cet octobre,j'ai acheté l'Axul"
-author: "Bill_Gates"
+summary: "Pas de samedi libre cet octobre, mais plusieurs autres évènements"
+author: "Olivier"
 ---
 
 Bonjour à tous,

content/guides/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Guides"
+featured_image: "/images/134_la-sainte-victoire_aix-en-provence-992x496.jpg"
+---

content/guides/publier.md

@@ -0,0 +1,172 @@
+---
+title: "Publier un billet ou contribuer au site"
+summary: "Les étapes à suivre"
+tags: []
+author: "Olivier"
+---
+# Prérequis
+
+## Télécharger les logiciels
+
+Afin de pouvoir travailler correctement, vous allez avoir besoin d'une petite liste de logiciel :
+ - [Hugo](https://gohugo.io/) : l'outil de génération de site statique. Il permet d'obtenir des pages web navigable à partir des articles markdown.
+ - [Git](https://git-scm.com/) : l'outil de gestion de version. Il permet le travail collaboratif, nous permettant de travailler de manière asynchrone sur les contenus.
+ - Un éditeur de texte au choix. Voici quelques suggestions :
+   - [Ghostwriter](https://ghostwriter.kde.org/fr/) : Un éditeur spécialisé dans la rédaction markdown, avec un rendu immédiat et quelques outils de syntaxe.
+   - [VSCodium](https://vscodium.com/) : Base libre de VSCode de microsoft, un éditeur populaire chez les développeurs et très extensible pour couvrir tout les besoins.
+   - [Neovim](https://neovim.io/) : Réécriture de vim, un éditeur plus difficile à apprendre mais permettant des manipulations très efficaces, il est également très extensible. De plus, vi(m) est un éditeur présent sur la plupart des distributions linux par défaut.
+ - Un navigateur internet au choix. Il permet d'accéder au portail collaboratif et de tester son travail.
+   - [Firefox](https://www.mozilla.org/fr/firefox/new/) : Le navigateur libre de l'association Mozilla, acteur majeur dans la libération du web.
+   - [Chromium](https://www.chromium.org/Home/) : Navigateur libre, base de Chrome, le navigateur de Google et leader du marché.
+
+Tous ces logiciels peuvent être trouvés dans le gestionnaire de paquet de votre distribution Linux, leur installation ne devrait donc pas poser de problème.
+
+## Obtenir un compte sur le portail de l'association
+
+Pour pouvoir soumettre vos modifications à publication, vous allez avoir besoin d'un compte sur le portail collaboratif de l'association. L'inscription n'est pas automatique et est réservée aux adhérents de l'association.
+
+Pour obtenir votre compte, veuillez me faire la demande lors d'une rencontre de l'axul, ou bien par courriel auprès de **contact(at)axul.org** avec le nom d'utilisateur que vous souhaitez utiliser et l'adresse e-mail lié au compte.
+
+Une fois que j'aurais créé votre compte, je vous renverrai un mail contenant la confirmation de création du compte avec un mot de passe généré. Lors de votre première connexion, il vous sera demandé de changer ce mot de passe pour y entrer le vôtre.
+
+## Configurer les logiciels
+
+Vous aurez besoin de configurer Git pour signer vos modifications.
+```sh
+git config --global user.name "Votre nom"
+git config --global user.email "votre.email@example.com"
+```
+Et également pour le support des fichiers volumineux
+```sh
+git lfs install
+```
+
+Ensuite, si vous utilisez un éditeur de texte extensible, je vous conseille de télécharger une extension Markdown, et éventuellement une extension HTML/CSS/JS si vous avez prévu de travailler sur le theme du site.
+
+## Récupérer le dépôt
+
+Connectez-vous au [portail de collaboration](https://git.axul.org/user/login) et rendez-vous sur [le dépôt officiel du site](https://git.axul.org/AXUL/axul-site).  
+Cliquez sur le bouton "bifurquer" (fork) pour obtenir votre propre dépôt.
+
+![Indication visuelle du bouton "bifurquer"](/guides/img/bifurquer.png)
+
+Vous pourrez ensuite récupérer l'URL de votre dépôt dans votre presse-papier.
+
+![Indication visuelle de l'url](/guides/img/url-depot.png)
+
+Vous pouvez maintenant ouvrir un terminal dans le dossier dans lequel vous voulez récupérer les sources.  
+Avec la commande (en remplaçant bien sûr l'URL par celle acquise plus tôt)
+```sh
+git clone --recurse-submodules https://git.axul.org/votrenom/axul-site.git
+```
+vous devriez pouvoir télécharger les sources du site.
+
+Maintenant que les sources sont récupérées, on va configurer le dépôt pour garder un lien vers les sources officielles, cela nous permettra de rester à jour par rapport à celles-ci.  
+```sh
+git remote add upstream https://git.axul.org/AXUL/axul-site.git
+```
+
+Voilà, notre environnement de travail est fin prêt ! Nous ne devrions plus avoir à refaire ces étapes tant que nous ne changeons pas de poste de travail.
+
+# Mettre à jour son dépôt
+
+Avant de se lancer dans des modifications, il est préférable de se synchroniser avec l'état actuel du site. Pour cela on va faire une fois de plus appel à Git.
+```sh
+git pull -r upstream main
+git push --force-with-lease
+```
+
+# Ajouter son article
+
+## Créer le fichier d'article
+
+On va demander à Hugo de générer la nouvelle entrée avec la commande suivante
+```sh
+hugo new content content/blog/monarticle.md
+```
+
+Si votre version de Hugo ne permet pas cette commande car trop ancienne, vous pouvez copier le fichier archetype
+```sh
+cp achetypes/blog.md content/blog/monarticle.md
+```
+
+## Modifier les métadonnées
+
+Vous pouvez maintenant ouvrir votre fichier avec l'éditeur de texte. Vous remarquerez qu'il contient déjà quelque chose.  
+Il s'agit des métadonnées. Ce sont des informations qui permettent de trier et retrouver votre article sur le site.
+
+Veuillez remplir les informations. Pensez à vous créditer en tant qu'auteur.  
+Attention à la date, si vous n'avez pas pu la générer à l'aide de Hugo, allez voir dans les autres fichiers voisins comment l'écrire, car elle suit un format précis.
+
+## Rédiger le corps de l'article
+
+Vous pouvez à présent laisser libre cours à votre plume. Écrivez votre article sous les métadonnées (donc sous la séparation `---`).
+
+La rédaction se fait en [Markdown](https://fr.wikipedia.org/wiki/Markdown), un format de balisage léger pouvant se lire comme du texte brute.
+
+```md
+# Un titre
+
+## Un sous-titre
+
+### Un petit titre
+
+Un paragraphe
+
+ - une
+ - liste
+ - à
+ - bulle
+
+Une ligne et un  
+retour à la ligne avec un mot en **gras** et un en _italique_
+
+> Une citation
+
+[Un lien vers l'axul](https://axul.org/)
+
+![Texte alternatif d'une image](img/monimage.jpeg)
+
+| Un tableau  | à trois | colonnes |
+|-------------|---------|----------|
+| avec entête |         |          |
+| et trois    |         |          |
+| lignes      |         |          |
+```
+
+N'hésitez pas à rechercher sur internet pour les précisions, le Markdown est un format très répandu.
+
+# Tester son travail
+
+Une fois que vous avez fini de rédiger votre article, vous pouvez voir un aperçu du rendu du site. Pour cela, entrez la commande :
+```sh
+hugo server --config hugo.toml
+```
+
+Elle va rendre disponible sur un serveur local les fichiers générés. Vous pourrez ainsi ouvrir votre navigateur et accéder à l'adresse http://localhost:1313/ pour avoir un aperçu de votre version modifiée du site.
+
+# Confirmer ses modifications
+
+Une fois que vous êtes satisfait de votre travail, vous pouvez le sauvegarder dans votre dépôt.  
+(Vous n'êtes d'ailleurs pas obligé d'attendre d'avoir complètement terminé pour exécuter ces commandes, vous pouvez vous en servir pour sauvegarder par étape si votre rédaction vous prend beaucoup de temps)
+```sh
+git add content/blog/monarticle.md
+git commit -m "message résumé"
+git push
+```
+
+# Demander la publication
+
+Lorsque votre travail de rédaction est finalement terminé et sauvegardé dans votre dépôt, vous pouvez demander la publication sur le site officiel.
+
+Pour cela, reconnectez vous sur le portail collaboratif de l'axul, rendez vous sur votre dépôt et cliquez sur le bouton "Nouvelle demande d'ajout".
+
+![Indication visuelle du bouton "Nouvelle demande d'ajout"](/guides/img/pull-request.png)
+
+Veillez à indiquer que vous souhaitez fusionner votre dépôt dans celui de l'axul.  
+Vous arriverez alors sur une page dans laquelle vous pouvez justifier et commenter votre modification.
+
+Validez et c'est fait !  
+À partir de là ce sera mon travail de relire, vous poser des questions si nécessaire, puis intégrer le nouveau contenu pour enfin le déployer sur le serveur officiel.
+
+Merci pour votre contribution ! J'espère que ce guide vous a aidé dans les démarches, sinon n'hésitez pas à m'interpeller lors d'un rendez-vous de l'axul.

hugo.toml

@@ -3,12 +3,16 @@ baseURL = "https://axul.org"
 languageCode = "fr-FR"
 theme = "ananke"
 
-DefaultContentLanguage = "fr"
+defaultContentLanguage = "fr"
 # SectionPagesMenu = "main"
-Paginate = 30 # this is set low for demonstrating with dummy content. Set to a higher number
-googleAnalytics = ""
 enableRobotsTXT = true
 
+[services.googleAnalytics]
+  id = ''
+
+[pagination]
+  pagerSize = 30
+
 [sitemap]
   changefreq = "monthly"
   priority = 0.5
@@ -27,14 +31,18 @@ enableRobotsTXT = true
     name = "Blog"
     url = "/blog/"
     weight = 3
+[[menus.main]]
+    name = "Guides"
+    url = "/guides/"
+    weight = 4
 [[menus.main]]
     name = "Nous contacter"
     url = "/nous-contacter/"
-    weight = 4
+    weight = 5
 [[menus.main]]
     name = "Soutenez-nous"
     url = "/soutenez-nous/"
-    weight = 5
+    weight = 6
 
 [params]
   text_color = ""
@@ -49,6 +57,13 @@ enableRobotsTXT = true
   date_format = "Monday 2 January 2006"
   read_more_copy = "En savoir plus ..."
 
-[[params.ananke_socials]]
-name = "rss"
-url = "/index.xml"
+[params.ananke.social.follow]
+  networks = [
+    "rss"
+  ]
+
+[params.ananke.social.rss]
+  profilelink = "/index.xml"
+
+[params.ananke.social.share]
+  disable_share = true

layouts/blog/single.html

@@ -0,0 +1,71 @@
+{{ define "header" }}
+   {{/* We can override any block in the baseof file be defining it in the template */}}
+  {{ partial "page-header.html" . }}
+{{ end }}
+
+{{ define "main" }}
+  {{ $section := .Site.GetPage "section" .Section }}
+  <article class="flex-l flex-wrap justify-between mw8 center ph3">
+    <header class="mt4 w-100">
+      <aside class="instapaper_ignoref b helvetica tracked ttu">
+          {{/*
+          CurrentSection allows us to use the section title instead of inferring from the folder.
+          https://gohugo.io/variables/page/#section-variables-and-methods
+          */}}
+        {{ .CurrentSection.Title }}
+      </aside>
+      {{- partialCached "social/share.html" . . -}}
+      <h1 class="f1 athelas mt3 mb1">
+        {{- .Title -}}
+      </h1>
+      {{ with .Params.author | default .Site.Params.author }}
+      <p class="tracked">
+        {{ $.Render "by" }} <strong>
+        {{- if reflect.IsSlice . -}}
+            {{ delimit . ", " | markdownify }}
+        {{- else -}}
+            {{ . | markdownify }}
+        {{- end -}}
+        </strong>
+      </p>
+      {{ end }}
+      {{/* Hugo uses Go's date formatting is set by example. Here are two formats */}}
+      {{ if not .Date.IsZero }}
+      <time class="f6 mv4 dib tracked" {{ printf `datetime="%s"` (.Date.Format "2006-01-02T15:04:05Z07:00") | safeHTMLAttr }}>
+        {{- .Date | time.Format (default "January 2, 2006" .Site.Params.date_format) -}}
+      </time>
+      {{end}}
+
+      {{/*
+          Show "reading time" and "word count" but only if one of the following are true:
+          1) A global config `params` value is set `show_reading_time = true`
+          2) A section front matter value is set `show_reading_time = true`
+          3) A page front matter value is set `show_reading_time = true`
+        */}}
+      {{ if (or (eq (.Param "show_reading_time") true) (eq $section.Params.show_reading_time true) )}}
+        <span class="f6 mv4 dib tracked"> - {{ i18n "readingTime" .ReadingTime }} </span>
+        <span class="f6 mv4 dib tracked"> - {{ i18n "wordCount" .WordCount }} </span>
+      {{ end }}
+    </header>
+    <div class="nested-copy-line-height lh-copy {{ $.Param "post_content_classes"  | default "serif"}} f4 nested-links {{ $.Param "text_color" | default "mid-gray" }} {{ cond (eq $.Site.Language.LanguageDirection "rtl") "pl4-l" "pr4-l" }} w-two-thirds-l">
+      {{- .Content -}}
+      <hr>
+      <p>Vous pouvez retrouver toutes les réunions de l'axul sur <a href="https://www.agendadulibre.org/events?tag=axul">l'agenda du libre</a></p>
+
+      {{- partial "tags.html" . -}}
+      <div class="mt6 instapaper_ignoref">
+      {{ if .Site.Config.Services.Disqus.Shortname }}
+        {{ template "_internal/disqus.html" . }}
+      {{ end }}
+      {{ if .Site.Params.commentoEnable }}
+        {{- partial "commento.html" . -}}
+      {{ end }}
+      </div>
+    </div>
+
+    <aside class="w-30-l mt6-l">
+      {{- partial "menu-contextual.html" . -}}
+    </aside>
+
+  </article>
+{{ end }}

layouts/partials/site-footer.html

@@ -1,6 +1,7 @@
 <footer class="{{ .Site.Params.background_color_class | default "bg-black" }} bottom-0 w-100 pa3" role="contentinfo">
   <div class="flex justify-between">
     <a class="f4 fw4 hover-white no-underline white-70 dn dib-ns pv2 ph3" xmlns:cc="http://creativecommons.org/ns#" href="http://creativecommons.org/licenses/by-sa/4.0/deed.fr" target="_blank" rel="license noopener noreferrer" style="display:inline-block;"><span property="cc:attributionName">AXUL</span> CC BY-SA 4.0<img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/cc.svg?ref=chooser-v1"><img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/by.svg?ref=chooser-v1"><img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/sa.svg?ref=chooser-v1"></a>
-    <div>{{ partial "social-follow.html" . }}</div>
+    <a class="f4 fw4 hover-white white-70 dn dib-ns pv2 ph3" href="https://git.axul.org/">Contribuer au site</a>
+    <div>{{ partialCached "social/follow.html" . }}</div>
   </div>
 </footer>

themes/ananke

@@ -1 +1 @@
-Subproject commit 986a5c45ce49800c8e99e84b6069b4cec4a81df6
+Subproject commit 6bc1b2cecf52d9e7c061d3499f7c662b4a4e787c