Damian Johnson
Improving the readme instructions
Damian Johnson commited 43377598d at 2014-11-14 17:34:04
To quickly get set up simply do the following...
1. Get the website's build dependencies.
% sudo apt-get install wml asciidoc
2. Configure where to find your tor git repository. It needs this to make the
manual page.
% git clone https://git.torproject.org/project/web/webwml.git
% cd webwml
% cp Makefile.local.sample Makefile.local
[ change the TORGIT in Makefile.local to point to your tor git repo ]
3. Make the website.
% make
You should now be able to point your browser at the locally generated site...
file:///home/atagar/Desktop/tor/webwml/getinvolved/volunteer.html.en
--------------------------------------------------------------------------------
Troubleshooting
--------------------------------------------------------------------------------
* The build fails with "Invalid object name".
If you get an error like...
---- Contents of STDERR channel: ---------
fatal: Invalid object name 'tor-0.2.6.1-alpha'.
asciidoc: FAILED: manpage document title is mandatory
No manpage because of asciidoc error or file not available from git at /tmp/wml.zwcq0q/wml.30867.tmp1.wml line 415.
This means your tor repository is out of date. Update your tor git repository.
--------------------------------------------------------------------------------
More detailed instructions from Roger
--------------------------------------------------------------------------------
Here are the instructions I sent David Fifield when he asked about
editing the website. I hope they are useful for you too! --Roger
Copy Makefile.local.sample to Makefile.local in your webwml/ directory.
Point TORGIT 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 git commit any changes to the wml files.
 
 
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX