Ce repo contiendra l'ensemble des éléments "custom" propres au projet de cartographie, indépendamment du code source d'Apiviz. Ceci permettra une meilleure flexibilité et coordination :
- le chantier purement technique s'effectuera sur le repo ApiViz, dans le but d'en améliorer la généricité
- les contenus et documents de cadrage (maquette, charte graphique...) produits par chacun.e seront mis à jour sur ce repo
- les issues propres au projet de cartographie SoNum seront associées à ce repo
- les issues propres au développement d'ApiViz seront associées au repo ApiViz
- la vision générale de l'avancée du projet (gestion des sprints) sera visible et modifiable sur le(s) projet(s) au niveau plus général de l'organisation co-demos
Les dossiers sont organisés de la manière suivante :
/data
: fichiers CSV, XLS, liens vers points d'API (dans un fichier .MD ou .TXT)/textes
: fichiers textes (édito, mot ministre, ...) au format .TXT ou .MD/logos
: fichiers (images) des logos au format .PNG, .JPG, .SVG/illustrations
: fichiers des illustrations/images (background ou foreground) au format .PNG, .JPG, .SVG/photos
: fichiers des photos/images au format .PNG, .JPG, .SVG/pages-html
: fichiers HTML qui seront pointés par l'instance d'Apiviz
/graphisme
: fichiers des différents éléments constituant la charte graphique (maquette, charte graphique, ...)/documentation
: fichiers de synthèse et de documentation (liste livrables, recommandations UI-UX, recommandations tech, médiation...) au format .PDF, .DOC, .TXT, .MD ...
Merci de donner des noms explicites aux fichiers que vous modifierez/ajouterez, ainsi que bien les ajouter dans le dossier qui leur correspond le mieux
Un mini serveur Flask est écrit dans le fichier 'server.py' afin de servir les fichiers .html et les fichiers statiques, ceci à des fins de tests et de développement local avec votre application locale d'Apiviz-backend.
Pour installer le serveur :
pip install --upgrade pip
python3 -m pip install --user virtualenv
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
ou
sh setup.sh
source venv/bin/activate
Pour lancer le serveur sur https://localhost:8800
:
python server.py
Les fichiers seront alors localement servis sur ces adresses :
https://localhost:8800/html/<path:folder_path>/<string:html_filename>
https://localhost:8800/statics/<path:folder_path>/<string:static_filename>