-
Notifications
You must be signed in to change notification settings - Fork 11
How to edit the 3dcitydb docs in IntelliJ IDEA (Windows OS)
Zhihang Yao edited this page Jan 18, 2021
·
4 revisions
- Install Python 3+.
- Install sphinx via CLI like:
C:\> pip install -U sphinx
- Install the sphinx-rtd-theme via CLI
pip install sphinx-rtd-theme
- Install the IntelliJ plugin
restructuredtext
- Install the IntelliJ plugin
File Watchers
- In IntelliJ, open the dialog via
File -> Settings -> Tools -> File Watchers
, add a new project with the following settings- Name : e.g.
Sphinx
- Files to watch -> File Type :
restructuredtext
- Files to watch -> Scope :
Project Files
- Tool to Run on changes -> Program :
sphinx-build
- Tool to Run on Arguments-> Program :
-b html source build
- Tool to Run on changes -> Working directory :
$ProjectFileDir$
- Name : e.g.
- Open Terminal, the root should be the project folder. Run
sphinx-build -b html source build
- Under the project folder, a subfolder
build
will be created. In IntelliJ, right-click on theindex.html
file and chooseRun index.html
in the context menu. - The 3dcitydb-docs' welcome page will be opened in your default webbrowser. You can now edit any source file (.rst) and the html files will be created immediatelly. You just need to refresh the browser page and check the changes. Enjoy!