1 files changed, 43 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 00000000..425869de
--- /dev/null
+++ b/README
@@ -0,0 +1,43 @@
+-*- mode: org -*-
+
+#+TITLE: the Hurd website
+
+The Hurd website available at https://www.gnu.org/software/hurd/ is a
+static website built with [[https://ikiwiki.info/][Ikiwiki]].  This directory contains the source
+files of the website.
+
+* Development environment
+
+The folling dependencies are needed to build the website
+
+   ikiwiki,
+   perl,
+   cpan Text::Markdown,
+   cpan Search::Xapian,
+   cpan YAML::Syck, and
+   Texinfo
+
+On Debian, do something like:
+
+#+BEGIN_EXAMPLE
+sudo apt-get install ikiwiki perl libtext-markdown-perl \
+    libsearch-xapian-perl libyaml-syck-perl texinfo
+#+END_EXAMPLE
+
+To setup a development environment for Guix, do:
+
+#+BEGIN_EXAMPLE
+guix shell ikiwiki perl perl-text-markdown perl-search-xapian perl-yaml-syck texinfo
+#+END_EXAMPLE
+
+* Running the website
+
+To try out the website locally while you work on it, run the following
+commands:
+
+#+BEGIN_EXAMPLE
+rm -rf ../web.rendered
+./render_locally
+#+END_EXAMPLE
+
+the website is built out of tree (!) in in [[file:~/src/hurd/web.rendered][../web.rendered]].