Could you please share more about your use-case and the specific issues nbdev is giving? Are you referring to the table of contents in Quarto? What does your notebook contain?
So sorry for taking it so long to share the nbdev project.
At the moment I am using nbdev project to experiment source code of
fastcore.delegates to have a better understanding and to share what I found and ask questions at the same time.
On the front page, I introduced a tiny little problem of the source and showed a solution to it.
On the second page, I have done a dissection on the source code of
delegates starting from here which is heading level 2 and the subheadings extend to level 4. I can see headings down to level 3, but not level 4. This is when I wonder whether we can customize it to reveal more subheadings.
You are absolutely right that
show_doc can show us which params are from
to, which again demonstrates how brilliant fastai is. Here is a tiny use difficulty I found with
Thanks for your patience!
I have two questions concerning nbdev toc and search.
The links on the table of content generated from Jupyter notebook TOC extension don’t work on the preview nor on the website. Does it indicate that we should delete the table of content cell before pushing it to github?
The website search feature is great. When I search “question”, it gives me the detailed context of the searched word. The context includes heading (linked), keyword and the paragraph where it appeared. However, sometimes the heading link given is little far away from the keyword, as there is closer subheading link could be given. see the example below.
Also after clicking the search link provided, if the keyword can be automatically highlighted, that would be wonderful too. Can we customize it ourselves?
This is currently a limitation of Quarto. We’ve asked the Quarto folks to add this and they’re looking into it.
This is a quarto feature, not nbdev. So I’d suggest asking on the Quarto Discussions board:
Thank you Jeremy! I will look into Quarto discussion board for search feature.
Thanks I’ll fix the docs.
nbdev_install_hooks installs the jupyter hooks too now.
Got it, Thanks Jeremy.
I have another question about
#|echo: false. I think it should work as below.
However, when I tried it with my nbdev project, it didn’t hide the input.
I tried both
#|echo: false and
#|echo: False. Neither work on my side.
Sorry, no more problem! Now it is working.
I have a strange behavior of
doc in nbdev project.
but after I installed with
conda install -c fastai nbdev. The problem is gone.
After installed nbdev 2, it seems importing
nbdev_export in jupyter cell does not work anymore. But everything else works fine.
Check the version. I’m not sure you’ve got the latest.
You are right, it is working now!
I made the change on
07_meta.ipynb in my fork of fastcore, and after I run
nbdev_preview, I run
git diff and there are some auto changes to
_modidx.py file. Should this be happening?
Then I run
nbdev_preview and found the difference on the web
When I run
git diff, I found auto changes to
And there is auto changes on the
07_meta.ipynb file as well:
How should I deal with them? Thanks!
Should I simply make the change on
07_meta.ipynb and push without running
nbdev_prepare so that there won’t be those auto changes?
You should run
nbdev_install_hooks. That will remove that metadata added to the notebook for you. Also make sure you update to the latest fastcore, nbdev, and execnb versions. Thanks for being so thorough!
I have done all the updates and installs. However, right now, I got the following error message when running
I tried to
pip uninstall nbdev and reinstall it again, and
pip install -U nbdev and run
nbdev_install_hooks. Still got this same error message. What else should I try?
Can we convert ipynb file to markdown file, and from markdown file to ipynb file using
I found this post in 2020 about using
nbdev_nb2md to convert from notebook to markdown. But I can’t find any such command from nbdev2.
I have deleted mambaforge folder and reinstalled everything, but the error persisted.
I just released something which should fix this - please try updating nbdev.
I tried it but still not working for me.
First, I updated nbdev
Second, I ran
nbdev_prepare, no problem, but
nbdev_preview get me the following error message:
In order to see whether
nbdev_preview can work in the end, I comment out all the places where I import and use my lib
debuggable, but still can’t get
nbdev_preview to work properly.