tor-webwml.git

1) Here are the instructions I sent David Fifield when he asked about
2) editing the website. I hope they are useful for you too! --Roger
3) 

4) Copy Makefile.local.sample to Makefile.local in your webwml/ directory.
5) Point TORGIT to a tor git.

6) 
7) Then apt-get install wml and (alas) probably a shocking number of other
8) debs. Then you can type 'make' and it will build the website for you
9) locally. It's probably a smart move to see whether 'make' works before

10) you git commit any changes to the wml files.

11) 
12) You can edit docs/en/pluggable-transports.wml (and that is
13) the right source file to edit, not the html). But go take a
14) look at that file. You'll notice it has a bunch of tags like

15) <version-torbrowserbundle>. If you're just bumping version

16) numbers, you probably just want to change the definition of those tags.
17) They're in include/versions.wmi
18) 
19) (Every once in a while you may need to edit pluggable-transports.wml
20) too -- generally when you change the file name so drastically that just
21) changing the versions.wmi tags isn't enough.)
22) 

23) Pushes to the master branch of the git repository will cause the

24) website to get re-built and published. Pushing to the staging branch

25) will update www-staging.torproject.org.

26) 
27) Alas, https://www.torproject.org/dist/ isn't in version control. You

28) write to it by ssh'ing to dist-master.torproject.org and going to

29) /srv/dist-master.torproject.org/htdocs/ and then sticking your stuff
30) there. When you want it to go live, you run

31) "static-update-component dist.torproject.org" on dist-master.