Aracroq

Annuaire des personnes productrices et artisanes en circuit court dans la vallée de l’Arac.
Le site recense les activités locales (légumes, fromages, pains, miels, tisanes, etc.) et renvoie vers des fiches détaillées.

---

Liens utiles

• Site : https://www.aracroq.fr
• Annuaire PDF : https://www.aracroq.fr/assets/media/pdf/annuaire-personnes-productrices-val-d-Arac.pdf
• Forge (tous dépôts) : https://git.kouzheran.fr/
• Dépôt DATA (les fiches) : https://git.kouzheran.fr/kouzheran/producteuricesdata_kouzheran_fr
  • JSON public (index) : https://producteuricesdata.kouzheran.fr/
  • JSON Aracroq : https://producteuricesdata.kouzheran.fr/producers_aracroq.json
  • Médias : https://producteuricesdata.kouzheran.fr/media/<fichier>
• Dépôt SITE (ce site) : https://git.kouzheran.fr/kouzheran/aracroq_fr

---

Gestion de contenu (éditrices/éditeurs)

Modifier une fiche

1. Ouvrir le dépôt DATA : producteuricesdata_kouzheran_fr
2. Naviguer dans le dossier des fiches, ouvrir la fiche à modifier.
3. Cliquer sur le crayon, éditer les champs, ajouter un message, « Commit changes ».

Créer une nouvelle fiche à partir d’une autre

1. Dans le dépôt DATA, ouvrir une fiche existante.
2. Cliquer sur le crayon, copier tout le contenu.
3. Revenir au dossier, « Add file → Create new file », nommer le fichier (ex. patricia-oeufs.md), coller, adapter, « Commit changes ».

Statut de publication

• Pour cacher une fiche (ne pas l’afficher sur le site) :

  "statut": "non-publié"
  

• Toute fiche sans ce champ, ou avec une autre valeur, est considérée publiée.

Photos (règle simple)

• Largeur cible : 750 px maximum
• Format : JPG (qualité 70–80) ou WebP
• Nom : mon-slug.jpg (minuscules, tirets)
• Emplacement : dépôt DATA → dossier media/
• Référence dans la fiche :

  "photos": ["mon-slug.jpg"]
  

Champs d’une fiche (côté JSON)

{
  "nom": "string",
  "permalink": "/producteurices/mon-slug/",
  "rubriques": ["string"],
  "types": ["string"] ,
  "mini-description": "string court",
  "description": "<p>HTML</p>",
  "adresse": "string",
  "osm": 123456789,
  "telephones": ["string"],
  "email": "string",
  "responsable": ["string"],
  "site": "https://…",
  "transport": ["string"],
  "certifications": ["ab", "np", "hve", "bienvenue", "vp"],
  "horaires": ["lundi", "mardi", "mercredi", "jeudi", "vendredi", "samedi", "dimanche"],
  "photos": ["mon-slug.jpg"],
  "statut": "non-publié"
}

Champs minimaux recommandés : nom, permalink, rubriques, mini-description.
Les autres sections ne s’affichent que si les champs existent.

Mettre à jour l’annuaire PDF

1. Nom exact du fichier : annuaire-personnes-productrices-val-d-Arac.pdf
2. Aller dans : aracroq_fr/src/_assets/pdf/branch/main/ sur la forge
3. « Add files → Upload files », choisir le PDF, message, « Commit changes »

Évènements

Pour ajouter ou modifier un évènement affiché sur le site :

1. Aller dans le dossier src/evenements/

2. Créer un nouveau fichier avec l’extension .md
   (exemple : marche-fermier-automne-2025.md)

3. Copier ce modèle et adapter les infos :

   ---
   titre: "Marché fermier d’automne"
   permalink: "/evenements/marche-fermier-automne-2025/"
   date: 2025-11-16
   lieu: "Massat – Place du village"
   heure: "10:00–18:00"
   extrait: "Un grand marché convivial avec les producteur·ices de la vallée."
   ---
   
   Contenu libre en **Markdown** :  
   description, programme, images, liens, etc.
   
   

Si des évènements sont à venir le premier est afficher en page d'accueil dans un encart coloré

---

Technique (développeuses/développeurs)

Principe

• Le SITE (ce dépôt) est un site 11ty 3.12 (Nunjucks) qui consomme les fiches depuis un JSON public au build.
• Le DATA (dépôt séparé) expose : producers_aracroq.json + dossiers media/.

Environnements & données

Le site lit l’URL des données via src/_data/env.mjs :

export default {
  PUBLIC_DATA_URL: process.env.PUBLIC_DATA_URL || 'http://localhost:8080/'
}

• PROD : export PUBLIC_DATA_URL="https://producteuricesdata.kouzheran.fr/"
• LOCAL :
  • Option A (rapide) : servir les données avec un serveur statique sur le port 8080

    npx http-server -p 8080   # à la racine du dépôt DATA
    

  • Option B (DATA aussi en 11ty) :

    cd producteuricesdata_kouzheran_fr
    npm install
    npx @11ty/eleventy --serve   # veille à exposer producers_aracroq.json et /media
    

    Adapter PUBLIC_DATA_URL au port servi si besoin.

Lancer le SITE en local

cd aracroq_fr
npm install
# au choix, définir la source des données :
# export PUBLIC_DATA_URL="https://producteuricesdata.kouzheran.fr/"
# ou laisser vide et servir les données en local sur http://localhost:8080/
npx @11ty/eleventy --serve

• Sortie : dist/
• Dev server : affiché en console par 11ty

Lancer les FICHES en local (aperçu DATA)

Si le dépôt DATA est équipé d’une mini config 11ty :

cd producteuricesdata_kouzheran_fr
npm install
npx @11ty/eleventy --serve

Sinon, servir simplement le JSON + media/ :

npx http-server -p 8080

Filtrage des fiches non publiées (logique côté SITE)

Au build, les entrées dont statut === "non-publié" sont exclues des collections/pages.
Si vous ajoutez ce champ à une fiche existante, elle disparaîtra au prochain build.

Déploiement du SITE

cd aracroq_fr
npx @11ty/eleventy          # génère dist/
# puis publier dist/ sur l’hébergement (rsync, CI/CD, etc.)

Accessibilité, perf, sobriété

• HTML5 sémantique, alt obligatoires, focus visibles, contrastes AA
• Images ≤ 750 px, CSS minifié, police locale Lexend
• Pas de dépendances inutiles, contenu statique, temps de chargement courts

---

Besoin d’aide

Une question sur l’édition, les images, ou le build local/prod ?
Ouvrez une issue sur le dépôt concerné ou décrivez le problème par mail dans l’équipe.

---

Crédit

• référent : Yves Daniel
• développeurs :
  • Aïdo Wilhelm-Anthoine - aidow
  • Stéphane Langlois - pntbr
• fiches producteurices : Titouan Dubo
• illustration : Maïwann
• intégration css : Erick Gardin