README
81f0fb78
 Here are the instructions I sent David Fifield when he asked about
 editing the website. I hope they are useful for you too! --Roger
 
87ab12b7
 Copy Makefile.local.sample to Makefile.local in your webwml/ directory.
 Point TORGIT to a tor git.
81f0fb78
 
 Then apt-get install wml and (alas) probably a shocking number of other
 debs. Then you can type 'make' and it will build the website for you
 locally. It's probably a smart move to see whether 'make' works before
87ab12b7
 you git commit any changes to the wml files.
81f0fb78
 
 You can edit docs/en/pluggable-transports.wml (and that is
 the right source file to edit, not the html). But go take a
 look at that file. You'll notice it has a bunch of tags like
4d71689c
 <version-torbrowserbundle>. If you're just bumping version
81f0fb78
 numbers, you probably just want to change the definition of those tags.
 They're in include/versions.wmi
 
 (Every once in a while you may need to edit pluggable-transports.wml
 too -- generally when you change the file name so drastically that just
 changing the versions.wmi tags isn't enough.)
 
40bfc7e4
 Pushes to the master branch of the git repository will cause the
87ab12b7
 website to get re-built and published. Pushing to the staging branch
40bfc7e4
 will update www-staging.torproject.org.
81f0fb78
 
 Alas, https://www.torproject.org/dist/ isn't in version control. You
87ab12b7
 write to it by ssh'ing to dist-master.torproject.org and going to
40bfc7e4
 /srv/dist-master.torproject.org/htdocs/ and then sticking your stuff
 there. When you want it to go live, you run
87ab12b7
 "static-update-component dist.torproject.org" on dist-master.
81f0fb78
 
 Weasel has hopes that somebody will write some scripts to make maintaining
 packages in dist/ less awful -- automatically check that they have
 signatures and that the sigs match, that the items on the website are in
 fact in dist, only allow certain people to put files in certain places,
 etc. One day! :)