summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorng0 <ng0@n0.is>2019-02-21 10:50:41 +0000
committerng0 <ng0@n0.is>2019-02-21 10:50:41 +0000
commit040bd258123e48afd3a767c8ecea375af8e3ff48 (patch)
tree4784c70267eefb6526113c884541128d311c898f
parenta224152d0330624c99e36e0fb457656d2ebd53c6 (diff)
README: document structure
-rw-r--r--README30
1 files changed, 24 insertions, 6 deletions
diff --git a/README b/README
index 87003cb0..ecb60941 100644
--- a/README
+++ b/README
@@ -6,12 +6,30 @@ Sourcecode for https://gnunet.org created from the https://taler.net code base.
Requires python3-jinja2, python3-babel, and gettext.
-Run "make" or "gmake" to build the HTML.
-In old USB fashion, run make or gmake again if it fails (we might fix this
-eventually).
-
-Expect it to show up in en/ and other language folders, NOT in the root dir.
-
+The currently supported python3 version is python 3.7.
+
+Run "make" to build the HTML.
+If you experience a failure related to a python module, run
+"make" again.
+
+Expect it to show up in rendered/en/ and other language folders.
+
+Layout / how this comes to be
+=============================
+
+config.mk local variables for values in the Makefile
+static/ contains images, css, PDFs, robots.txt, team-images
+static/navbar.css CSS for the navigation bar (common/navigation.j2.inc)
+static/styles.css CSS for the rest of the website
+template/ the flat namespace of html.j2 files
+dist/ 3rd party content (bootstrap 4, font-awesome)
+common/ jinja2 templates.
+template.py operates on template directory and produces
+ output in 'rendered/' directory
+
+The 'dist' and 'static' directories will be copied to the output
+directory ('rendered/') in the 'all' phase of make. robots.txt
+is copied to relevant folders.
Developing with GNU Guix
========================