aboutsummaryrefslogtreecommitdiffstats

                               Debian "webwml"
                               ---------------


    If you are interested in working on the Debian web pages, please see:

                    https://www.debian.org/devel/website/

Build requirements
------------------

There are a range of tools needed to build even the basic bits of the
website, and then some extra/optional packages that you'll need for
some of the translations. Here's a (probably incomplete!) list...

Basics:

 * git             (you probably have this already if you're reading this!)
 * make            (to build the site)
 * gettext         (to handle the .po templates)
 * wget            (the build will use wget to grab some files as it runs)
 * wml             (the templating engine we use)
 * libxml-rss-perl, libintl-perl (for building Debian Weekly News RDF files)
 * isoquery        (for language names in the l10n stats)
 * python-lxml     (for the oval security advisories)
 

Translations:

 * opencc          (Chinese translation conversions)

 
You can find a comprehensive list of packages that needs to be installed 
to complete build the Debian website in the recipe used for www-master.debian.org:

https://salsa.debian.org/dsa-team/mirror/debian.org/blob/master/debian/control

(Note: that list includes the packages needed by the other scripts that are called
by cron and perform other tasks needed by the website but not contained in the webwml
repo (e.g. the manuals showed under www.debian.org/docs, release notes, 
tidy and URL checks...). See https://www.debian.org/devel/website/ for details

------------------

When building, you can pass STRICT_ERROR_CHECKS=1 to make, if you want the build
to stop when errors due to missing dependencies or missing data are found.

For a local build you probably need to use the USE_SAMPLE_FILES=1 setting, to 
use (small) sample files for data that is usually generated from cronjobs on the
official website. Examples include:

    $(DATADIR)/Maintainers
    $(ENGLISHSRCDIR)/$(CUR_DIR)/data/%
    $(L10N_DIR)/data/%
    $(ENGLISHDIR)/mirror/Mirrors.masterlist

See README_CI.gitlab-ci.yml for an example of the use of these settings.

------------------

To see the results of a build before pushing it out to the mirror network 
you can build in www-master.debian.org and then have a look at:

https://www-staging.debian.org/

------------------

© 2014-2024 Faster IT GmbH | imprint | privacy policy