Cartographie 3D par drone

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 :

• Présentation du projet
• Guide pour mettre en place un projet similaire
• Archives des recherches effectuées en amont
• Crédits et remerciements

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)

Contribuer

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.

Prérequis

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>

Utilisation

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.

Structure du dépôt

.
├── 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

Syntaxe Markdown

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.

Auteurs & contributeurs

• Adèle PLUQUET
• Adrien LUDWIG

Outils

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