[tor-bugs] #7699 [Ooni]: Add script/ for publishing the docs

[Tor Bug Tracker & Wiki]

#7699: Add script/ for publishing the docs
----------------------------+-----------------------------------------------
 Reporter:  hellais         |          Owner:  hellais
     Type:  task            |         Status:  new    
 Priority:  normal          |      Milestone:         
Component:  Ooni            |        Version:         
 Keywords:  SponsorH201210  |         Parent:         
   Points:                  |   Actualpoints:         
----------------------------+-----------------------------------------------
Changes (by aagbsn):

 * cc: weasel (added)


Comment:

 The commands to build and publish the docs are:
 building:
 {{{
 mkvirtualenv ooni
 workon ooni
 export PATH=$PATH:/path/to/ooni/bin
 export PYTHONPATH=$PYTHONPATH:/path/to/ooni
 pip install -r requirements.txt
 pip install cyclone # required by oonib and needed for building docs
 pip install numpy # ""
 cd docs
 make clean; make html
 }}}

 publishing
 1. as your user on staticiforme.torproject.org:
 {{{
 rsync -r build/html user at staticiforme.torproject.org:~/website/build/docs
 }}}
 2.
 as user ooni at staticiforme.torproject.org
 {{{
 mv ~/website/build/docs ~/docs.old # or rm the old docs
 cp -r /home/user/website/build/docs ~/website/build/docs
 }}}
 as your user on staticiforme.torproject.org:
 {{{
 sudo -u mirroradm static-master-update-component ooni.torproject.org
 sudo -u mirroradm static-master-run
 }}}

 Ideally we figure out a way to simplify this a bit; can we add ssh keys to
 the ooni user so we can rsync directly to /home/ooni/website/build ?

-- 
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/7699#comment:2>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online