Site Web Trans-cryption

Ce dépôt contient un site web statique généré avec Python et Jinja2, qui partage des témoignages, des ressources, et des informations historiques sur les personnes transgenres.

Site Web

Le site est accessible à l'adresse : https://trans-cryption.github.io

Architecture du projet

/
├── content/                # Contient les données pour générer le site
│   └── temoignages/        # Fichiers Markdown des témoignages individuels
│       └── podcasts/       # Fichiers audio des témoignages (format MP3)
├── templates/              # Templates Jinja2 pour les pages HTML
├── static/                 # Fichiers statiques (CSS, JS, images)
│   ├── css/                # Styles CSS organisés par portée
│   ├── js/                 # Scripts JavaScript organisés par portée
│   └── assets/             # Images et autres fichiers médias
├── build.py                # Script de génération du site
└── site/                   # Site généré (non versionné)

Fonctionnalités principales

• Témoignages : Récits personnels de personnes transgenres, avec option podcast
• Historique : Informations historiques sur les personnes transgenres à travers les époques
• Ressources : Associations et liens utiles pour les personnes transgenres
• Contact sécurisé : Formulaire avec chiffrement de bout en bout pour témoigner anonymement
• Page d'erreur 404 personnalisée : Expérience utilisateur améliorée lors de l'accès à des pages inexistantes

Principes de conception

• Séparation des préoccupations : HTML, CSS et JS sont dans des fichiers séparés
• Importation minimale : Chaque page charge uniquement les ressources dont elle a besoin
• Site statique : Utilisation minimale de JavaScript, préférence pour les solutions statiques
• Architecture modulaire : Organisation par composants pour faciliter la maintenance
• Contenu en Markdown : Les témoignages sont écrits en Markdown pour une meilleure lisibilité et maintenance
• Organisation centralisée : Tous les éléments liés aux témoignages sont regroupés dans un même dossier

Comment générer le site

1. Installer les dépendances :

   pip install -r requirements.txt
   

2. Exécuter le script de génération :

   python build.py
   

3. Le site sera généré dans le dossier site/

Déploiement

Le site est automatiquement déployé sur GitHub Pages à chaque push sur la branche main grâce au workflow GitHub Actions configuré dans .github/workflows/build-deploy.yml.

Contribuer

Pour ajouter ou modifier des témoignages :

1. Créez ou modifiez un fichier Markdown dans le dossier content/temoignages/
2. Si le témoignage inclut un podcast, ajoutez le fichier audio dans content/temoignages/podcasts/

Le script de génération s'occupera automatiquement d'intégrer ces contenus au site.

Consultez les READMEs dans les dossiers correspondants pour comprendre l'organisation des fichiers.