[GNUnet-SVN] [taler-deployment] branch master updated: documenting /landing's serving

[gnunet]

This is an automated email from the git hooks/post-receive script.

marcello pushed a commit to branch master
in repository deployment.

The following commit(s) were added to refs/heads/master by this push:
     new ad31fbb  documenting /landing's serving
ad31fbb is described below

commit ad31fbb87fd62fdef0c8440ffc1f4c35f5aea9ea
Author: Marcello Stanisci <address@hidden>
AuthorDate: Wed Jan 3 10:47:19 2018 +0100

    documenting /landing's serving
---
 doc/onboarding.texi | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/doc/onboarding.texi b/doc/onboarding.texi
index 6ed2024..adfe58e 100644
--- a/doc/onboarding.texi
+++ b/doc/onboarding.texi
@@ -59,6 +59,48 @@ Texts.  A copy of the license is included in the section 
entitled
 @node Taler.net
 @chapter Taler.net
 
address@hidden Landing page
+
+The 'landing' page is the first page that should be visited during a "demo 
session".
+It is statically served and hosted at @code{$USER/landing/}, where 
@code{$USER} is one
+of @address@hidden,address@hidden or @address@hidden,address@hidden  Its 
source code is
+available at the repository: @code{git://taler.net/landing}.
+
+Before being served, the site needs to be compiled, to make the i18n content.  
The
+compilation is done in the following way:
+
address@hidden
+$ cd <landing's top directory>
+$ git submodule update --force --init
+$ AUTOMAKE="automake --foreign" autoreconf -fiv
+$ ./configure
+$ cd demo/
+$ make
+
+# NOTE: the sysadmin will _hardly_ need to do this manually, as there are 
deployment
+# scripts in charge of the compilation.
address@hidden example
+
+The most interesting part of nginx's configuration that serves the landing page
+is the following one:
+
address@hidden
+
+location / @{
+  ...
+  # always default to english
+  rewrite ^/$ /en/ redirect; 
+  # explicit append of "index.html"
+  rewrite ^/(..)/$ /$1/index.html break;
+  ...
+  # NOTE: /home/test/landing and /home/demo/landing
+  # are symlinks to the currently active "blue or green" party.
+  # Next chapters explain the "blue/green" deployment technique.
+  root /home/<'test' or 'demo'>/landing/demo;
+  ...
+  @}
address@hidden example
+
 @section Git
 
 Git at @code{taler.net} is managed by @emph{gitolite}.  Creation and deletion

-- 
To stop receiving notification emails like this one, please contact
address@hidden