From 1c0ba930b8d6aa5d97e6942852240861e6ab9bed Mon Sep 17 00:00:00 2001 From: Alex Date: Mon, 7 Feb 2022 11:51:12 +0100 Subject: Reorganize documentation for new website (#213) This PR should be merged after the new website is deployed. - [x] Rename files - [x] Add front matter section to all `.md` files in the book (necessary for Zola) - [x] Change all internal links to use Zola's linking system that checks broken links - [x] Some updates to documentation contents and organization Co-authored-by: Alex Auvolat Reviewed-on: https://git.deuxfleurs.fr/Deuxfleurs/garage/pulls/213 Co-authored-by: Alex Co-committed-by: Alex --- doc/book/src/cookbook/from_source.md | 51 ------------------------------------ 1 file changed, 51 deletions(-) delete mode 100644 doc/book/src/cookbook/from_source.md (limited to 'doc/book/src/cookbook/from_source.md') diff --git a/doc/book/src/cookbook/from_source.md b/doc/book/src/cookbook/from_source.md deleted file mode 100644 index 167f01db..00000000 --- a/doc/book/src/cookbook/from_source.md +++ /dev/null @@ -1,51 +0,0 @@ -# Compiling Garage from source - - -Garage is a standard Rust project. -First, you need `rust` and `cargo`. -For instance on Debian: - -```bash -sudo apt-get update -sudo apt-get install -y rustc cargo -``` - -You can also use [Rustup](https://rustup.rs/) to setup a Rust toolchain easily. - -## Using source from `crates.io` - -Garage's source code is published on `crates.io`, Rust's official package repository. -This means you can simply ask `cargo` to download and build this source code for you: - -```bash -cargo install garage -``` - -That's all, `garage` should be in `$HOME/.cargo/bin`. - -You can add this folder to your `$PATH` or copy the binary somewhere else on your system. -For instance: - -```bash -sudo cp $HOME/.cargo/bin/garage /usr/local/bin/garage -``` - - -## Using source from the Gitea repository - -The primary location for Garage's source code is the -[Gitea repository](https://git.deuxfleurs.fr/Deuxfleurs/garage). - -Clone the repository and build Garage with the following commands: - -```bash -git clone https://git.deuxfleurs.fr/Deuxfleurs/garage.git -cd garage -cargo build -``` - -Be careful, as this will make a debug build of Garage, which will be extremely slow! -To make a release build, invoke `cargo build --release` (this takes much longer). - -The binaries built this way are found in `target/{debug,release}/garage`. - -- cgit v1.2.3