Comments (3)
Hey @mattgra, if I understand your requirement correctly, this is already possible in nbdev
.
To create tutorials, (do NOT add the #|default_exp
flag to your nb). You can check the nbdev
repo for this.
Then to update the sidebar, you can manually edit the _quarto.yml
file to get your desired sidebar configuration.
from nbdev.
Not sure i fully understand this solution.
In the repo you are showing the settings.ini
still points to the nbs
folder only. (https://github.com/fastai/nbdev/blob/master/settings.ini)
nbdev then recursively goes through all the folders inside nbs
and generates the docs (i.e., also for the explanations
, tutorials
, and API
folders. (see here: https://nbdev.fast.ai/api)
from nbdev.
Yes, that's correct. nbdev
recursively goes through the notebooks in the nbs
folder. The part where the notebooks differ in the api
folder vs the tutorials
folder is over here.
When the #|default_exp
flag is missing in a notebook, no python file is created for it, and it is rendered by nbdev
as docs.
from nbdev.
Related Issues (20)
- `proc_nbs` does not make use of its arguments `file_glob` and `file_re`
- Use of `pkg_resources` is deprecated
- Nested `lib_path` values break module -> notebook sync
- showdoc: SyntaxWarning: invalid escape sequence with Python 3.12
- update `ipywidgets` > 8.0.4 HOT 1
- Support Quarto Profiles
- [idea]support for deno or other languages(simple directive is enough) HOT 1
- fastai/workflows/quarto-ghp@master failing and reporting "no module named 'pandas' HOT 1
- nbdev_install_quarto doesn't work with Windows 10 system HOT 1
- Blog post broken links
- Add code folding for `exports`
- Move `exports` source after the show_doc
- Add magic `__` symbols to `show_doc` output
- Remove boxes since they broke ToC
- UnboundLocalError: cannot access local variable '_TEMPLATE' where it is not associated with a value HOT 2
- Auto-trust notebooks after `nbdev_clean`
- add `nbdev_requirements`
- Direct invocation of setup.py deprecated when uploading package to PyPi
- nbdev_docs doesn't provide location of error
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from nbdev.