README 1.77 KB
Newer Older
Josip Rodin's avatar
Josip Rodin committed
1 2 3 4 5 6 7

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


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

8
                    https://www.debian.org/devel/website/
9 10 11 12 13 14 15 16 17 18 19

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!)
20 21
 * make            (to build the site)
 * gettext         (to handle the .po templates)
22 23
 * wget            (the build will use wget to grab some files as it runs)
 * wml             (the templating engine we use)
24
 * libxml-rss-perl, libintl-perl (for building Debian Weekly News RDF files)
25 26
 * isoquery        (for language names in the l10n stats)
 * python-lxml     (for the oval security advisories)
27
 
28 29 30 31

Translations:

 * opencc          (Chinese translation conversions)
32

33
 
34
You can find a comprehensive list of packages that needs to be installed 
35 36 37 38 39 40 41 42
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
43 44 45 46 47 48 49 50 51

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

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/

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