How to upload documentation using Sphinx to a debian server subfolder

I am completely new to the Sphinx. I read some material about this on the official Sphinx documentation site, and I completed the following steps to install and configure debian wheezy on my server:

  • First of all, I set the Sphinx source to http://example.com/documentation-path/ .

    pip install sphinx

  • I ran the sphinx-quickstart script to configure the root directory and conf.py.

    Sphinx-Quickstart

  • I ran the make html command to build the html files in my directory path.

    make html

  • I installed autobuild sphinx for every change / update of my documentation, as written in the post made by @ toast38coza .

    pip install sphinx-autobuild

    sphinx-autobuild source build/html

[ ]

, , http://127.0.0.1:8000 (localhost 8000). , URL, , . , , .

- URL- (http://example.com), -host -port, debian:

-p/- port , ( 8000) -H/- , ( 127.0.0.1)

, :

>> sphinx-autobuild source build/html --host http://example.com --port8000 

, , http://example.com:8000 .

[ ]

URL, , , http://example.com/documentation-path/, , Sphinx /documentation -path/?

[ ]

sphinx-autobuild --port --host debian?

[ ]

debian NGINX, .

+4
1

, NGINX.

location /documentation {
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_pass http://localhost:8000;
    index index.php index.html index.htm;
}

, Sphinx Markdown, couscousPHP - GitHub .

html ssh. html .md, couscous generate.

+2

Source: https://habr.com/ru/post/1673228/


All Articles