A new user of nbdev here and been loving it! A question - is there an option to include leading numbers/underscores when generating documentation through Quarto? I’m trying to use nbdev for bioinformatics/data analysis and I’ve gotten used to putting a YYYYMMDD_ date prefix to my notebooks, so I can easily see when a documentation/reference notebook was created.
I’m glad to hear you’re enjoying nbdev! When it comes to using Quarto with nbdev, the default behavior is to strip leading numbers and underscores from notebook filenames when generating documentation. Unfortunately, there’s no built-in option in nbdev to change this behavior directly.
However, you can work around this limitation. Here are a couple of approaches you might consider: StarbucksSecretMenu
- Rename Notebooks: After generating your documentation, you can rename the output files manually or use a script to add back the prefixes you want. This could be automated as part of your build process if you’re comfortable with scripting.
- Custom Template: If you’re familiar with Quarto’s templating, you could potentially create a custom template that retains your desired naming convention, although this might require more in-depth adjustments.
Hello,
Yes, you can include leading numbers or underscores in your documentation titles when using nbdev and Quarto. You can achieve this by using front matter in your Quarto Markdown files or by customizing the _quarto.yml configuration file. This way, you can easily add a date prefix like YYYYMMDD_ to your notebook titles for better organization.
Best Regards,
Julia Goff