Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

nextgis/docs_ng

Repository files navigation

NextGIS documentation root repository

Root repository for NextGIS user and developer documentation

Main repositories

To start generating documentation locally you need some packages be installed python > 2.7 and:

  1. sudo pip install sphinx
  2. sudo apt-get install texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended
  3. sudo apt-get install texlive-doc-ru texlive-lang-cyrillic texlive-fonts-extra
  4. sudo pip install sphinxcontrib-httpdomain sphinx-bootstrap-theme
  5. sudo apt-get install latexmk

You can install packages in virtual environment, so 1 and 4 must be executed in vetualenv:

  1. source env/bin/activate
  2. pip install sphinx
  3. pip install sphinxcontrib-httpdomain sphinx-bootstrap-theme

You have to generate key for ssh git access. See: https://help.github.com/articles/generating-ssh-keys/

git clone --recursive git@github.com:nextgis/docs_ng.git
cd docs_ng
make html
make latexpdf

See wiki for future details

Update documentation

Documentation automaticaly updates on docs.nextgis.com after git push or edits on Github:

  • Clone or pull this repository (как правильно)
  • Wait buildbot task finished (check repository changes each 15 minutes)

Build status

build status

Режим разработки

Для отслеживания изменений frontend-ассетов:

npm run dev

Если одновременно редактируются .rst-страницы и шаблоны Sphinx, удобно в отдельном терминале запускать сборку с отслеживанием изменений:

sphinx-autobuild source build

Переводы

pybabel compile --directory=source/locale --domain=messages
pybabel compile --directory=source/locale --domain=sphinx

License

This documentaion is licensed under CC-BY-ND 3.0

AltStyle によって変換されたページ (->オリジナル) /