Compilation of existing tutorial contents, with a few new tutorials being added. Contents are originally intended to be distributed packaged in USB drive.
- Internet access
- Windows 7 / 8
- A microphone
Open %TUTORIAL_HOME%/index.htm (Tutorial documents are placed in %TUTORIAL_HOME%/doc).
While almost all the tutorial material included herein is hosted and maintained online on a github repository [1], you can update your USB drive easily by a normal "git-way". To do so:
- Double-click %TUTORIAL_HOME%/SELFUPDATE.bat; this runs git pull command and synchronizes data in the drive with the repository.
- It's possible that conflict occurs if you've added change to your USB drive. In this case, conflict may occur and currently no pre/post caution measure is implemented. Please take care of it in "git-way" by yourself.
Please report at the issue tracker [2].
Ubuntu or other platform where the following software is available is assumed:
- git
- sphinx-intl (via pip install sphinx-intl)
To keep the released version and development version, let's use following two branches:
- `devel`: Default. All developers and maintainers use this branch for the work.
- `master`: Released version. SELFUPDATE.bat only accesses this branch.
Discussion about this is found at [5].
You can freely create a USB thumbdrive using data maintained on the github repository [1].
On a computer where git is available, do:
$ cd %YOUR_USBDRIVE%
$ git clone https://github.com/tork-a/openrtm_tutorial.git
That's it.
Please do NOT modify .html (that you find under doc/_build, doc/locale) files directly. Instead, add changes to doc/*.rst files.
Those .rst files are currently written in Japanese only, but English is available too for the generated .html. That said, currently there's no way to update the document BY typing in English.
Both ja and en .html files are generated from .rst files by using sphinx-intl [3]. Several steps need to be run to generate .html files for both per language. Every time a change is to be applied to the source .rst, a maintainer run these steps.
Note: These processes may be insufficient in some situation. Your feedback is appreciated at [2].
- It's strongly recommended that you create a git branch, as always when you work on git.
- Add change to .rst
Run these commands.:
$ cd %OPENRTM_TUTORIAL%/doc (where conf.py exists) $ make gettext $ sphinx-intl update -p _build/locale -l en -l ja
Run also these.:
$ cd %OPENRTM_TUTORIAL%/doc (in case you're away) $ sphinx-intl build $ make -e SPHINXOPTS="-D language='ja'" html (not ideal, but "make"-ing `en` directly just skips for some reasons) $ cp -R _build/html/* locale/ja (Copy translation .html files to manually created folder `locale`) $ make -e SPHINXOPTS="-D language='en'" html $ cp -R _build/html/* locale/en (Copy translation .html files to manually created folder `locale`)
To update ONLY English translation, modify the corresponding %OPENRTM_TUTORIAL%/doc/locale/en/LC_MESSAGES/.po files (intermediate files that sphinx-intl uses to allow translation). Then run 3 in previous section.
Project funded by New Energy and Industrial Technology Development Organization (NEDO). Special thanks to Dr. Hara (AIST), Dr. Yuki Suga (Sugar Sweet Robotics).