mendoro-website

= Erik Pain — Géomètre-expert

Site vitrine de https://mendoro.fr[Erik Pain], géomètre-expert.

Les textes sont rédigés en AsciiDoc dans content/ et convertis en site statique par un générateur Crystal, lui-même compilable sous Windows, macOS et FreeBSD.

Pour installer le poste de travail, voir link:INSTALL.adoc[INSTALL.adoc]. Pour la syntaxe des textes, voir link:AIDE-ADOC.adoc[AIDE-ADOC.adoc].

== Stack

• Textes en AsciiDoc, convertis par https://github.com/aloli-crystal/asciicrystal[asciicrystal]
• Générateur en Crystal (src/build.cr), sans dépendance à Ruby
• Sortie HTML / CSS pure — aucun framework, un seul script pour le formulaire
• Responsive, compatible mode sombre
• Français uniquement
• Hébergé sur GitHub Pages

== Structure

[source]

content/ # ← les textes, c'est ici site.adoc # attributs globaux (nom, fonction, domaine) accueil.adoc # titre et introduction de l'accueil contact.adoc # introduction du formulaire mentions-legales.adoc # mentions légales prestations/*.adoc # une prestation par fichier, triée par nom

templates/ # gabarits HTML, marqueurs {{clef}} layout.html # coquille commune à toutes les pages accueil.html # grille des prestations contact.html # formulaire contact-script.html # script du formulaire mentions-legales.html # corps des mentions légales prestation.html # corps d'une prestation ou d'une actualité fragments/*.html # morceaux répétés : cartes, menus, pagination…

css/style.css # toutes les feuilles de style images/ # emblème de l'Ordre et autres visuels src/build.cr # le générateur _site/ # sortie générée — non versionnée

La mise en page reprend la maquette : en-tête et pied de page fixes, seule la zone centrale défile.

== Générer le site

[source,sh]

shards install # la première fois seulement shards build # produit bin/build bin/build # écrit _site/ bin/build --serve # écrit _site/ puis sert http://localhost:8765

== Ajouter ou retirer une prestation

Créez ou supprimez un fichier dans content/prestations/. Le préfixe numérique fixe l'ordre d'affichage. La liste déroulante du formulaire de contact est alimentée par les mêmes fichiers : elle reste synchronisée sans intervention.

Ma carrière est volontairement exclue de cette liste déroulante — voir ecrire_contact dans src/build.cr.

== Reste à faire

Mettre le formulaire de contact en service:: Le site poste vers https://form.mendoro.fr/submit — l'attribut :form-action: de content/site.adoc —, adresse qui ne résout pas encore. Le service est aloli/crystal-forms (dépôt privé), à déployer sur qwerty.aloli.net avec SITE_NAME=mendoro.fr, SMTP_TO=contact@mendoro.fr et ALLOWED_ORIGINS=https://mendoro.fr. Faire ensuite pointer form.mendoro.fr sur cet hôte, puis supprimer content/contact-bandeau.adoc : c'est le bandeau qui invite à téléphoner en attendant.

Signer le contrat de sous-traitance:: Les mentions légales désignent ALOLI comme sous-traitant au sens de l'article 28 du RGPD, puisque le service de formulaire achemine les messages. Un contrat écrit avec Erik est requis, et le restera tant que ce service tournera.

== Déploiement

À chaque push sur la branche production, GitHub Actions installe Crystal, compile bin/build, génère _site/ et le publie sur GitHub Pages (.github/workflows/deploy.yml).

Un échec ouvre une issue assignée à papilip, portant le label ci — GitHub n'avertissant par courriel que l'auteur du push. Les échecs suivants s'ajoutent en commentaire plutôt que d'ouvrir une issue chacun. Un déploiement qui échoue ne retire rien : le site reste en ligne dans sa version précédente.

=== Domaine et certificat

Le domaine personnalisé tient au seul réglage Settings > Pages du dépôt. La publication passant par un workflow Actions, un éventuel fichier CNAME livré dans l'artefact serait ignoré — ne pas en recréer un en croyant y fixer le domaine.

Le certificat, émis par GitHub, couvre mendoro.fr et www.mendoro.fr. GitHub ne le réémet pas de lui-même si le DNS change : il faut retirer puis remettre le domaine personnalisé.

Enregistrements en place :

[source]

mendoro.fr. A 185.199.108.153 mendoro.fr. A 185.199.109.153 mendoro.fr. A 185.199.110.153 mendoro.fr. A 185.199.111.153 mendoro.fr. AAAA 2606:50c0:8000::153 mendoro.fr. AAAA 2606:50c0:8001::153 mendoro.fr. AAAA 2606:50c0:8002::153 mendoro.fr. AAAA 2606:50c0:8003::153 www.mendoro.fr. CNAME aloli.github.io.