Can I modify build output folder from /_build/html to docs (for quick GitHub publish)?

[ttcceegg]

Hi,

I'm using a GitHub project to publish my documentation built by Sphinx.

But as Sphinx and GitHub use different build folders (Sphinx: /_build/html, GitHub: /docs), it bothersome for me to MANUALLY move files from /_build/html to /docs at every update.

I know that I can change the default output folder "_build" to another one.

But still the problem persists because the resulting html file set is not stored in the docs folder itself but in the subfolder /docs/html.

Is there any way to prevent the subfolder "html" from being created?

I can use and edit source py files a little, but the building code is quite complicated.

[Geert Stappers]

On 11-07-2019 07:59, ttcceegg wrote:

Hi,

I'm using a GitHub project to publish my documentation built by Sphinx.

But as Sphinx and GitHub use different build folders (Sphinx: /_build/html, GitHub: /docs), it bothersome for me to MANUALLY move files from /_build/html to /docs at every update.

I know that I can change the default output folder "_build" to another one.

But still the problem persists because the resulting html file set is not stored in the docs folder itself but in the subfolder /docs/html.

Is there any way to prevent the subfolder "html" from being created?

Untested idea:

Change directory  ./_build/html into symbolic link ./_build/html pointing to ./docs

Groeten

Geert Stappers

[Komiya Takeshi]

Hi,

You can do it with sphinx-build command. Please check manual page of
the command:
https://www.sphinx-doc.org/en/master/man/sphinx-build.html

Thanks,
Takeshi KOMIYA

2019年7月11日(木) 14:59 ttcceegg <sidt...@gmail.com>:

> --
> You received this message because you are subscribed to the Google Groups "sphinx-users" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
> To post to this group, send email to sphinx...@googlegroups.com.
> Visit this group at https://groups.google.com/group/sphinx-users.
> To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/d442cfad-3e05-48a6-84cc-9c3155156520%40googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.

[George Feng]

Hi,

Please check the repo: 

https://runawayhorse001.github.io/SphinxGithub/

It may help you! 

Best regards

Wenqiang 

To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/CAFmkQAN_nY8QyQup%2BC_ZocLUmMetiHn_cfVBCNFCbFT1M4qbGw%40mail.gmail.com.

[Godygoolë Я]

Yep, Sure.!.)

Отправлено из мобильной Почты Mail.ru

четверг, 11 июля 2562 г. BE, 10:12 ДП +0300 от geert.s...@hendrikx-itc.nl <geert.s...@hendrikx-itc.nl>:

--
You received this message because you are subscribed to the Google Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
To post to this group, send email to sphinx...@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.

To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/ff9df1e0-fcf6-6d21-5394-0d3ef2e862d4%40hendrikx-itc.nl.

[lebert david]