Where to specify build environment (for things like autodoc/autosummary) in jupyter-book #211
Unanswered
tlambert03
asked this question in
Q&A
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
-
First off: thanks for jupyter-book. It's a truly awesome tech stack that has dramatically improved my documentation quality-of-life :)
Apologies if this is covered in the docs... I failed to find it. I'm trying to incorporate
sphinx.ext.autodoc
,sphinx.ext.autosummary
, and also trying to usesphinx_autodoc_typehints
. Everything is going pretty much ok, but I wanted to resolve aForwardRef
, I tried setting the "set_type_checking_flag
" as suggested in the autodc_typehints readme, and then got a lot of "failed to import 'my_own_package'
" style warnings when runningjb build
. In sphinx, I believe I would have just added something likesys.path.insert('..')
to myconf.py
, but I'm not sure A) how to do so with jupyter-book's_config.yml
... and B) whether I'm fundamentally misunderstanding something here about how this build stack plays with the "traditional" sphinx stack 😂any tips appreciated!
Beta Was this translation helpful? Give feedback.
All reactions