Mode dev md-book

Note à savoir

le rapport md-book est disponible en ligne au lien donné

Docker (dev)

Dockerfile

FROM debian:trixie

WORKDIR /workspace

RUN apt update && apt install -y curl build-essential


RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
ENV PATH="/root/.cargo/bin:${PATH}"


RUN cargo install mdbook mdbook-katex

EXPOSE 8180

ENTRYPOINT ["/bin/bash", "-c", "mdbook serve -n 0.0.0.0 -p 8180"]

Build de la Dockerfile

docker build -t mdbook-live .

Création du containeur

docker run -it --rm -p 8180:8180-v lien/vers/git/sae:/workspace mdbook-live

lien si rien changé en local local

SI vous ne pouvez pas utiliser docker ou que vous avez envie de le faire manuellement

Linux:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

la deuxième ligne permet de réactualiser l'env bash/zsh ou on est pour faire en sorte de ne pas avoir a redémarre le terminal

OU

je suppose (j'ai pas essayé mais ca doit marcher)

Debian based:

sudo apt install rustc cargo

Fedora based:

sudo dnf install rust cargo

Arch based:

sudo pacman -S rust

Après installation de rust

on va installer mdbook et un plugin pour prerender du Latex

après en allant dans le dossier de la SAE puis en rentrant dans le dossier mdbook

on fait

cargo install mdbook

puis

cargo install mdbook-katex

et enfin pour faire une serveur local pour le dev

mdbook serve --open

pour build:

mdbook build

Windows:

installer sur le site de rust le .exe en x64 et installer rust

ensuite installer le .exe mdbook ici installer mdbook-v0.4.52-x86_64-pc-windows-msvc.zip

glisser le .exe dans l'archive directement dans le dossier mdbook de la SAE

ensuite on installe le plugin ici il faut développer le v0.9.3-binaries et télécharger le mdbook-katex-v0.9.3-x86_64-pc-windows-gnu.zip et extraire le .exe au meme endroit que celui de mdbook

normalement si tout c'est bien fait les commandes sont les même que linux sauf que faut faire

.path\to\mdbook.exe ma_commande