README 1.56 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 20 21 22 23 24 25 26

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!)
 * wget            (the build will use wget to grab some files as it runs)
 * wml             (the templating engine we use)
 * libxml-rss-perl (for building Debian Weekly News RDF files)

Translations:

 * opencc          (Chinese translation conversions)
27

28 29 30 31 32 33 34 35 36 37
 
You can find a comprenhensive 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
38 39 40 41 42 43 44 45 46

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

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/

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