1 files changed, 57 insertions, 0 deletions
diff --git a/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md b/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md
new file mode 100644
index 00000000..d0d812a3
--- /dev/null
+++ b/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md
@@ -0,0 +1,57 @@
+Example bash script (creates multiple shaarli instances and generates an HTML index of them)
+```bash
+#!/bin/bash
+set -o errexit
+set -o nounset
+#config
+shaarli_base_dir='/var/www/shaarli'
+accounts='bob john whatever username'
+shaarli_repo_url='https://github.com/shaarli/Shaarli'
+ref="master"
+#clone multiple shaarli instances
+if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi
+   
+for account in $accounts; do
+    if [ -d "$shaarli_base_dir/$account" ];
+        then echo "[info] account $account already exists, skipping";
+        else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi
+done
+#generate html index of shaarlis
+htmlhead='<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<!-- Minimal html template thanks to http://www.sitepoint.com/a-minimal-html-document/ -->
+<html lang="en">
+        <head>
+                <meta http-equiv="content-type" content="text/html; charset=utf-8">
+                <title>My Shaarli farm</title>
+                <style>body {font-family: "Open Sans"}</style>
+        </head>
+        <body>
+        <div>
+        <h1>My Shaarli farm</h1>
+        <ul style="list-style-type: none;">'
+accountlinks=''
+    
+htmlfooter='
+        </ul>
+        </div>
+        </body>
+</html>'    
+    
+for account in $accounts; do accountlinks="$accountlinks\n<li><a href=\"$account\">$account</a></li>"; done
+if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi
+echo "[info] generating new index of shaarlis"
+echo -e "$htmlhead $accountlinks $htmlfooter" > "$shaarli_base_dir/index.html"
+echo '[info] done.'
+echo "[info] list of accounts: $accounts"
+echo "[info] contents of $shaarli_base_dir:"
+tree -a -L 1 "$shaarli_base_dir"
+```
+This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like [Ansible](https://www.ansible.com/)
+\ No newline at end of file

diff --git a/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md b/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md new file mode 100644 index 00000000..d0d812a3 --- /dev/null +++ b/doc/md/Create-and-serve-multiple-Shaarlis-(farm).md
@@ -0,0 +1,57 @@
	1	Example bash script (creates multiple shaarli instances and generates an HTML index of them)
	2
	3	```bash
	4	#!/bin/bash
	5	set -o errexit
	6	set -o nounset
	7
	8	#config
	9	shaarli_base_dir='/var/www/shaarli'
	10	accounts='bob john whatever username'
	11	shaarli_repo_url='https://github.com/shaarli/Shaarli'
	12	ref="master"
	13
	14	#clone multiple shaarli instances
	15	if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi
	16
	17	for account in $accounts; do
	18	if [ -d "$shaarli_base_dir/$account" ];
	19	then echo "[info] account $account already exists, skipping";
	20	else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi
	21	done
	22
	23	#generate html index of shaarlis
	24	htmlhead='<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
	25	<!-- Minimal html template thanks to http://www.sitepoint.com/a-minimal-html-document/ -->
	26	<html lang="en">
	27	<head>
	28	<meta http-equiv="content-type" content="text/html; charset=utf-8">
	29	<title>My Shaarli farm</title>
	30	<style>body {font-family: "Open Sans"}</style>
	31	</head>
	32	<body>
	33	<div>
	34	<h1>My Shaarli farm</h1>
	35	<ul style="list-style-type: none;">'
	36
	37	accountlinks=''
	38
	39	htmlfooter='
	40	</ul>
	41	</div>
	42	</body>
	43	</html>'
	44
	45
	46
	47	for account in $accounts; do accountlinks="$accountlinks\n<li><a href=\"$account\">$account</a></li>"; done
	48	if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi
	49	echo "[info] generating new index of shaarlis"
	50	echo -e "$htmlhead $accountlinks $htmlfooter" > "$shaarli_base_dir/index.html"
	51	echo '[info] done.'
	52	echo "[info] list of accounts: $accounts"
	53	echo "[info] contents of $shaarli_base_dir:"
	54	tree -a -L 1 "$shaarli_base_dir"
	55	```
	56
	57	This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like [Ansible](https://www.ansible.com/) \ No newline at end of file