ASE Manual Release 3.6.1.2825 CAMd - CampOS Wiki

• cd to the doc directory,
• run sphinx-quickstart and answer the questions (example given for GPAW):
> Root path for the documentation [.]:
> Separate source and build directories (y/N) [n]:
> Name prefix for templates and static dir [.]: _
> Project name: GPAW
> Author name(s): 2008, CAMd et al.
> Project version: 0.5
> Project release [0.5]:
> Source file suffix [.rst]:
> Name of your master document (without suffix) [index]: contents
ASE Manual, Release 3.6.1.2828
> autodoc: automatically insert docstrings from modules (y/N) [n]: y
> doctest: automatically test code snippets in doctest blocks (y/N) [n]:
> intersphinx: link between Sphinx documentation of different projects (y/N) [n]: y
This will create doc/conf.py and doc/contents.rst. Both these files need to be edited further
(doc/conf.py may for example include options for sphinx.ext.pngmath)
11.1.7 Making movies
A video tutorial can be produced in the following way:
• change the screen resolution to 1280x1024,
• record the movie of the screen (without sound) using recordmydesktop (gtk-recordMyDesktop),
• convert the resulting ogv into avi using mencoder:
mencoder video.ogv -o video.avi -oac copy -ovc lavc
• record and edit the sound track using audacity:
– use 44100 Hz for recording and save the final file as sound.wav,
– make sure not to keep the microphone to close to avoid signal peaks,
– cut microphone signal peaks, insert silences, ...
• edit the movie using avidemux (to match the sound track):
– load the video.avi: File->Open, make sure to use the following options when editing and saving:
Video->Copy, Audio->Copy, Format->AVI,
– add the sound.avi: Audio->Main Track->Audio Source->External WAV,
– cut video frames (or copy and insert still frames to extend the video) to match the sound track. Set
beginning mark and end mark - the cut or copy/paste operation applies to the selected region,
– make sure to save intermediate stages when working on the video File->Save->Save Video (as AVI):
* avidemux caches the audio track so to match the audio to a freshly cut video you can copy the
audio file into another name, and add the sound track from that name,
* sometimes when cutting frames avidemux does not allow to set the markers correctly, and there
is no undo the last step in avidemux!
– save the video_final.avi (that matches the sound track), and encode it into mpeg4 format using mencoder,
using two passes:
11.1. Development topics 193