← GDG /

#310 gdtest_custom_css

#310 gdtest_custom_css OK CONFIG
Project-level custom CSS forwarded into _quarto.yml
A package whose great-docs.yml sets a single project-level `site.css: [docs/custom.css]` key. Great Docs should copy the stylesheet into the build directory and write it into _quarto.yml's format.html.css. If the wiring is missing, the marker rule in custom.css never reaches the rendered site.
View Site → Build Log ๐Ÿงช Test Coverage

Build Mode

● Has great-docs.yml

This package ships a pre-supplied config. The great-docs init step is skipped and great-docs build uses the spec-defined configuration directly. Tests specific config options and their rendered output.

Dimensions

A1 B1 C1 D1 E6 F1 G1 Q8
A1Flat layoutlayout
B1Explicit __all__exports
C1Functions onlyobjects
D1NumPydocstrings
E6No directivesdirectives
F1Auto-discoveruser_guide
G1README.mdlanding
Q8site.css: custom stylesheettheme

Source Files

๐Ÿ“ docs/
๐Ÿ“„ custom.css
/* gdtest-custom-css marker rule: unique and easily greppable so
   tests can confirm this exact file was linked, not just any
   stylesheet. */
.gdtest-custom-css-marker {
  --gdtest-custom-css: applied;
}
๐Ÿ“ gdtest_custom_css/
๐Ÿ“„ __init__.py
"""Package demonstrating project-level custom CSS."""

__version__ = "0.1.0"
__all__ = ["widget"]


def widget(name: str) -> str:
    """
    Build a text widget.

    Parameters
    ----------
    name
        Label for the widget.

    Returns
    -------
    str
        The rendered widget.
    """
    return f"[{name}]"
๐Ÿ“ user_guide/
๐Ÿ“„ 01-page.qmd
---
title: Page
---

A user-guide page, to confirm project-level CSS applies outside the
homepage too.
๐Ÿ“„ great-docs.yml
site:
  css:
    - docs/custom.css