From 59ae2151d070b8176ce97abf0c67138e6cd65fbb Mon Sep 17 00:00:00 2001
From: Pontoporeia <pontoporeia@happyngreen.fr>
Date: Sun, 29 Mar 2026 17:01:52 +0200
Subject: [PATCH] semantic HTML: apropos.php and licence.php (TODO section V &
 VI)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

apropos.php:
- Remove redundant <div class="apropos-left"> wrapper; prose div is now a direct
  grid child
- <div class="apropos-description apropos-page-content"> → <div class="prose">
  (single canonical class for Markdown-rendered content)
- <div class="apropos-right"> → <aside class="apropos-aside"> (supplementary info
  landmark; contacts and credits are secondary to the main description)
- Three bare <div> wrappers inside the aside → <section> (erg link, Contacts, Crédits)
- Three <div class="apropos-contact"> entries → <address> with font-style:normal
  override; <span class="apropos-contact-name"> → <strong>;
  <span class="apropos-contact-email"> → <a href="mailto:…">
  Removes classes: apropos-left, apropos-right, apropos-contact, apropos-contact-name,
  apropos-contact-role, apropos-contact-email, apropos-description, apropos-page-content

licence.php:
- <div class="apropos-description apropos-page-content apropos-single"> →
  <div class="prose apropos-single"> (consistent with apropos.php rename)

apropos.css:
- Rename .apropos-description / .apropos-page-content → .prose; merge all prose
  content rules under the single .prose selector
- Rename .apropos-right → .apropos-aside; remove .apropos-left (empty rule)
- Replace .apropos-contact, .apropos-contact-name etc. with element selectors:
  .apropos-aside address, .apropos-aside address strong,
  .apropos-aside address span, .apropos-aside address a
- Update responsive blocks to reference .prose instead of .apropos-description
---
 TODO.md                   |  22 ++++----
 public/apropos.php        |  52 +++++++++---------
 public/assets/apropos.css | 113 +++++++++++++++++++++-----------------
 public/licence.php        |   2 +-
 4 files changed, 99 insertions(+), 90 deletions(-)

diff --git a/TODO.md b/TODO.md
index b27ec38..a2673d1 100644
--- a/TODO.md
+++ b/TODO.md
@@ -688,33 +688,31 @@ The design does **not** need to change - only the vocabulary of the markup.
 
 ### V - `public/apropos.php`
 
-- [ ] **`<div class="apropos-layout">`** - two-column grid. Replace with `<div>` kept but the
+- [x] **`<div class="apropos-layout">`** - two-column grid. Replace with `<div>` kept but the
       children are semantic: left is the main content, right is supplementary.
       Left `<div class="apropos-left">` → remove (redundant wrapper around already-styled content).
-      Right `<div class="apropos-right">` → `<aside>` (contacts, credits = supplementary info).
+      Right `<div class="apropos-right">` → `<aside class="apropos-aside">` (contacts, credits = supplementary info).
 
-- [ ] **`<div class="apropos-description apropos-page-content">`** inside the left col -
+- [x] **`<div class="apropos-description apropos-page-content">`** inside the left col -
       the Parsedown output already generates `<p>`, `<h1>`-`<h3>`, `<ul>` etc.
       The wrapping `<div>` is only needed for the `.apropos-page-content` scoped CSS rules.
       Keep it but as a single class - `<div class="prose">` - and scope all Markdown content
       styles under `.prose`. This is the standard prose-container pattern.
 
-- [ ] **`<div class="apropos-contact">`** - each contact entry. Replace with `<address>`:
+- [x] **`<div class="apropos-contact">`** - each contact entry. Replace with `<address>`:
       the HTML spec defines `<address>` for contact information related to the document or section.
       Each contact is literally an address entry. `<span class="apropos-contact-name">` →
-      `<strong>`, `<span class="apropos-contact-role">` → plain text or `<span>`,
+      `<strong>`, `<span class="apropos-contact-role">` → plain text `<span>`,
       `<span class="apropos-contact-email">` → `<a href="mailto:...">`. Three classes removed.
 
-- [ ] **Outer `<div>` wrappers around each section in `.apropos-right`** (`<div><h2>...</h2></div>`,
-      `<div><h2>Contacts</h2>...</div>`, `<div><h2>Crédits</h2>...</div>`) - replace each with
-      `<section>`. Remove the anonymous `<div>` wrappers; CSS targets `aside section > h2`.
+- [x] **Outer `<div>` wrappers around each section in `.apropos-right`** (`<div><h2>...</h2></div>`,
+      `<div><h2>Contacts</h2>...</div>`, `<div><h2>Crédits</h2>...</div>`) - replaced with
+      `<section>`. CSS targets `aside section > h2`.
 
 ### VI - `public/licence.php`
 
-- [ ] **`<div class="apropos-right"></div>`** - always-empty right column. Remove entirely; the
-      `licence.php` page is full-width content. Update `licence.php` to not use `.apropos-layout`
-      at all - just `<main class="apropos-main"><div class="prose">...</div></main>`.
-      No class changes needed to `apropos.css`; the layout simply is not applied.
+- [x] **`<div class="apropos-right"></div>`** - always-empty right column. Removed entirely;
+      `licence.php` uses `<div class="prose apropos-single">` without the two-column layout.
 
 ### VII - Summary of class deletions enabled by semantic changes
 
diff --git a/public/apropos.php b/public/apropos.php
index 5c05f7b..76a07fb 100644
--- a/public/apropos.php
+++ b/public/apropos.php
@@ -46,44 +46,42 @@ $extraCss = ['assets/apropos.css'];
         <div class="apropos-layout">
 
             <!-- LEFT: main text (from DB, Markdown-rendered) -->
-            <div class="apropos-left">
-                <div class="apropos-description apropos-page-content">
-                    <?= $aboutHtml ?>
-                </div>
+            <div class="prose">
+                <?= $aboutHtml ?>
             </div>
 
             <!-- RIGHT: links, contacts, credits -->
-            <div class="apropos-right">
+            <aside class="apropos-aside">
 
-                <div>
+                <section>
                     <h2 class="apropos-section-title">
                         <a href="https://erg.be" target="_blank" rel="noopener">Site de l'erg</a>
                     </h2>
-                </div>
+                </section>
 
-                <div>
+                <section>
                     <h2 class="apropos-section-title">Contacts</h2>
 
-                    <div class="apropos-contact">
-                        <span class="apropos-contact-name">Laurent Leprince</span>
-                        <span class="apropos-contact-role">Bibliothèque d'architecture, d'ingénierie architecturale, d'urbanisme (BAIU) :</span>
-                        <span class="apropos-contact-email">laurent.leprince@uclouvain.be</span>
-                    </div>
+                    <address>
+                        <strong>Laurent Leprince</strong>
+                        <span>Bibliothèque d'architecture, d'ingénierie architecturale, d'urbanisme (BAIU) :</span>
+                        <a href="mailto:laurent.leprince@uclouvain.be">laurent.leprince@uclouvain.be</a>
+                    </address>
 
-                    <div class="apropos-contact">
-                        <span class="apropos-contact-name">Xavier Gorgol</span>
-                        <span class="apropos-contact-role">Responsable des mémoires de l'ERG :</span>
-                        <span class="apropos-contact-email">xavier.gorgol@erg.be</span>
-                    </div>
+                    <address>
+                        <strong>Xavier Gorgol</strong>
+                        <span>Responsable des mémoires de l'ERG :</span>
+                        <a href="mailto:xavier.gorgol@erg.be">xavier.gorgol@erg.be</a>
+                    </address>
 
-                    <div class="apropos-contact">
-                        <span class="apropos-contact-name">Brigitte Ledune</span>
-                        <span class="apropos-contact-role">Cours de suivi de mémoire :</span>
-                        <span class="apropos-contact-email">brigitte.ledune@erg.be</span>
-                    </div>
-                </div>
+                    <address>
+                        <strong>Brigitte Ledune</strong>
+                        <span>Cours de suivi de mémoire :</span>
+                        <a href="mailto:brigitte.ledune@erg.be">brigitte.ledune@erg.be</a>
+                    </address>
+                </section>
 
-                <div>
+                <section>
                     <h2 class="apropos-section-title">Crédits</h2>
                     <p class="apropos-credits-text">
                         Design &amp; développement : Olivia Marly, Théophile Gerveau-Mercie &amp; Théo Hennequin
@@ -91,9 +89,9 @@ $extraCss = ['assets/apropos.css'];
                     <p class="apropos-credits-text">
                         Typographies : Ductus (Amélie Dumont) &amp; BBB DM Sans
                     </p>
-                </div>
+                </section>
 
-            </div>
+            </aside>
 
         </div>
     </main>
diff --git a/public/assets/apropos.css b/public/assets/apropos.css
index cf198a8..fb2d082 100644
--- a/public/assets/apropos.css
+++ b/public/assets/apropos.css
@@ -1,5 +1,5 @@
 /* ============================================================
-   À PROPOS PAGE (apropos.php)
+   À PROPOS PAGE (apropos.php) + LICENCE PAGE (licence.php)
    ============================================================ */
 
 .apropos-body {
@@ -28,10 +28,11 @@
   max-width: 720px;
 }
 
-/* Left col — main description text in big monospace */
-.apropos-left {}
+/* ------------------------------------------------------------------ */
+/* Main prose column — Markdown-rendered content                       */
+/* ------------------------------------------------------------------ */
 
-.apropos-description {
+.prose {
   font-family: "Courier New", Courier, monospace;
   font-size: 1.55rem;
   line-height: 1.45;
@@ -40,12 +41,53 @@
   margin: 0 0 2rem 0;
 }
 
-.apropos-description p {
+.prose p {
   margin: 0 0 1.2em 0;
 }
 
-/* Right col — links, contacts, credits */
-.apropos-right {
+.prose h1,
+.prose h2,
+.prose h3 {
+  font-family: "Courier New", Courier, monospace;
+  font-weight: 400;
+  margin: 1.5em 0 0.5em 0;
+}
+
+.prose h1 { font-size: 1.55rem; }
+.prose h2 { font-size: 1.3rem; }
+.prose h3 { font-size: 1.1rem; }
+
+.prose a {
+  color: var(--purple);
+  text-underline-offset: 2px;
+}
+
+.prose ul,
+.prose ol {
+  padding-left: 1.5rem;
+  margin-bottom: 1rem;
+}
+
+.prose li {
+  margin-bottom: .3em;
+}
+
+.prose strong { font-weight: 700; }
+.prose em { font-style: italic; }
+
+.prose code {
+  font-family: "Courier New", Courier, monospace;
+  font-size: 0.9em;
+  background: rgba(0,0,0,.06);
+  padding: .1em .3em;
+  border-radius: 2px;
+}
+
+/* ------------------------------------------------------------------ */
+/* Right aside — links, contacts, credits                              */
+/* ------------------------------------------------------------------ */
+
+.apropos-aside {
   display: flex;
   flex-direction: column;
   gap: 2rem;
@@ -66,11 +108,13 @@
   text-underline-offset: 3px;
 }
 
-.apropos-contact {
+/* Contact entries — <address> elements */
+.apropos-aside address {
   margin-bottom: 1rem;
+  font-style: normal; /* override browser italic default for <address> */
 }
 
-.apropos-contact-name {
+.apropos-aside address strong {
   font-weight: 700;
   font-size: 0.95rem;
   color: var(--black);
@@ -78,57 +122,26 @@
   margin-bottom: 0.15rem;
 }
 
-.apropos-contact-role,
-.apropos-contact-email {
+.apropos-aside address span,
+.apropos-aside address a {
   font-size: 0.9rem;
   color: var(--black);
   line-height: 1.4;
   display: block;
 }
 
+.apropos-aside address a {
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+
 .apropos-credits-text {
   font-size: 0.9rem;
   color: var(--black);
   line-height: 1.6;
 }
 
-/* Markdown-rendered page content */
-.apropos-page-content p {
-  margin: 0 0 1.2em 0;
-}
-.apropos-page-content h1,
-.apropos-page-content h2,
-.apropos-page-content h3 {
-  font-family: "Courier New", Courier, monospace;
-  font-weight: 400;
-  margin: 1.5em 0 0.5em 0;
-}
-.apropos-page-content h1 { font-size: 1.55rem; }
-.apropos-page-content h2 { font-size: 1.3rem; }
-.apropos-page-content h3 { font-size: 1.1rem; }
-.apropos-page-content a {
-  color: var(--purple);
-  text-underline-offset: 2px;
-}
-.apropos-page-content ul,
-.apropos-page-content ol {
-  padding-left: 1.5rem;
-  margin-bottom: 1rem;
-}
-.apropos-page-content li {
-  margin-bottom: .3em;
-}
-.apropos-page-content strong { font-weight: 700; }
-.apropos-page-content em { font-style: italic; }
-.apropos-page-content code {
-  font-family: "Courier New", Courier, monospace;
-  font-size: 0.9em;
-  background: rgba(0,0,0,.06);
-  padding: .1em .3em;
-  border-radius: 2px;
-}
-
-/* Licences section */
+/* Licences section (legacy) */
 .apropos-licences {
   margin-top: 2rem;
 }
@@ -154,7 +167,7 @@
     gap: 2rem;
   }
 
-  .apropos-description {
+  .prose {
     font-size: 1.2rem;
   }
 
@@ -168,7 +181,7 @@
     padding: 1.5rem 1rem 3rem;
   }
 
-  .apropos-description {
+  .prose {
     font-size: 1rem;
   }
 }
diff --git a/public/licence.php b/public/licence.php
index 4d35ef7..3f6a467 100644
--- a/public/licence.php
+++ b/public/licence.php
@@ -39,7 +39,7 @@ $extraCss = ['assets/apropos.css'];
     <?php include APP_ROOT . '/templates/search-bar.php'; ?>
 
     <main class="apropos-main" id="main-content">
-        <div class="apropos-description apropos-page-content apropos-single">
+        <div class="prose apropos-single">
             <?php if (!empty(trim($content))): ?>
                 <?= $html ?>
             <?php else: ?>