The website https://tails.boum.org/ is built using Ikiwiki from source code that is available in our main Git repository, along with the rest of the Tails code.

You can build a local copy of the website on any Debian system, including Tails.

Building the website produces a set a HTML pages stored on your system that you can open in your usual web browser even while working offline. Doing so is useful for writers and designers to see how their changes will apply on the website.

  1. Update the list of available packages:

     sudo apt update
    
  2. Install the required packages:

     sudo apt install \
        ikiwiki \
        libyaml-perl \
        libyaml-libyaml-perl \
        libyaml-syck-perl \
        perlmagick \
        po4a \
        ruby
    
  3. Clone our main Git repository:

     git clone https://gitlab.tails.boum.org/tails/tails.git
    

    The source code of the website is located in the wiki/src/ folder.

  4. If you want to display the search box in the banner of your local build, uncomment the following line in ikiwiki.setup:

     # -  search
    
  5. Build the website:

     cd tails && \
     ./build-website
    

    To accelerate the build, you can disable some languages by editing the po_slave_languages parameter in the file ikiwiki.setup.

  6. You can now browse your local copy of the website in the following folder:

    config/chroot_local-includes/usr/share/doc/tails/website/