-*- 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]].