executablebooks / jupyter-book

Create beautiful, publication-quality books and documents from computational content.
http://jupyterbook.org
BSD 3-Clause "New" or "Revised" License
3.76k stars 652 forks source link

[ENH] jupyter-book config sphinx --output-dir #2074

Open parmentelat opened 8 months ago

parmentelat commented 8 months ago

this PR adds an option to jupyter-book config sphinx to select another folder for resulting conf.py

my use case: I have a rather big repo that ends up into 2 separate books https://github.com/flotpython/exos (admittedly this should be cut into pieces but that's another story...)

the jupyter-book stuff (config and tocs) are stored in a separate folder jb/ for clarity I can produce the 2 books locally easily enough

but when trying to move to readthedocs.io, I made many various attempts on how to layout things and call jb config sphinx but I'm running into a wall and it looks like my life would be way easier if the resulting conf.py ended up at the toplevel

so I figured, this change here looks innocuous enough, and it would help greatly to achieve this rtd migration, that I can't seem to provide otherwise

welcome[bot] commented 8 months ago

Thanks for submitting your first pull request! You are awesome! :hugs:
If you haven't done so already, check out EBP's Code of Conduct and our Contributing Guide, as this will greatly help the review process.
Welcome to the EBP community! :tada:

parmentelat commented 5 months ago

Hiya is there anything I can do to improve the chances of this PR ?

agoose77 commented 5 months ago

@parmentelat no! Let me get around to this later today.

parmentelat commented 2 months ago

trying to rekindle this, please let me know how to interpret the above results, and what I could do the help make it through