Closed svenk closed 2 years ago
Actually the invocation of nbconvert
was already a fix/workaround for this problem. After the manual invocation of nbconvert with rst
as target format, make text
properly works.
This is certainly because sphinx then just uses the rst file directly:
WARNING: multiple files found for the document "examples/demo": ['examples/demo.ipynb', 'examples/demo.rst']
Use '....../examples/demo.rst' for the build.
Thanks for the report!
I'm not surprised that the text
builder doesn't work, because I've never used it.
How would you expect code cells to be formatted in text
output?
We would expect to get some sphinx output comparable to the following: [...]
In you example you are showing reST markup.
Do you really expect that?
I think the text
builder is not supposed to produce reST markup, or is it?
Just out of curiosity, what is your use case for the text
builder?
My interpretation of the text
builder is to basically strip all reST markup and to provide a "traditional" plaintext representation. This includes for instance text wrapping at 80 characters, proper indentation of lists, etc.
I admit that notebook to text or PDF is somewhat out of the scope of the typical notebook representation format (which is HTML).
text
builder.Does that solve your problem @svenk?
If there are still problems, feel free to create PRs!
I think this issue was solved with the new release https://github.com/spatialaudio/nbsphinx/releases/tag/0.8.8, thank you!
A minimalist worksheet cannot properly be converted with nbsphinx.
Having included the
demo.ipynb
inindex.rst
:We would expect to get some sphinx output comparable to the following:
Here is the content of demo.ipynb: