|
1 | | -# Documentation SophiaHackLab |
| 1 | +# Site web de documentation du SophiaHackLab |
2 | 2 |
|
3 | | -Le présent document constitue le site web officiel de documentation pour [SophiaHackLab](https://www.shl.contact/), un hackerspace collaboratif regroupant ingénieurs, artistes, scientifiques et entrepreneurs, situé à Sophia-Antipolis, France. |
| 3 | +Le présent document constitue le code source du site web officiel de documentation du [SophiaHackLab](https://www.shl.contact/), un hackerspace collaboratif regroupant ingénieurs, artistes, scientifiques et entrepreneurs, situé à Sophia-Antipolis, France. |
4 | 4 |
|
5 | | -Ce site est développé avec [Docusaurus](https://docusaurus.io/), un générateur de sites web statiques moderne. |
| 5 | +Ce site est développé avec [Docusaurus](https://docusaurus.io/), un générateur de sites web statiques moderne. Il permet de gérer aisément du contenu, comme des articles de blog ou de la documentation pour les projets du SHL: ajouter/modifier/supprimer des fichiers markdowns dans ce répertoire sur la branche `main` déploiera automatiquement ces changements sur le site web <https://sophiahacklab.github.io/docusaurus/>. |
| 6 | + |
| 7 | +## Structure du projet |
| 8 | + |
| 9 | +``` |
| 10 | +. |
| 11 | +├── docs/ # Fichiers markdown de documentation |
| 12 | +│ ├── intro.md # Page d'introduction |
| 13 | +│ ├── contributing.md # Guide de contribution (dans la sidebar) |
| 14 | +│ ├── test-reports.md # Documentation des rapports de tests |
| 15 | +│ └── projects/ # Documentation des projets |
| 16 | +│ ├── fete_de_la_science/ |
| 17 | +│ ├── rov/ |
| 18 | +│ └── triviak/ |
| 19 | +│ ├── mini/ |
| 20 | +│ └── real/ |
| 21 | +├── blog/ # Articles de blog |
| 22 | +│ ├── 2025-01-06-campagne-dons-2025.md |
| 23 | +│ ├── 2024-12-15-innovation-hackerspaces.md |
| 24 | +│ ├── 2025-01-05-open-talks-rust.md |
| 25 | +│ ├── authors.yml # Auteurs du blog |
| 26 | +│ └── tags.yml # Tags du blog |
| 27 | +├── src/ # Composants React et pages |
| 28 | +├── static/ # Ressources statiques |
| 29 | +├── tests/ # Tests e2e Playwright |
| 30 | +│ ├── homepage.spec.ts |
| 31 | +│ ├── sidebar.spec.ts |
| 32 | +│ └── projects.spec.ts |
| 33 | +├── scripts/ # Scripts utilitaires |
| 34 | +│ └── test-local.sh # Script de test local |
| 35 | +├── docusaurus.config.ts # Configuration Docusaurus |
| 36 | +├── playwright.config.ts # Configuration Playwright |
| 37 | +├── sidebars.ts # Configuration de la sidebar (autogénérée) |
| 38 | +└── DEPLOYMENT.md # Instructions de déploiement |
| 39 | +``` |
| 40 | + |
| 41 | +## Contribuer |
| 42 | + |
| 43 | +Le fichier [CONTRIBUTING.md](./docs/contributing.md) donne des détails concernant les contributions. |
6 | 44 |
|
7 | 45 | ## Démarrage rapide |
8 | 46 |
|
@@ -69,40 +107,6 @@ Ouvrir le rapport de tests HTML dans votre navigateur: |
69 | 107 | npm run test:report |
70 | 108 | ``` |
71 | 109 |
|
72 | | -## Structure du projet |
73 | | - |
74 | | -``` |
75 | | -. |
76 | | -├── docs/ # Fichiers markdown de documentation |
77 | | -│ ├── intro.md # Page d'introduction |
78 | | -│ ├── contributing.md # Guide de contribution (dans la sidebar) |
79 | | -│ ├── test-reports.md # Documentation des rapports de tests |
80 | | -│ └── projects/ # Documentation des projets |
81 | | -│ ├── fete_de_la_science/ |
82 | | -│ ├── rov/ |
83 | | -│ └── triviak/ |
84 | | -│ ├── mini/ |
85 | | -│ └── real/ |
86 | | -├── blog/ # Articles de blog |
87 | | -│ ├── 2025-01-06-campagne-dons-2025.md |
88 | | -│ ├── 2024-12-15-innovation-hackerspaces.md |
89 | | -│ ├── 2025-01-05-open-talks-rust.md |
90 | | -│ ├── authors.yml # Auteurs du blog |
91 | | -│ └── tags.yml # Tags du blog |
92 | | -├── src/ # Composants React et pages |
93 | | -├── static/ # Ressources statiques |
94 | | -├── tests/ # Tests e2e Playwright |
95 | | -│ ├── homepage.spec.ts |
96 | | -│ ├── sidebar.spec.ts |
97 | | -│ └── projects.spec.ts |
98 | | -├── scripts/ # Scripts utilitaires |
99 | | -│ └── test-local.sh # Script de test local |
100 | | -├── docusaurus.config.ts # Configuration Docusaurus |
101 | | -├── playwright.config.ts # Configuration Playwright |
102 | | -├── sidebars.ts # Configuration de la sidebar (autogénérée) |
103 | | -└── DEPLOYMENT.md # Instructions de déploiement |
104 | | -``` |
105 | | - |
106 | 110 | ## Déploiement |
107 | 111 |
|
108 | 112 | ### GitHub Pages (automatisé) |
@@ -240,18 +244,14 @@ La sidebar est automatiquement générée à partir de la structure du système |
240 | 244 |
|
241 | 245 | ## Blog |
242 | 246 |
|
243 | | -Le site comprend 3 articles de blog spécifiques au SHL: |
| 247 | +Le site comprend des articles de blog spécifiques au SHL, tels que: |
244 | 248 |
|
245 | 249 | - **Campagne de dons 2025** - Informations sur le soutien au SHL via les dons |
246 | 250 | - **Innovation dans les hackerspaces** - Comment les hackerspaces catalysent les écosystèmes technologiques |
247 | 251 | - **Open Talks: Rust** - Annonce d'événement pour la présentation Rust (14 janvier 2025) |
248 | 252 |
|
249 | 253 | Tous les articles de blog comportent le branding SHL et sont correctement tagués pour une navigation facilitée. |
250 | 254 |
|
251 | | -## Contribuer |
252 | | -
|
253 | | -Veuillez consulter [CONTRIBUTING.md](./docs/contributing.md) pour les détails concernant notre code de conduite et le processus de soumission des pull requests. |
254 | | -
|
255 | 255 | ## À propos du SophiaHackLab |
256 | 256 |
|
257 | 257 | Le SophiaHackLab regroupe des ingénieurs, artistes, scientifiques, entrepreneurs et créatifs, qui partagent un espace de travail et de socialisation à Sophia-Antipolis, France. |
|
0 commit comments