Add Askr

0.14.0 is the current release. The public format is askr-html. Quiet Quartz is the visual theme.

quarto add arfiligol/askr@v0.14.0 --no-prompt

project:
  type: website

website:
  title: Project Name
  site-url: https://example.github.io/project/

format:
  askr-html:
    toc: true
    toc-title: Sections
    toc-location: right
    respect-user-color-scheme: true
    smooth-scroll: false

The installed copy lives at _extensions/arfiligol/askr. Askr does not fetch fonts, icons, or styles from a CDN.

To move to a newer tag, install that tag and render the project again. Commit the updated _extensions copy. Reinstall a reviewed tag instead of editing files inside _extensions/arfiligol/askr.

Quarto compatibility

Askr 0.14.0 retains support for stable Quarto releases in >=1.9.38 <1.11. Quarto 1.10.18 remains the reproducible gallery and CI baseline; consumers may use a stable release inside the supported range instead of that exact patch. Older tags retain their original requirements.

Set respect-user-color-scheme: true to follow the reader’s system preference. Set smooth-scroll: false for consumers using the RequireJS compatibility setup. These remain consumer-selected options; Askr’s format defaults are unchanged.

The optional Logout and image viewer retain their existing configuration. See Protected docs and logout and Image viewer for configuration and ownership boundaries.

Optional language selector

Askr 0.10.0 adds an optional Header language selector. It is absent unless askr.languages is configured; all other defaults remain unchanged. Each language project sets its own current code. Askr follows configured links and does not infer a language from the URL or translate pages.

askr:
  languages:
    current: en
    items:
      - code: en
        label: English
        href: https://example.github.io/project/en/
      - code: zh-TW
        label: 繁體中文
        href: https://example.github.io/project/

Each entry needs a unique nonempty code, nonempty label and HTTPS URL or domain-root path. See Language selector for validation, accessibility and menu behavior.

Dense scientific pages

Use site-level askr.reading-width: wide for a 780px body base; normal keeps 630px. Both follow Askr’s responsive scaling and preserve native width escapes.

askr:
  reading-width: wide
  page-facts:
    - {key: node-role, label: Role}
    - {key: reader-task, label: Reader task}

Pages keep flat front matter such as node-role: Concept and reader-task: "Distinguish the modes and their response.". Askr places set values below the description and preserves native author/date metadata. Unset values produce no facts row. See Tables, Mathematics and Figures for table classes, three-level Copy settings and the wide-figure utility.

Actual non-executing renders and browser observations cover stable 1.9.38 and 1.10.18, plus 1.10.16 as a diagnostic prerelease across upstream Sass changes. This is not an observation of every intervening patch or a promise that prereleases are supported. The native grouped-tab runtime, Bootstrap tab implementation and tabset markup used by Askr were unchanged at the inspected boundaries. Exact inputs, findings and limits are recorded in the validation receipt.

Before extending the range, inspect upstream changes to native tabs, theme switching, navigation/search and grid markup, then render and operate the affected Askr components using the proposed version. Quarto 1.11 is excluded from this candidate because it changes navigation and theme-control markup; support requires its own investigation, not a multi-version adapter framework.