summaryrefslogtreecommitdiff
path: root/README
blob: 1b51e53046b69b8b997b1e9d0b3d7241f8b0edba (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
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

The development manifest for Guix is described in the usual [[file:manifest.scm][manifest.scm]], run:
#+BEGIN_EXAMPLE
guix shell
#+END_EXAMPLE
to enter a development environment.

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