# Outils de gestion du service d'hébergement du KI : générateur de fiches d'hébergement
## Installation (sous Arch, stop kidding with Debian)
### Serveur MongoDB
Lancer
```
sudo pacman -S mongodb
sudo systemctl enable mongodb
```
Alternativement, le serveur peut être lancer sur commande avec
```
mongod
```
Se connecter au serveur sans mot de passe dans le terminal avec
```
mongo
```
Il faudra se connecter au serveur Mongo de hebergement.enpc.org pour rester synchroniser
### Thème XeLaTeX ki019
Lancer
```
cd ..
git clone https://github.com/KIClubinfo/latex-ki.git
cd latex-ki/019/templates/
make install
```
## Architecture
* ki_hosting/
* templates/ : templates de fiche
* tex/ : fiches tex
* clubs/ : version pour les clubs
* ki/ : version pour le KI
* pdf/
* clubs/
* ki/
* tmp/ : fichiers de compilation temporaires laissés en mode debug
TODO : version RSI
## Command line tools
Générer toutes les fiches clubs
```
fi:generate all
```
Générer les fiches des clubs *club1*, *club2*
```
fi:generate club1 club2
```
Générer les fiches version réservée au KI
```
fi:generate --ki club1 club2
```
Générer des brouillons de fiche pour approbation : ajoute une watermark "Draft for approval"
```
fi:generate --draft club1 club2
```
Lancer en mode debug : affiche les infos de compilation dans le terminal, n'efface pas *app/tmp/*
```
fi:generate --debug club1 club2
```
Supprime la fiche de club dans la table clubs
```
fi:remove club
```
Traite les données de demande de fiches de la table requests, enregistre la fiche dans clubs et génère le pdf dans *app/pdf/clubs/*
```
req:handle club
```
Traite les données de demande de fiches de la table requests et génère un brouillon de fiche dans *app/pdf/draft/*
```
req:handle club --draft
```
FIXME: option --open pour ouvrir le pdf généré avec xdg-open
## Development
```
sudo pip install -e .
```
Cela créer un lien symbolique dans site-packages vers le répo pour que les modifications des sourcse prennent effet immédiatement.
## Publish to PyPi
Mettre dans ~/.pypirc
```
[distutils]
index-servers =
pypi
[pypi]
repository: https://pypi.python.org/pypi
username: <username>
password: <password>
```
Modifier le numéro de version dans *ki_hosting/version.py* et lancer
```
python setup.py sdist upload -r pypi
```
## Installation (sous Arch, stop kidding with Debian)
### Serveur MongoDB
Lancer
```
sudo pacman -S mongodb
sudo systemctl enable mongodb
```
Alternativement, le serveur peut être lancer sur commande avec
```
mongod
```
Se connecter au serveur sans mot de passe dans le terminal avec
```
mongo
```
Il faudra se connecter au serveur Mongo de hebergement.enpc.org pour rester synchroniser
### Thème XeLaTeX ki019
Lancer
```
cd ..
git clone https://github.com/KIClubinfo/latex-ki.git
cd latex-ki/019/templates/
make install
```
## Architecture
* ki_hosting/
* templates/ : templates de fiche
* tex/ : fiches tex
* clubs/ : version pour les clubs
* ki/ : version pour le KI
* pdf/
* clubs/
* ki/
* tmp/ : fichiers de compilation temporaires laissés en mode debug
TODO : version RSI
## Command line tools
Générer toutes les fiches clubs
```
fi:generate all
```
Générer les fiches des clubs *club1*, *club2*
```
fi:generate club1 club2
```
Générer les fiches version réservée au KI
```
fi:generate --ki club1 club2
```
Générer des brouillons de fiche pour approbation : ajoute une watermark "Draft for approval"
```
fi:generate --draft club1 club2
```
Lancer en mode debug : affiche les infos de compilation dans le terminal, n'efface pas *app/tmp/*
```
fi:generate --debug club1 club2
```
Supprime la fiche de club dans la table clubs
```
fi:remove club
```
Traite les données de demande de fiches de la table requests, enregistre la fiche dans clubs et génère le pdf dans *app/pdf/clubs/*
```
req:handle club
```
Traite les données de demande de fiches de la table requests et génère un brouillon de fiche dans *app/pdf/draft/*
```
req:handle club --draft
```
FIXME: option --open pour ouvrir le pdf généré avec xdg-open
## Development
```
sudo pip install -e .
```
Cela créer un lien symbolique dans site-packages vers le répo pour que les modifications des sourcse prennent effet immédiatement.
## Publish to PyPi
Mettre dans ~/.pypirc
```
[distutils]
index-servers =
pypi
[pypi]
repository: https://pypi.python.org/pypi
username: <username>
password: <password>
```
Modifier le numéro de version dans *ki_hosting/version.py* et lancer
```
python setup.py sdist upload -r pypi
```
Release files for KI-Hosting 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| KI-Hosting-1.0.1.tar.gz | 9.0 kB | Details |
Release files / KI-Hosting-1.0.1.tar.gz
| Download URL | KI-Hosting-1.0.1.tar.gz |
|---|---|
| Size | 9.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
328c736b1bf29ce6b1c6c303bb4432b82ce90b79a99139d5934376e1c6eddd12
|
|
BLAKE2b-256 checksum How to use checksums |
ab4c1f1bf22c5fb3e534db6a4b569991bfe624eb95ee2c8e94649954e01030cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |