Compiler à partir des sources

La première étape pour compiler le code source de Plume est de le récupérer.

git clone https://git.joinplu.me/Plume/Plume.git
cd Plume

Ensuite, vous devrez installer Plume et les outils CLI pour gérer votre instance. Lancez les commandes qui suivent.

Pour GNU/Linux et Mac OS X :

# Construire la partie client
cargo install wasm-pack
wasm-pack build --target web --release plume-front

# Construire la partie serveur, remplacez DATABASE par
# postgres ou sqlite selon celui que vous souhaitez utiliser
cargo install --no-default-features --features DATABASE --path .

# Construire plm, l'outil en CLI, remplacez encore DATABASE
cargo install --no-default-features --features DATABASE --path plume-cli

Depuis la v0.5.0, Plume supporte Lindera, une bibliothèque d'analyse morphologique japonaise pour la recherche en japonais. Si vous voulez l'utiliser, passez l'option search-lindera à --features pour construire plume et plume-cli:

cargo install --no-default-features --features DATABASE,search-lindera
cargo install --no-default-features --features DATABASE,search-lindera --path plume-cli

Et puis, vous pouvez configurer Plume avec les variables d'environnements : SEARCH_TAG_TOKENIZER, SEARCH_CONTENT_TOKENIZER et/ou SEARCH_LANG. Voir Variables d'environnement utiles pour plus de détails.

Pour Windows, si vous souhaitez utiliser SQLite, lancez un autre cmd.exe en tant qu'administrateur et exécutez :

# Installation, compilation et conversion de SQLite avec chocolatey

choco install sqlite
cd C:\ProgramData\chocolatey\lib\SQLite\tools
"C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" x86_amd64
lib /MACHINE:x64 /def:sqlite3.def /out:sqlite3.lib

# Copie de sqlite3.lib vers le dossier d'installation de RustUp
copy C:\ProgramData\chocolatey\lib\SQLite\tools\sqlite3.lib C:\Users\%USERNAME%\.rustup\toolchains\stable-x86_64-pc-windows-msvc\lib\rustlib\x86_64-pc-windows-msvc\lib\sqlite3.lib

Vous pouvez fermer ce cmd.exe et continuer avec l'installation normale. N'oubliez pas de remplacer DATABASE par postgres ou sqlite selon ce que vous souhaitez utiliser :

# Installation de diesel_cli 
cargo +stable install diesel_cli --no-default-features --features DATABASE --version '=1.3.0' --verbose

# Construire la partie client
cargo install wasm-pack
wasm-pack build --target web --release plume-front

# Si vous utilisez SQLite, copiez sqlite3.lib depuis la version stable de RustUp vers celle que vous venez d'installer
copy C:\Users\%USERNAME%\.rustup\toolchains\stable-x86_64-pc-windows-msvc\lib\rustlib\x86_64-pc-windows-msvc\lib\sqlite3.lib C:\Users\%USERNAME%\.rustup\toolchains\nightly-2020-01-15-x86_64-pc-windows-msvc\lib\rustlib\x86_64-pc-windows-msvc\lib\sqlite3.lib

# Construire la partie serveur, remplacez DATABSE par
# postgres ou sqlite selon ce que vous souhaitez utiliser
cargo install --no-default-features --features DATABASE --path .

# Construire plm, l'outil en ligne de commande, remplacez encore DATABASE
cargo install --no-default-features --features DATABASE --path plume-cli

Ces commandes peuvent prendre beaucoup de temps à s'exécuter et utiliser beaucoup de ressources.

Une fois qu'elles ont terminées, vous pouvez configurer votre instance.

Configuration