[tor-commits] r26386: {website} capture my "how to edit the website" instructions to dcf, fo (website/trunk)

[Roger Dingledine]

Author: arma
Date: 2013-10-17 03:08:47 +0000 (Thu, 17 Oct 2013)
New Revision: 26386

Added:
   website/trunk/README
Modified:
   website/trunk/publish
Log:
capture my "how to edit the website" instructions to dcf, for posterity


Added: website/trunk/README
===================================================================
--- website/trunk/README	                        (rev 0)
+++ website/trunk/README	2013-10-17 03:08:47 UTC (rev 26386)
@@ -0,0 +1,43 @@
+Here are the instructions I sent David Fifield when he asked about
+editing the website. I hope they are useful for you too! --Roger
+
+See the Makefile.local file in your website/trunk/ directory. Uncomment
+TORGIT and point it to a tor git.
+
+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
+you svn commit any changes to the wml file.
+
+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
+<version-torobfsbundlelinux64alpha>. If you're just bumping version
+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.)
+
+If you want to push your locally built website to the remote webserver,
+run the ./publish script in website/trunk/. It will rsync everything
+over, and then it will ask www-master.tp.o to run its trigger-mirrors
+script which causes www-master to rsync to all the servers in the www.tp.o
+rotation. To push the website, you'll need to be in the torwww ldap group
+(which is separate from whether you can commit to svn).
+
+Alas, https://www.torproject.org/dist/ isn't in version control. You
+write to it by ssh'ing to www-master.torproject.org and going to
+/srv/www-master.torproject.org/htdocs/dist/ and then sticking your stuff
+there. When you want it to go live, you run ./publish from your local
+website checkout, which will trigger the trigger-mirrors run. (It's
+possible that you can simply run /home/mirroradm/bin/trigger-mirrors on
+www-master too, but I've never tried.)
+
+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! :)
+

Modified: website/trunk/publish
===================================================================
--- website/trunk/publish	2013-10-16 03:41:15 UTC (rev 26385)
+++ website/trunk/publish	2013-10-17 03:08:47 UTC (rev 26386)
@@ -25,6 +25,7 @@
 	--exclude '.*.sw[po]' \
 	--exclude .deps \
 	--exclude svn \
+	--exclude README \
 	--exclude dist \
 	--exclude releases \
 	--exclude torbutton-current.xpi \