Hôtel de la Paix (photo d'époque)
Ce projet a été mis en place en avril 2023 pour participer à la sauvegarde du patrimoine togolais. Cette année, l'Hôtel de la Paix, ancien hôtel phare de Lomé abandonné depuis 20 ans, menaçait d'être détruit. Mitsio Motu a alors décidé de cartographier le bâtiment.
Vous trouverez ici la documentation reprenant tout ce projet :
Le lien pour accéder à la documentation est le suivant : https://mitsio-motu-data.github.io/3D-Cartography-Drone/
Hôtel de la Paix (reconstruction 3D)
Si vous souhaitez modifier ou étayer cette documentation, il faudra suivre les étapes suivantes. Merci de la tenir à jour de tout changement afin qu'elle reste pertinente le plus longtemps possible.
La documentation a été écrite grâce à mdBook. Rendez-vous sur la documentation de mdBook pour l'installer et vous renseigner sur l'outil.
Clonez ensuite le dépôt :
git clone <this-repo>
Pour avoir un aperçu de votre travail, il faut générer la documentation. Il faut exécuter la commande suivante :
cd <this-repo>/Documentation
mdbook serve --open # Génère la documentation et l'ouvre dans votre navigateur
Une fenêtre de votre navigateur par défaut devrait s'ouvrir sur la documentation. Vous pouvez également accéder à la documentation en allant à l'adresse suivante : http://localhost:3000.
Vous pouvez maintenant naviguer dans la documentation.
.
├── Documentation/ # Contient la documentation
│ ├── book.toml # Configuration de mdBook
│ ├── src/ # Contient les fichiers Markdown et les images,
│ │ │ # organisés en dossiers hiérarchiques selon la table des matières
│ │ ├── <chapitre>/
│ │ │ ├── <chapitre>.md
│ │ │ ├── <image>.jpg
│ │ │ ├── <sous-chapitre>/
│ │ │ │ ├── <sous-chapitre>.md
│ │ │ │ ├── <image>.jpg
│ │ │ │ └── ...
│ │ │ └── ...
│ │ └── ...
│ ├── theme/ # Contient le thème utilisé par mdBook
│ │ ├── css/
│ │ │ └── <variable>.css # Contient les couleurs du thème Mitsio Motu
│ │ └── ...
│ └── SUMMARY.md # Table des matières
├── .gitignore
├── .github/ # Contient les fichiers de configuration de GitHub
│ └── workflows/ # Contient les workflows GitHub Actions
│ └── deploy.yml # Déploiement automatique de la documentation sur GitHub Pages
└── .markdownlint.json # Configuration de markdownlint
Il n'y a pas de règles strictes concernant la syntaxe Markdown, mais nous essayons de suivre quelques bonnes pratiques pour que contribuer soit le plus agréable possible.
Nous utilisons markdownlint pour vérifier la syntaxe des fichiers Markdown. Différentes extensions existent pour les éditeurs de texte, vous pouvez donc l'installer pour votre éditeur préféré.
Quelques fonctionnalités sont spécifiques à mdBook. Vous pouvez les consulter sur leur documentation.
Certaines règles sont désactivées pour des raisons de compatibilité avec mdBook.
Vous pouvez consulter la configuration dans le fichier .markdownlint.json
.
Ce projet n'aurait pas été possible sans les librairies et logiciels Open Source que nous avons utilisés. Merci à tous les contributeurs pour leur travail :
Écriture et illustration de cette documentation
Réalisation du projet