Table of Contents
- 1 Project Introduction
- 2 System Environment Requirement
- 3 To Start Tutorial
- 4 Online Update
- 5 If You Find Issues
- 6 For Tutorial Maintainers
- 7 Funding, Special Thanks
A set of OpenRTM tutorials for Windows users. Contents here are particularly intended to be packaged in a USB thumbdrive (so that users can run the tutorials from the thumbdrive on their machines with minimal installation beforehand).
- Internet access
- Windows 7 / 8 * For WEB Browser, Internet Explorer is intended. For other browser some useful features (that are based on ActiveX) are not enabled.
- A microphone
Open %TUTORIAL_HOME%/index.htm (Tutorial documents are placed in %TUTORIAL_HOME%/doc).
If you own a packaged USB that contains the contents here, you can update your USB drive easily by a normal "git-way" (almost all the tutorial material included herein is hosted and maintained online on a github repository ). 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 .
Ubuntu or other platform where the following software is available is assumed:
- 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 .
You can freely create a USB thumbdrive using data maintained on the github repository .
On a computer where git is available, do:
$ cd %YOUR_USBDRIVE% $ git clone https://github.com/tork-a/openrtm_tutorial.git
NOTE: The folder structure in USB is assumed to maintain openrtm_tutorial at the top folder like this:
%USBDRIVE%:\openrtm_tutorial F:\openrtm_tutorial (e.g. If the USB is recognized as F drive)
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. Please follow the instruction below for how to update the English document.
Both ja and en .html files are generated from .rst files by using sphinx-intl . 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 .
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).