Generate Figures Gallery

Create an HTML gallery page displaying all project figures with their captions and source notebooks.

Steps

1. Scan

   images/

   for all image files:
   • Supported formats:

     .png

     ,

     .jpg

     ,

     .jpeg

     ,

     .svg

     ,

     .pdf

   • Record each file's name, path, and modification date

2. Scan all registered notebooks (from

   _quarto.yml

   ) for cells with

   fig-

   labels:
   • Extract the cell label (e.g.,

     fig-sample

     ,

     fig-event-study

     )
   • Extract the caption from

     #| fig-cap:

     or

     *| fig-cap:

     directives
   • Record the source notebook path

3. Generate an HTML gallery page with:

   • A title and generation timestamp
   • For each figure from

     images/

     :
     • Image thumbnail (or placeholder for PDFs)
     • Filename as caption
     • File size and dimensions (if determinable)
   • For each figure from notebooks:
     • The cell label
     • The caption (from cell directive)
     • The source notebook name
     • The embed shortcode:

       {{< embed notebooks/<name>.ipynb#<label> >}}

   • Simple CSS styling for a grid layout

4. Save the gallery to

   _manuscript/figures-gallery.html

   (the

   _manuscript/

   directory is gitignored, so this output won't be committed).

5. Report:

   • File path to the gallery
   • Count of figures from

     images/

   • Count of figure cells from notebooks
   • Command to open:

     open _manuscript/figures-gallery.html

Error handling

• If

  images/

  does not exist or is empty, note it and continue with notebook figures.
• If no notebooks have

  fig-

  labeled cells, note it and continue with

  images/

  files.
• If both sources are empty, report "No figures found in the project."