From 09342a19640c090ba625ddefbb3ca4aa1c69f872 Mon Sep 17 00:00:00 2001
From: mdbook <info@liberaforms.org>
Date: Wed, 21 Apr 2021 19:47:06 +0200
Subject: [PATCH] adds readme.md and install.md

---
 INSTALL.md | 130 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.md  |   5 +++
 2 files changed, 135 insertions(+)
 create mode 100644 INSTALL.md
 create mode 100644 README.md

diff --git a/INSTALL.md b/INSTALL.md
new file mode 100644
index 0000000..4ccae51
--- /dev/null
+++ b/INSTALL.md
@@ -0,0 +1,130 @@
+# mdBook
+
+Install curl
+
+```bash
+apt-get install curl
+```
+
+Add a user to serve mdBook
+
+```bash
+adduser --disabled-password mdbook
+```
+
+Open a session as mdbook user
+
+
+```bash
+su - mdbook
+```
+
+## Install Rust
+```bash
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+```
+
+## Install mdBook with localization support
+
+Note: 2021/04/05
+
+> mdbook doesn't support localisation yet, so we are using code that is
+still work on progress to create our documentation with localisation.
+Note that this code still has some rough edges.
+See github.com/rust-lang/mdBook/pull/1306 for more details.
+
+Until those changes have been merged, we will pull the code from the git repository
+
+```bash
+cargo install mdbook --git https://github.com/Ruin0x11/mdBook.git --branch localization --rev d06249b
+```
+
+
+```bash
+mdbook init
+mdbook init <your_book_name>
+```
+
+```bash
+cd <your_book_name>
+```
+
+## Create languages
+
+Edit `book.toml`
+
+```
+[book]
+authors = []
+src = "src"
+
+[language.en]
+name = "English"
+title = "Documentation"
+
+[language.es]
+name = "Español"
+title = "Documentación"
+
+[language.ca]
+name = "Català"
+title = "Documentació"
+```
+
+Create the language directories
+
+```bash
+cp -a en es
+cp -a en ca
+```
+
+# Compile the book
+
+mdBook compiles the md files in `./src` creating the static site in `./book`
+There are many ways to do this add directories and md file to your `./src`.
+You could for example edit the `./src` files and directories in your PC,
+compile them and then upload the `./book` files to your webserver.
+
+But we will edit the `./src` in situ (you could also use git for example).
+So, we need mdBook to compile the site when there are changes.
+
+```bash
+mdbook watch &
+```
+
+
+## Nginx
+
+We use nginx to server the static files.
+
+```
+server {
+    listen         80;
+    server_name    example.com;
+    return         301 https://$server_name$request_uri;
+}
+server {
+    listen 443 ssl;
+    server_name example.com;
+
+    ssl_trusted_certificate   /etc/letsencrypt/live/example.com/fullchain.pem;
+    ssl_certificate           /etc/letsencrypt/live/example.com/fullchain.pem;
+    ssl_certificate_key       /etc/letsencrypt/live/example.com/privkey.pem;
+
+	location / {
+		root   /var/www/html/mdbook/en;
+        }
+	location /en {
+		alias   /var/www/html/mdbook/en;
+        }
+	location /es {
+		alias   /var/www/html/mdbook/es;
+        }
+	location /ca {
+		alias   /var/www/html/mdbook/ca;
+        }
+    
+    access_log /var/log/nginx/example.com.access.log;
+    error_log /var/log/nginx/example.com.error.log notice;
+}
+```
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7b6b62c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# docs.liberaforms.org
+
+
+
+