This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Style du wiki

Wiki design system

Un rendu Forgejo inspire de ReadTheDocs et WikiPro

Le wiki du portail reprend une logique visuelle proche de ReadTheDocs, MkDocs Material et Docusaurus, mais appliquee proprement dans Forgejo via un pack CSS dedie. L’objectif est d’obtenir une lecture plus moderne, plus lisible et plus professionnelle, sans sortir de l’ecosysteme Forgejo.

📚 Lecture cible

• menu lateral fixe ;
• titres H1, H2, H3 tres visibles ;
• sections courtes ;
• hierarchie claire ;
• cards et panneaux lisibles.

<article class="ccds-card">
  <h3>🎨 Grammaire visuelle</h3>
  <ul>
    <li>palette limitee a trois couleurs utiles ;</li>
    <li>font stack moderne : Inter, Roboto, Montserrat ;</li>
    <li>images legeres et propres ;</li>
    <li>ombrage doux et style institutionnel.</li>
  </ul>
</article>

<article class="ccds-card">
  <h3>🧩 Socle technique</h3>
  <ul>
    <li>Forgejo natif ;</li>
    <li>CSS personnalise versionne ;</li>
    <li>header theme injecte ;</li>
    <li>rendu optimise pour wiki, orga et README.</li>
  </ul>
</article>

<article class="ccds-card">
  <h3>🛠️ Ce qui est volontairement evite</h3>
  <ul>
    <li>surcouches JS inutiles ;</li>
    <li>paves trop longs ;</li>
    <li>palettes trop nombreuses ;</li>
    <li>effets visuels qui nuisent a la lecture.</li>
  </ul>
</article>

🔧 Implementation

Le pack CSS source du theme CCDS est maintenu dans le projet principal, puis synchronise dans Forgejo. Cela permet de garder un theme stable, versionne et coherent entre les differents depots.

local-services/forgejo/theme/ccds-wiki.css
local-services/forgejo/theme/header.tmpl
local-services/forgejo/sync-theme.sh