fgczQuartoTemplate (development version)

  • A “</> Show code” badge now appears directly on any figure or table chunk labelled Quarto’s own way (#| label: fig-xxx / #| label: tbl-xxx with a matching fig-cap:/tbl-cap:) — both in its top-right corner in the report body and on its card in the Find panel — click either to open View Source already scrolled to and highlighting that exact chunk. Fully automatic and client-side, resolved from what Quarto already renders (the crossref id + the embedded source); unlabelled chunks show nothing extra, in either place. Requires code-tools: true, same as the View source button.
  • The toolbar gains a third button, </> View source, alongside 🔍 Find and 📥 Download: opens Quarto’s own view-source overlay in place, driving its native machinery (#quarto-view-source / the embedded-source modal / the native code-tools button) rather than reimplementing it. Select it with fgcz_render(buttons = "source") or fgcz-buttons: source; TRUE / omitting fgcz-buttons now enables all three.
  • New fgcz_render(fig_dpi =, fig_retina =), both NULL (unset) by default: override the shared _metadata.yml figure resolution for a single render without editing the .qmd. Useful for figure-heavy reports (many samples, many plots) where the default self-contained HTML balloons in size — e.g. fgcz_render(qmd, fig_dpi = 150, fig_retina = 1).
  • Package metadata now describes the configurable tabs, searchable report content, and downloadable report bundle.
  • Two optional tab features, both off by default and independent of each other: fgcz-colour: true applies a per-nesting-level palette (deep blue → indigo) instead of the uniform folder tabs, and fgcz-number: true prefixes every tab label with its hierarchical number (1, 1.1, 1.1.1 …), counting across sibling tabsets at the same depth. Set them as top-level YAML keys with the Quarto extension, or as fgcz_render(colour = TRUE, number = TRUE) from R. Both restore behaviour from the older fgczReportTemplates package. Reports that ignore them are unchanged.
  • New optional fgcz-full-width: true (or fgcz_render(full_width = TRUE)), off by default: collapses the centred body cap so report content fills the screen on large displays, like the older ezRun html_document. Trade-off: .column-margin margin notes and .column-screen full-bleed blocks are unsupported while it is on. Reports that ignore it are unchanged.
  • The 📥 Download ZIP now bundles two whole-report extras alongside the checked plots — the .qmd source and a standalone .html copy — and the ZIP is buildable whenever any plot or any extra is ticked.

fgczQuartoTemplate 0.2.0

  • Reports can select "search" and/or "download" toolbar controls through fgcz_render(buttons = ...) or a top-level fgcz-buttons: Quarto YAML key. Existing TRUE/FALSE R calls remain compatible, and unknown names now fail clearly instead of silently hiding controls. The toolbar uses a dynamic horizontal top-right position with compact icons whose text labels expand on hover or keyboard focus (#2).
  • The documentation site now publishes the fgcz-quarto-reports authoring skill as a readable guide and links it from the package usage vignette.
  • The starter and example report now demonstrate the required compact Overview with a visual abstract, introduction, and high-level input summary, followed by a final Session Info tab containing separate Report provenance and R session info subtabs. fgcz_use_template() also copies the visual abstract beside the new report.
  • Downloaded ZIP files now include a current timestamp, encode Order/Workunit identifiers when report metadata is available, and write current ZIP entry timestamps instead of the 1980 default.
  • The documentation website is now built with altdoc (Quarto Website backend) instead of pkgdown. pkgdown mangles Quarto panel-tabsets (its tweak_tabsets step crashes on them), whereas altdoc renders vignettes natively through Quarto with the tabsets intact.
  • The FGCZ layout demo now ships as a rendered vignette (vignettes/example-report.qmd), built with format: fgczQuartoTemplate-html from the vendored vignettes/_extensions/, and is shown on the documentation site with its nested tabsets preserved. Its title is now a static string so the documentation-site sidebar shows “FGCZ tabset layout example” instead of the raw `r params$reportTitle` code (the Quarto website navigation harvests the literal YAML title without executing inline code; a param-driven title still works for standalone reports rendered from inst/quarto/template.qmd).
  • The fgcz-quarto-reports skill’s caption guidance now includes a concrete before/after example: a negative (decorative, unsearchable) figure caption contrasted with a positive one that names the statistics, panels, axes, and diagnostic reading.
  • The fgcz-quarto-reports skill now recommends recording B-Fabric / SUSHI report provenance once — a field/value table in a final Session Info tab (plus sessionInfo() and the #fgcz-report-metadata marker) — rather than duplicating the metadata in a top-of-page report-information callout.

fgczQuartoTemplate 0.1.0

  • The opt-in toolbar’s 🔍 Find panel now opens tabs through Bootstrap’s tab API so htmlwidgets such as DT tables redraw when revealed from inactive tabs.
  • The opt-in toolbar’s 🔍 Find panel now renders Plotly htmlwidgets as thumbnail cards by rasterizing the embedded widget JSON in the browser.
  • The opt-in toolbar’s 🔍 Find panel now uses Quarto figure captions for Plotly htmlwidgets inside figure floats instead of adding duplicate captionless Plotly cards.
  • The opt-in toolbar’s 📥 Save panel now excludes Plotly htmlwidgets inside figure floats from the static-download list.
  • The opt-in toolbar’s 🔍 Find panel now renders DT tables as table preview cards instead of generic figure placeholders.
  • The opt-in toolbar’s 🔍 Find button opens a graphical table of contents showing figures and tables, including content in inactive tabs; click one to jump to it. Results are grouped by their report location, and section/subsection/tab titles are included in filtering. Figure thumbnails reuse the report’s embedded images, so they work offline. The 📥 Save panel also shows thumbnails for downloadable plots.
  • The search + download toolbar is now opt-in. fgcz_render() gains a buttons argument (default FALSE); pass buttons = TRUE to add the right-edge 🔍 Find / 📥 Save toolbar. It is no longer wired into _metadata.yml or the Quarto extension by default; the extension and plain quarto render routes opt in with an include-after-body: line.
  • fgcz_copy_assets() accepts either an existing directory or a .qmd file path.