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].

== 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

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

• Déposer l'emblème officiel de l'Ordre des géomètres-experts dans images/ et remplacer le bloc .ordre-logo de templates/layout.html.
• Rédiger content/prestations/01-ma-carriere.adoc.
• Compléter les passages marqués [.todo]#…# dans content/mentions-legales.adoc (identité, n° d'inscription à l'Ordre, assurance RCP, médiateur, RGPD).
• Vérifier que le backend form.aloli.fr accepte les champs du formulaire (nom, prenom, adresse, tel, email, bien_adresse_type, bien_adresse, cadastre_section, cadastre_numero, demande, contexte).
• Faire pointer le DNS de mendoro.fr vers GitHub Pages, puis renseigner le domaine personnalisé dans Settings > Pages (impossible tant que le domaine ne résout pas : GitHub ne peut pas émettre le certificat).

[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.

== 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).