Skip to content

MAgojam/jamoviDocs

 
 

Repository files navigation

jamoviDocs

jamovi documentation using Sphinx. The documentation is available at https://jamovi.readthedocs.io (and translations can be chosen by clicking at the menu that unfolds after pressing at «Read the Docs» at the bottom). Whoever would like to contribute with translations, please read a little further down.


Install and build (first time):

$ virtualenv _env
$ source _env/bin/activate
Set up and activate the virtual environment.

$ pip3 install -r requirements.txt
Install the required packages (wheels) in the virtual environment.

$ make html
Create a first version of the HTML build (i.e., showing how the web is going to look like later). This HTML build can afterwards be opened as _build/html/index.html in your browser.


Install and build (later):

$ virtualenv _env
$ source _env/bin/activate
Set up and activate the virtual environment.

$ python3 -m pip install --upgrade --no-cache-dir pip 'setuptools<58.3.0' $ python3 -m pip install --upgrade --no-cache-dir pillow mock==1.0.1 'alabaster>=0.7,<0.8,!=0.7.5' commonmark==0.9.1 recommonmark==0.5.0 sphinx sphinx-rtd-theme 'readthedocs-sphinx-ext<2.3' $ python3 -m pip install --exists-action=w --no-cache-dir -r requirements.txt
Update the required packages (wheels) in the virtual environment (if necessary).

$ ./.crtLng.sh
Creates / updates the language files.

$ rm -fR _build/{html,doctrees} && git submodule update --remote && git add _locale && git commit -am "Weblate-updates ($(date +%F))" && git push && for L in $(less .languages); do sphinx-build -b html -D language=${L} . _build/html/${L}; rm -fR _build/html/${L}/.doctrees; if [ "${L}" != "en" ]; then cd _build/html/${L}; for D in _images _static; do rm -fR ${D}; ln -s ../en/${D}; done; cd -; fi; done
Pull the translated resources and build the documentation in the target language. Please note that if you would like to build for any other language than English (en) or German (de) you will have to add the language code in the for loop. After building, the doctree-pickles are removed and, if the lanaguage is not English (default), the directories _images and _static are removed from the translated directories and linked to the respective directories under "en".

NB: Before using the weblate repository for the first time, it has to be added using the following command (the second part prevents from accidentially pushing to it): $ git remote add weblate https://hosted.weblate.org/git/jamovidocs/0_start/ && git remote set-url --push weblate DISABLED

After it is pushed to the github-repository, readthedocs is reading from the respective language project there (which is then integrated into the main documentation).


How to contribute with your translations?

If you are willing to contribute to the project with translating it into your language, please obtain further information about how to get involved. The following status overview tells you how much content for your language already has been translated.

Translation status

Please also have a look at two other translation projects related to jamovi, the translation of the jamovi user interface and the translation of the textbook "Learning statistics with jamovi"

We are grateful to the Weblate-team who host libre projects as ours free of charge.

About

jamovi-documentation (rST / HTML)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 45.2%
  • CSS 25.8%
  • Shell 11.4%
  • MATLAB 10.8%
  • HTML 2.5%
  • Makefile 2.2%
  • JavaScript 2.1%