From f595a0c69c34e61ac324d7e3faf80c84e41ce685 Mon Sep 17 00:00:00 2001 From: Jean-Damien Genero Date: Thu, 12 Jan 2023 11:25:08 +0000 Subject: [PATCH] Update README.md --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/README.md b/README.md index 7014fc5..1c8ea76 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,36 @@ # Actes princiers The research project "Actes princiers in the Kingdom of France (14th-16th centuries)" aims to gather and edit the acts produced by the chancelleries of various French princes and princesses of royal blood from the 14th and 15th centuries. This mostly unpublished collection aims to shed light on the interactions between the power strategies of the princes of the Late Middle Ages and the methods of writing used by their chancelleries. + +--- + +## Installation process + +This process describes how to install and run the project locally, e.g. for development purposes. + +_Nota_ : commands to execute through the terminal (Linux or macOS) + +- Clone the repo : `git clone https://gitlab.huma-num.fr/jgenero/actes-princiers` +- Install the virtual environment: + - Check that you’re using Python 3.x version by running : `python --version` (>3.8 required); + - Go to the following directory : `cd actes-princiers`; + - Install the environment : `python3 -m venv .venv`. + - Install the packages and libraries : + - Activate the environment : `source bootstrap.sh`; + - Installation : `pip install -r requirements.txt` + - Create database: `flask db init`; + - Exit the environment : `deactivate`; + +## Data processing + +When data is changed (e.g. XML files or CSV files), the following command must be ran : + +- `flask db init` to recrete the DB from the XML files (from _static/xml_). + +## Launch + +- Activate the environment : `source bootstrap.sh`; +- Launch : `flask run`; +- Go to http://127.0.0.1:5000/; +- Stop : `ctrl + c`; +- Exit the environment : `deactivate`.