- Multilingue — Disponible en Français, Anglais, Espagnol et Allemand
- Recherche avancée — Recherche instantanée avec filtres par catégorie
- Responsive — Design adapté mobile, tablette et desktop
- Design moderne — Interface élégante avec thème sombre
- Performant — Site statique ultra-rapide avec Astro & Starlight
Wiki/
├── Règlement # Toutes les règles du serveur
├── Guides # Tutoriels pour bien débuter
├── Métiers # Liste des métiers disponibles, avec tarifs en direct
├── Commandes # Référence des commandes
└── FAQ # Questions fréquentes
# Cloner le repository
git clone https://github.com/Capitalyx/Wiki.git
cd Wiki
# Installer les dépendances
bun install
# Lancer le serveur de développement
bun run devLe site sera disponible sur http://localhost:4321
Le wiki est entièrement construit avec Starlight : tout le contenu vit dans src/content/docs/ en Markdown/MDX, il n'y a plus de pages .astro custom.
Wiki/
├── public/ # Assets statiques (favicon, images, scripts)
├── src/
│ ├── assets/ # Logo et images utilisées par la config Starlight
│ ├── content/
│ │ ├── docs/ # Tout le contenu du wiki (fr à la racine, en/, es/, de/)
│ │ │ └── jobs/*.mdx # Pages métiers (texte + données dynamiques)
│ │ └── content.config.ts # Collections `docs` (Starlight) et `jobsData`
│ ├── components/
│ │ ├── JobCard.astro # Carte d'aperçu d'un métier (grille /jobs/)
│ │ ├── JobIcon.astro # Icônes Lucide associées à chaque métier
│ │ ├── JobPricingTable.astro # Rendu générique des données de métiers
│ │ └── Carousel.astro # Carrousel d'images réutilisable
│ └── styles/custom.css # Thème Starlight personnalisé
├── astro.config.mjs
└── package.json
| Commande | Description |
|---|---|
bun run dev |
Lance le serveur de développement |
bun run build |
Compile le site pour la production |
bun run preview |
Prévisualise le build de production |
bun run check |
Vérifie les types (astro check) |
Les pages src/content/docs/jobs/*.mdx affichent des tarifs/récompenses lus directement, au moment du build, depuis les fichiers générés automatiquement par le serveur FiveM :
/srv/fivem/datas/reports/wiki-data/*.json
Ces fichiers ne sont pas dans ce repo (ils vivent sur le serveur FiveM, en dehors de l'arbre git) et ne doivent jamais y être copiés. Ils sont chargés via la collection Astro jobsData (voir src/content.config.ts) et rendus par src/components/JobPricingTable.astro, qui affiche automatiquement toute nouvelle valeur sans qu'il soit nécessaire de modifier le Markdown. La grille d'aperçu /jobs/ utilise quant à elle JobCard.astro et JobIcon.astro pour lister les métiers disponibles.
Prérequis : l'utilisateur qui build (arkyan) doit être dans le groupe equipe pour avoir accès en lecture à ce dossier.
Le site est buildé localement, sur ce même serveur (pas de CI externe). Un rebuild est déclenché automatiquement à chaque modification des fichiers wiki-data grâce à des units systemd utilisateur :
~/.config/systemd/user/wiki-rebuild.path— surveille/srv/fivem/datas/reports/wiki-data~/.config/systemd/user/wiki-rebuild.service— relancebun run build
# Build manuel
bun run build
# Les fichiers sont générés dans ./dist/Servir dist/ publiquement (nginx, caddy...) est hors du périmètre de cette configuration et reste à mettre en place séparément.
Les contributions sont les bienvenues !
- Fork le projet
- Crée ta branche (
git checkout -b feature/ma-feature) - Commit tes changements (
git commit -m 'Ajout d'une feature') - Push sur la branche (
git push origin feature/ma-feature) - Ouvre une Pull Request