aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLeah Rowe <info@minifree.org>2017-06-06 12:07:07 +0100
committerLeah Rowe <info@minifree.org>2017-06-06 12:07:07 +0100
commit5b32e553b96e7971099f82ed209ea4e8ada2d196 (patch)
tree1db56d8666abe1636821fa0ce9514c8b67b69b3c
parentc6e9a94a94836e34535f369604027ebb2d7aeb70 (diff)
downloadlibrebootfr-5b32e553b96e7971099f82ed209ea4e8ada2d196.tar.gz
librebootfr-5b32e553b96e7971099f82ed209ea4e8ada2d196.zip
git page: further document Libreboot's static site generator
This is useful for people who want to work on much larger changes to the Web site or documentation.
-rw-r--r--www/git.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/www/git.md b/www/git.md
index f6ebab77..44644ec3 100644
--- a/www/git.md
+++ b/www/git.md
@@ -33,6 +33,28 @@ We currently have a shortage of people who possess the skill to write and
maintain good documentation for Libreboot, so we welcome any and all
contributions!
+The .md files are written in Pandoc flavoured Markdown. The following scripts
+form Libreboot's *static site generator* which converts the Markdown files into
+HTML, to create the website:
+
+- index.sh: generates the news feed (on the News section of the website)
+- publish.sh: converts an .md file to an .html file
+- generate.sh: with calls to index.sh and publish.sh, compiles the entire
+ Libreboot website
+
+To view your local version of the website, it is advisable to install an HTTP
+server (e.g. nginx, lighttpd) and configure it so that the `www` directory in
+your local Git repository is the document root. With this, you can run
+`generate.sh` and view your own version of the website locally. This can be
+useful for larger changes (including structural) if you're making many large
+improvements to the website. However, it is possible to just edit the Markdown
+files with a text editor and submit those, or view individual .html files
+(generated by publish.sh) in a Web browser (e.g. Firefox).
+
+At present, the site and documentation are optimized for use on the Web (as
+HTML, generated by Pandoc), but we would like to possibly support other use
+cases aswell, such as PDF documents for printed manuals.
+
General guidelines for submitting patches
-----------------------------------------