nbdev 2.4.10__py3-none-any.whl → 2.4.12__py3-none-any.whl

nbdev/process.py

@@ -2,10 +2,10 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/03_process.ipynb.
 
-# %% auto 0
+# %% auto #0
 __all__ = ['langs', 'nb_lang', 'first_code_ln', 'extract_directives', 'opt_set', 'instantiate', 'NBProcessor', 'Processor']
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #59172c3d
 from .config import *
 from .maker import *
 from .imports import *
@@ -16,7 +16,7 @@ from fastcore.imports import *
 
 from collections import defaultdict
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #48e04902-f4a1-4247-ae0c-1e30bc054166
 # from https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/jupyter/notebook.py
 langs = defaultdict(
     lambda: '#',  r = "#", python = "#", julia = "#", scala = "//", matlab = "%", csharp = "//", fsharp = "//",
@@ -25,14 +25,14 @@ langs = defaultdict(
     java = "//", groovy = "//", sed = "#", perl = "#", ruby = "#", tikz = "%", javascript = "//", js = "//", d3 = "//", node = "//",
     sass = "//", coffee = "#", go = "//", asy = "//", haskell = "--", dot = "//", apl = "⍝")
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #c54390ab-1cb9-4146-9e88-609f1fc5544a
 def nb_lang(nb): return nested_attr(nb, 'metadata.kernelspec.language', 'python')
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #2974d8cc-870c-4362-b2b1-e35f94c28dd9
 def _dir_pre(lang=None): return fr"\s*{langs[lang]}\s*\|"
 def _quarto_re(lang=None): return re.compile(_dir_pre(lang) + r'\s*[\w|-]+\s*:')
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #484a1df8
 def _directive(s, lang='python'):
     s = re.sub('^'+_dir_pre(lang), f"{langs[lang]}|", s)
     if s.strip().endswith(':'): s = s.replace(':', '') # You can append colon at the end to be Quarto compliant.  Ex: #| hide:
@@ -42,13 +42,13 @@ def _directive(s, lang='python'):
     direc,*args = s
     return direc,args
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #100a91fb-8b46-4feb-afbf-d1e78c14cfd6
 def _norm_quarto(s, lang='python'):
     "normalize quarto directives so they have a space after the colon"
     m = _quarto_re(lang).match(s)
     return m.group(0) + ' ' + _quarto_re(lang).sub('', s).lstrip() if m else s
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #69befb76-aa77-4923-bfcc-2606613d706f
 _cell_mgc = re.compile(r"^\s*%%\w+")
 
 def first_code_ln(code_list, re_pattern=None, lang='python'):
@@ -56,14 +56,14 @@ def first_code_ln(code_list, re_pattern=None, lang='python'):
     if re_pattern is None: re_pattern = _dir_pre(lang)
     return first(i for i,o in enumerate(code_list) if o.strip() != '' and not re.match(re_pattern, o) and not _cell_mgc.match(o))
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #b3eee2d6-59b9-45f3-affd-4de2bd1284d1
 def _partition_cell(cell, lang):
     if not cell.source: return [],[]
     lines = cell.source.splitlines(True)
     first_code = first_code_ln(lines, lang=lang)
     return lines[:first_code],lines[first_code:]
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #3cca78a4
 def extract_directives(cell, remove=True, lang='python'):
     "Take leading comment directives from lines of code in `ss`, remove `#|`, and split"
     dirs,code = _partition_cell(cell, lang)
@@ -73,22 +73,22 @@ def extract_directives(cell, remove=True, lang='python'):
         cell['source'] = ''.join([_norm_quarto(o, lang) for o in dirs if _quarto_re(lang).match(o) or _cell_mgc.match(o)] + code)
     return dict(L(_directive(s, lang) for s in dirs).filter())
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #e6701805
 def opt_set(var, newval):
     "newval if newval else var"
     return newval if newval else var
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #98c9d556
 def instantiate(x, **kwargs):
     "Instantiate `x` if it's a type"
     return x(**kwargs) if isinstance(x,type) else x
 
 def _mk_procs(procs, nb): return L(procs).map(instantiate, nb=nb)
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #ab147efe
 def _is_direc(f): return getattr(f, '__name__', '-')[-1]=='_'
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #7c81f109
 class NBProcessor:
     "Process cells and nbdev comments in a notebook"
     def __init__(self, path=None, procs=None, nb=None, debug=False, rm_directives=True, process=False):
@@ -128,7 +128,7 @@ class NBProcessor:
         "Process all cells with all processors"
         for proc in self.procs: self._proc(proc)
 
-# %% ../nbs/api/03_process.ipynb
+# %% ../nbs/api/03_process.ipynb #fa1f8668
 class Processor:
     "Base class for processors"
     def __init__(self, nb): self.nb = nb

nbdev/processors.py

@@ -2,12 +2,12 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/10_processors.ipynb.
 
-# %% auto 0
+# %% auto #0
 __all__ = ['populate_language', 'insert_warning', 'cell_lang', 'add_show_docs', 'fdiv', 'boxify', 'mv_exports', 'add_links',
            'add_fold', 'strip_ansi', 'strip_hidden_metadata', 'hide_', 'hide_line', 'filter_stream_', 'ai_magics',
            'clean_magics', 'rm_header_dash', 'rm_export', 'clean_show_doc', 'exec_show_docs', 'FilterDefaults']
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #2398f5ef-06d3-4890-8a54-7cf4f81f3894
 import ast
 import importlib
 
@@ -25,7 +25,7 @@ from fastcore.imports import *
 from fastcore.xtras import *
 import sys,yaml
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #8ab33554
 _langs = 'bash|html|javascript|js|latex|markdown|perl|ruby|sh|svg'
 _lang_pattern = re.compile(rf'^\s*%%\s*({_langs})\s*$', flags=re.MULTILINE)
 
@@ -38,13 +38,13 @@ class populate_language(Processor):
         if lang: cell.metadata.language = lang[0]
         else: cell.metadata.language = self.language
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #382949b3
 class insert_warning(Processor):
     "Insert Autogenerated Warning Into Notebook after the first cell."
     content = "<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->"
     def begin(self): self.nb.cells.insert(1, mk_cell(self.content, 'markdown'))
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #aa1069b1
 _def_types = (ast.FunctionDef,ast.AsyncFunctionDef,ast.ClassDef)
 def _def_names(cell, shown):
     cellp = cell.parsed_()
@@ -57,7 +57,7 @@ def _get_nm(tree):
     else: val = try_attrs(i.value, 'id', 'func', 'attr')
     return f'{val}.{i.attr}' if isinstance(i, ast.Attribute) else i.id
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #13cbb041
 def _show_docs(trees):
     return [t for t in trees if isinstance(t,ast.Expr) and nested_attr(t, 'value.func.id')=='show_doc']
 
@@ -84,20 +84,20 @@ class add_show_docs(Processor):
                 nb.cells.insert(cell.idx_+1, new_cell)
         nb.has_docs_ = shown_docs or exports
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #22b1972e
 def fdiv(attrs=''):
     "Create a fenced div markdown cell in quarto"
     if attrs: attrs = ' {'+attrs+'}'
     return mk_cell(':::'+attrs, cell_type='markdown')
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #27bc8ad4
 def boxify(cells):
     "Add a box around `cells`"
     if not isinstance(cells, list): cells = [cells]
     res = [fdiv('.py-2 .px-3 .mb-4 fig-align="center" .border .rounded .shadow-sm')]
     return res+cells+[fdiv()]
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #0a7127ef
 class mv_exports(Processor):
     "Move `exports` cells to after the `show_doc`"
     def begin(self):
@@ -110,7 +110,7 @@ class mv_exports(Processor):
                 srccell = cells.pop(idx)
                 cells[idx:idx] = [doccell,srccell]
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #e7eff7d4
 _re_defaultexp = re.compile(r'^\s*#\|\s*default_exp\s+(\S+)', flags=re.MULTILINE)
 
 def _default_exp(nb):
@@ -119,7 +119,7 @@ def _default_exp(nb):
     default_exp = first(code_src.filter().map(_re_defaultexp.search).filter())
     return default_exp.group(1) if default_exp else None
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #03e8fece-bf92-4a1d-9f8b-ef209107ff95
 def add_links(cell):
     "Add links to markdown cells"
     nl = NbdevLookup()
@@ -128,13 +128,13 @@ def add_links(cell):
         if hasattr(o, 'data') and hasattr(o['data'], 'text/markdown'):
             o.data['text/markdown'] = [nl.link_line(s) for s in o.data['text/markdown']]
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #809e9225
 def add_fold(cell):
     "Add `code-fold` to `exports` cells"
     if cell.cell_type != 'code' or 'exports' not in cell.directives_: return
     cell.source = f'#| code-fold: show\n#| code-summary: "Exported source"\n{cell.source}'
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #84073fa6-5907-41f2-b8b8-568a96112fbd
 _re_ansi_escape = re.compile(r'\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])')
 
 def strip_ansi(cell):
@@ -142,17 +142,17 @@ def strip_ansi(cell):
     for outp in cell.get('outputs', []):
         if outp.get('name')=='stdout': outp['text'] = [_re_ansi_escape.sub('', o) for o in outp.text]
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #640b7eca
 def strip_hidden_metadata(cell):
     '''Strips "hidden" metadata property from code cells so it doesn't interfere with docs rendering'''
     if cell.cell_type == 'code' and 'metadata' in cell: cell.metadata.pop('hidden',None)
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #995ebd32
 def hide_(cell):
     "Hide cell from output"
     del(cell['source'])
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #eb415328-044f-44ca-ac77-4f5ae65c2235
 def _re_hideline(lang=None): return re.compile(fr'{langs[lang]}\|\s*hide_line\s*$', re.MULTILINE)
 
 def hide_line(cell):
@@ -161,7 +161,7 @@ def hide_line(cell):
     if cell.cell_type == 'code' and _re_hideline(lang).search(cell.source):
         cell.source = '\n'.join([c for c in cell.source.splitlines() if not _re_hideline(lang).search(c)])
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #f8ccf1d7
 def filter_stream_(cell, *words):
     "Remove output lines containing any of `words` in `cell` stream output"
     if not words: return
@@ -169,7 +169,7 @@ def filter_stream_(cell, *words):
         if outp.output_type == 'stream':
             outp['text'] = [l for l in outp.text if not re.search('|'.join(words), l)]
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #848fd452-3d63-4c41-aaa6-e14cbeb9fdcd
 _aimagics_pattern = re.compile(r'^\s*(%%ai.? |%%ai.?$)', re.MULTILINE)
 
 def ai_magics(cell):
@@ -178,14 +178,14 @@ def ai_magics(cell):
         cell.cell_type ='markdown'
         cell.source = '\n'.join(cell.source.splitlines()[1:])
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #5a9c8fd4
 _magics_pattern = re.compile(r'^\s*(%%|%).*', re.MULTILINE)
 
 def clean_magics(cell):
     "A preprocessor to remove cell magic commands"
     if cell.cell_type == 'code': cell.source = _magics_pattern.sub('', cell.source).strip()
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #93e27a52
 _re_hdr_dash = re.compile(r'^#+\s+.*\s+-\s*$', re.MULTILINE)
 
 def rm_header_dash(cell):
@@ -194,14 +194,14 @@ def rm_header_dash(cell):
         src = cell.source.strip()
         if cell.cell_type == 'markdown' and src.startswith('#') and src.endswith(' -'): del(cell['source'])
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #75faf537
 _hide_dirs = {'export','exporti', 'hide','default_exp'}
 
 def rm_export(cell):
     "Remove cells that are exported or hidden"
     if cell.directives_ and (cell.directives_.keys() & _hide_dirs): del(cell['source'])
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #2d9a0a30
 _re_showdoc = re.compile(r'^show_doc', re.MULTILINE)
 def _is_showdoc(cell): return cell['cell_type'] == 'code' and _re_showdoc.search(cell.source)
 def _add_directives(cell, d):
@@ -213,7 +213,7 @@ def clean_show_doc(cell):
     if not _is_showdoc(cell): return
     _add_directives(cell, {'output':'asis','echo':'false'})
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #6ebda551
 def _ast_contains(trees, types):
     for tree in trees:
         for node in ast.walk(tree):
@@ -234,7 +234,7 @@ def _do_eval(cell):
         return True
     if _show_docs(trees): return True
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #867cf721
 class exec_show_docs(Processor):
     "Execute cells needed for `show_docs` output, including exported cells and imports"
     def begin(self):
@@ -261,13 +261,13 @@ class exec_show_docs(Processor):
             widgets = {**old, **new, 'state': {**old.get('state', {}), **new['state']}}
             self.nb.metadata['widgets'] = {mimetype: widgets}
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #a761e07c
 def _import_obj(s):
     mod_nm, obj_nm = s.split(':')
     mod = importlib.import_module(mod_nm)
     return getattr(mod, obj_nm)
 
-# %% ../nbs/api/10_processors.ipynb
+# %% ../nbs/api/10_processors.ipynb #4b450cff
 class FilterDefaults:
     "Override `FilterDefaults` to change which notebook processors are used"
     def xtra_procs(self):

nbdev/qmd.py

@@ -2,17 +2,17 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/15_qmd.ipynb.
 
-# %% ../nbs/api/15_qmd.ipynb 2
+# %% ../nbs/api/15_qmd.ipynb #6a35c7c4-748f-4c82-a9bf-c780a8d83e90
 from __future__ import annotations
 import sys,os,inspect
 
 from fastcore.utils import *
 from fastcore.meta import delegates
 
-# %% auto 0
+# %% auto #0
 __all__ = ['meta', 'div', 'img', 'btn', 'tbl_row', 'tbl_sep']
 
-# %% ../nbs/api/15_qmd.ipynb
+# %% ../nbs/api/15_qmd.ipynb #5a64f1f4
 def meta(md,  # Markdown to add meta to
          classes=None,  # List of CSS classes to add
          style=None,  # Dict of CSS styles to add
@@ -27,7 +27,7 @@ def meta(md,  # Markdown to add meta to
     meta = ' '.join(meta)
     return md + ("{" + meta + "}" if meta else "")
 
-# %% ../nbs/api/15_qmd.ipynb
+# %% ../nbs/api/15_qmd.ipynb #52637a70
 def div(txt,  # Markdown to add meta to
         classes=None,  # List of CSS classes to add
         style=None,  # Dict of CSS styles to add
@@ -35,7 +35,7 @@ def div(txt,  # Markdown to add meta to
     "A qmd div with optional metadata section"
     return meta("::: ", classes=classes, style=style, **kwargs) + f"\n\n{txt}\n\n:::\n\n"
 
-# %% ../nbs/api/15_qmd.ipynb
+# %% ../nbs/api/15_qmd.ipynb #f9f499f4
 def img(fname,  # Image to link to
         classes=None,  # List of CSS classes to add
         style=None,   # Dict of CSS styles to add
@@ -53,7 +53,7 @@ def img(fname,  # Image to link to
     res = meta(f'![]({fname})', classes=classes, style=style, **kwargs)
     return  f'[{res}]({fname})' if link else res
 
-# %% ../nbs/api/15_qmd.ipynb
+# %% ../nbs/api/15_qmd.ipynb #16d7aa5f
 def btn(txt, # Button text
         link,  # Button link URL
         classes=None,  # List of CSS classes to add
@@ -62,20 +62,20 @@ def btn(txt, # Button text
     "A qmd button"
     return meta(f'[{txt}]({link})', classes=classes, style=style, role="button")
 
-# %% ../nbs/api/15_qmd.ipynb
+# %% ../nbs/api/15_qmd.ipynb #e414ed33
 def tbl_row(cols:list,  # Auto-stringified columns to show in the row
            ):
     "Create a markdown table row from `cols`"
     return '|' + '|'.join(str(c or '') for c in cols) + '|'
 
-# %% ../nbs/api/15_qmd.ipynb
+# %% ../nbs/api/15_qmd.ipynb #38f0641b
 def tbl_sep(sizes:int|list=3  # List of column sizes, or single `int` if all sizes the same
            ):
     "Create a markdown table separator with relative column size `sizes`"
     if isinstance(sizes,int): sizes = [3]*sizes
     return tbl_row('-'*s for s in sizes)
 
-# %% ../nbs/api/15_qmd.ipynb
+# %% ../nbs/api/15_qmd.ipynb #a0d6553e-05ab-4db2-b739-aeee59a9ff31
 def _install_nbdev():
     return div('''#### pip
 

nbdev/quarto.py

@@ -2,7 +2,7 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/14_quarto.ipynb.
 
-# %% ../nbs/api/14_quarto.ipynb 3
+# %% ../nbs/api/14_quarto.ipynb #6a35c7c4-748f-4c82-a9bf-c780a8d83e90
 from __future__ import annotations
 import subprocess,sys,shutil,ast,warnings,traceback
 from os import system
@@ -19,17 +19,17 @@ from .serve import proc_nbs,_proc_file
 from . import serve_drv
 import yaml
 
-# %% auto 0
+# %% auto #0
 __all__ = ['BASE_QUARTO_URL', 'install_quarto', 'install', 'IndentDumper', 'nbdev_sidebar', 'refresh_quarto_yml',
            'nbdev_proc_nbs', 'nbdev_readme', 'nbdev_contributing', 'nbdev_docs', 'prepare', 'fs_watchdog',
            'nbdev_preview']
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #aae2d2be-ad03-4536-bf70-c4575f39cea3
 def _sprun(cmd):
     try: subprocess.check_output(cmd, shell=True)
     except subprocess.CalledProcessError as cpe: sys.exit(cpe.returncode)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #75e4b6a1
 BASE_QUARTO_URL='https://www.quarto.org/download/latest/'
 
 def _install_linux():
@@ -56,7 +56,7 @@ def install_quarto():
         elif 'linux' in sys.platform: _install_linux()
     finally: system('sudo rm -f .installing')
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #7580d48f-e10e-4bb0-937e-90645b5dfd08
 @call_parse
 def install():
     "Install Quarto and the current library"
@@ -64,7 +64,7 @@ def install():
     d = get_config().lib_path
     if (d/'__init__.py').exists(): system(f'pip install -e "{d.parent}[dev]"')
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #b93f6def
 def _pre(p,b=True): return '    ' * (len(p.parts)) + ('- ' if b else '  ')
 def _sort(a):
     x,y = a
@@ -81,7 +81,7 @@ def _nbglob_docs(
     **kwargs):
     return nbglob(path, file_glob=file_glob, file_re=file_re, **kwargs)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #37ab90f4
 def _recursive_parser(
         dir_dict: dict, # Directory structure as a dict.
         contents: list, # `contents` list from `sidebar.yaml` template dict.
@@ -104,7 +104,7 @@ class IndentDumper(yaml.Dumper):
     def increase_indent(self, flow=False, indentless=False):
         return super(IndentDumper, self).increase_indent(flow, False)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #d879c7e1
 @call_parse
 @delegates(_nbglob_docs)
 def nbdev_sidebar(
@@ -139,7 +139,7 @@ def nbdev_sidebar(
     if printit: return print(yml)
     yml_path.write_text(yml)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #aabf2f15
 _quarto_yml="""project:
   type: website
 
@@ -163,7 +163,7 @@ website:
 
 metadata-files: [nbdev.yml, sidebar.yml]"""
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #faabf6e6
 _nbdev_yml="""project:
   output-dir: {doc_path}
 
@@ -175,7 +175,7 @@ website:
   repo-url: "{git_url}"
 """
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #38124450
 def refresh_quarto_yml():
     "Generate `_quarto.yml` from `settings.ini`."
     cfg = get_config()
@@ -189,13 +189,13 @@ def refresh_quarto_yml():
     if qy.exists() and not str2bool(cfg.get('custom_quarto_yml', True)): qy.unlink()
     if not qy.exists(): qy.write_text(_quarto_yml)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #975d370e
 def _ensure_quarto():
     if shutil.which('quarto'): return
     print("Quarto is not installed. We will download and install it for you.")
     install.__wrapped__()
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #6b880922
 def _pre_docs(path=None, n_workers:int=defaults.cpus, **kwargs):
     cfg = get_config()
     path = Path(path) if path else cfg.nbs_path
@@ -207,21 +207,21 @@ def _pre_docs(path=None, n_workers:int=defaults.cpus, **kwargs):
     cache = proc_nbs(path, n_workers=n_workers, **kwargs)
     return cache,cfg,path
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #e3806fa9
 @call_parse
 @delegates(proc_nbs)
 def nbdev_proc_nbs(**kwargs):
     "Process notebooks in `path` for docs rendering"
     _pre_docs(**kwargs)[0]
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #c5c7bb0e
 def _doc_mtime_not_older(readme_path, readme_nb_path):
     if not readme_nb_path.exists():
         print(f"Could not find {readme_nb_path}")
         return True
     return readme_path.exists() and readme_path.stat().st_mtime>=readme_nb_path.stat().st_mtime
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #7b70b5c8
 class _SidebarYmlRemoved:
     "Context manager for `nbdev_readme` to avoid rendering whole docs website"
     def __init__(self,path): self._path=path
@@ -234,14 +234,14 @@ class _SidebarYmlRemoved:
     def __exit__(self, exc_type, exc_value, exc_tb):
         if self._moved: (self._path/'sidebar.yml.bak').rename(self._yml_path)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #49661bbf
 def _copytree(a,b):
     if sys.version_info.major >=3 and sys.version_info.minor >=8: copytree(a, b, dirs_exist_ok=True)
     else:
         from distutils.dir_util import copy_tree
         copy_tree(a, b)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #caeaa153
 def _save_cached_readme(cache, cfg):
     tmp_doc_path = cache/cfg.doc_path.name
     readme = tmp_doc_path/'README.md'
@@ -252,7 +252,7 @@ def _save_cached_readme(cache, cfg):
         _rdmi = tmp_doc_path/((cache/cfg.readme_nb).stem + '_files') # Supporting files for README
         if _rdmi.exists(): _copytree(_rdmi, cfg.config_path/_rdmi.name)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #45d6bb5d
 @call_parse
 def nbdev_readme(
     path:str=None, # Path to notebooks
@@ -268,7 +268,7 @@ def nbdev_readme(
         
     _save_cached_readme(cache, cfg)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #ef3f1e1f
 def _save_cached_contributing(cache, cfg, contrib_nb):
     "Move CONTRIBUTING.md (and any `_files` assets) from the Quarto build cache to the repo root."
     tmp_doc_path = cache / cfg.doc_path.name
@@ -280,7 +280,7 @@ def _save_cached_contributing(cache, cfg, contrib_nb):
         assets_folder = tmp_doc_path / (Path(contrib_nb).stem + '_files') # Supporting files for CONTRIBUTING
         if assets_folder.exists(): _copytree(assets_folder, cfg.config_path / assets_folder.name)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #729a0fa1
 @call_parse
 def nbdev_contributing(
     path:str=None,  # Path to notebooks
@@ -300,7 +300,7 @@ def nbdev_contributing(
         
     _save_cached_contributing(cache, cfg, contrib_nb_name)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #37d16049
 @call_parse
 @delegates(_nbglob_docs)
 def nbdev_docs(
@@ -315,7 +315,7 @@ def nbdev_docs(
     shutil.rmtree(cfg.doc_path, ignore_errors=True)
     move(cache/cfg.doc_path.name, cfg.config_path)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #23886f9c
 @call_parse
 def prepare():
     "Export, test, and clean notebooks, and render README if needed"
@@ -327,7 +327,7 @@ def prepare():
     nbdev_readme.__wrapped__(chk_time=True)
     nbdev_contributing.__wrapped__(chk_time=True)
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #5f701608
 @contextmanager
 def fs_watchdog(func, path, recursive:bool=True):
     "File system watchdog dispatching to `func`"
@@ -343,7 +343,7 @@ def fs_watchdog(func, path, recursive:bool=True):
         observer.stop()
         observer.join()
 
-# %% ../nbs/api/14_quarto.ipynb
+# %% ../nbs/api/14_quarto.ipynb #b6ddeadd
 @call_parse
 @delegates(_nbglob_docs)
 def nbdev_preview(