Header and footer links

Configure links with Quarto’s native navigation options. Askr supplies their appearance, not a second link registry. The Header offers quick access; the Footer keeps project, community and maintenance links available after reading.

Native configuration

website:
  navbar:
    tools-collapse: true
    tools:
      - icon: github
        href: https://github.com/your-organization/your-project
        text: GitHub repository
        aria-label: GitHub repository
  page-footer:
    left:
      - icon: github
        aria-label: GitHub repository
        href: https://github.com/your-organization/your-project
      - text: '<i class="bi bi-chat-dots" aria-hidden="true"></i> Community'
        href: https://community.example.org/
    center:
      - text: '<i class="bi bi-book" aria-hidden="true"></i> Maintenance guide'
        href: maintenance.qmd
      - text: '<i class="bi bi-people" aria-hidden="true"></i> Contributing'
        href: contributing.qmd
      - text: '<i class="bi bi-file-earmark-text" aria-hidden="true"></i> License'
        href: license.qmd
      - text: '<i class="bi bi-journal-text" aria-hidden="true"></i> Third-party notices'
        href: THIRD_PARTY.md
    right: "Your project's existing footer content"

Replace the example destinations with your own. GitHub appears twice because these are two native navigation locations; Askr does not synchronize URLs. Use Bootstrap icon names and descriptive text / aria-label values. Icon-only Footer links require aria-label: Quarto attaches that name to their native icon. For unfamiliar community links, a short visible label makes the purpose clearer. Quarto 1.10.18’s Footer text rendering replaces a sibling icon when both are configured, so these examples put decorative Bootstrap icons inside native text markup instead. aria-hidden leaves the visible label as the link name.

With tools-collapse: true, authored tools move into the Areas panel when space is insufficient. Theme, Search and optional Logout stay available in the Header. false keeps tools in the Header; use a small set so they fit your narrowest viewport. Long Footer labels wrap rather than scroll. Links use Quarto’s native href, target and rel behavior; Askr does not force new browser tabs. Existing links and build information remain authored content.

Project license and third-party notices

Use ordinary page-footer items for your project’s license and third-party notices, alongside its existing project and contribution links. Choose labels and destinations that match the documents you publish. Askr does not infer those documents or select a license for a consumer project. The Gallery links to Askr’s own MIT license and asset notices; those are not the license terms for a site that installs Askr.

Make license.qmd a reading page that includes the canonical license file, rather than copying the legal text into a second source:

---
title: "License"
---

The following is this project's canonical license.

{{< include LICENSE >}}

Footer href values in _quarto.yml are relative to that Quarto project. license.qmd and THIRD_PARTY.md link to their rendered license.html and THIRD_PARTY.html; include both sources in the project’s render inputs. Quarto adjusts links for deep pages, so usage/header-footer.html links back to ../license.html and ../THIRD_PARTY.html. Project-relative paths also retain deployment prefixes such as /docs/ and version directories such as /v1.2/, without baking those directories into each link.

An optional raw LICENSE link can offer the original file for download. The host’s content type and response headers determine whether it opens or downloads, so use the rendered page as the reading entry. If you offer that raw-file link, include the file in project resources:

project:
  resources:
    - LICENSE

For separate language projects, each language can have its own reading page while including the same canonical file. For example, zh-TW/license.qmd uses {{< include ../LICENSE >}} and explains that the legal text remains in its original language. Its footer can link to that page and a shared notices page at the parent site root:

website:
  page-footer:
    center:
      - text: 授權條款
        href: license.qmd
      - text: 第三方聲明（英文）
        href: ../THIRD_PARTY.html

The parent project renders THIRD_PARTY.md. Quarto adjusts the relative paths again for deeper translated pages. If each language has its own authored notices, point each project to its own sources instead. Full HTTPS destinations are also valid when the authoritative document is hosted elsewhere. Existing GitHub, contribution and maintenance links and the appended Powered by Askr credit keep their own roles.

Powered by Askr

The Footer’s right section includes Powered by Askr · version. Askr links to its documentation; the version links to its GitHub Release. The installed extension’s _extension.yml is the version authority, not askr-versions.json or your document’s package version. Unreleased local edits still show their current package metadata version; this is not proof that those edits shipped.

To omit this credit:

askr:
  footer:
    credit: false

Askr appends its credit without replacing your right-side content. Without an authored Footer it creates a minimal credit-only Footer; with credit disabled it creates nothing. No commit hash is generated or removed by Askr.

See Quarto’s navigation guide for menus, footer regions and additional native options.