Skip to main content

Changelog

What changed, and when.

Every released version of the gitlink extension, and what each one changed.

1

1.14

1.14.0 (2026-11-15)

New Features
  • feat: Themes can set the widget count badge background with --gitlink-widget-count-bg and the shadow of the drop-down menu with --gitlink-widget-menu-shadow. Without them, the badge takes a light tint of the menu text colour, which no longer changes on hover. (#94GitHub)
Bug Fixes
  • fix: The widget menu in the navbar now uses the theme’s own colours, like the sidebar menu. The widget trigger and the buttons styled by widget.style-navbar-tools get a visible border, and their hover uses Quarto’s navbar hover colour, so they stay readable on a coloured navbar. (#93GitHub)

1.13

1.13.0 (2026-11-12)

New Features
  • feat: The widget menu shows the star and fork counts next to “Add a Star” and “Create a Fork”. The numbers come from the same request as the button, so nothing extra is fetched. (#91GitHub)
Bug Fixes
  • fix: The HTML dependency folder now uses the extension version, so browsers load the new files after an upgrade. (#90GitHub)

1.12

1.12.0 (2026-10-29)

New Features
  • feat: Warn when Quarto’s project metadata file can’t be read, and name the file and what that changes. Gitlink then ignores website.repo-url and book.repo-url and skips the widget placeholder check, which it used to do without a word. (#85GitHub)
Bug Fixes
  • fix: Warn that no repository could be resolved only when the website or book navigation has a #gitlink-widget item. With the widget on and no such item, every page logged the warning, though the widget would show nowhere. (#83GitHub)
Documentation
  • docs: Explain how the filter finds the platform and the repository from the project repo-url and the git remote, and when it warns about them. (#86GitHub)
Refactoring
  • refactor: Read the project metadata once per page with get_project_metadata from the vendored Lua modules, now at 2.8.0. The widget used to read and decode the same file a second time. (#84GitHub)
  • build: Update the vendored schema validator to schema-v2.3.0. It adds a check for code cell options, which gitlink does not use yet. (#87GitHub)

1.11

1.11.3 (2026-10-28)

Bug Fixes
  • fix: Use the issue, merge-request and commit patterns of a custom platform. The filter only knew the built-in patterns and ignored any other, such as PROJ%-(%d+). A pattern must now have one or two capture groups, and a file with a pattern that does not is rejected. (#80GitHub)
  • fix: Accept the name of a custom platform in platform without a schema error. The platform worked, but every render logged “platform: must be one of”. (#79GitHub)
  • fix: Link a fork commit such as jane-doe@1a2b3c4 when the user name has a hyphen. The user name now follows the same rule as a mention. (#79GitHub)
  • fix: Link a user mention only when the whole id is a valid username on the platform. @canouil_nacho_2020 linked to https://github.com/canouil, and [@mcanouil; @canouil_nacho_2020] lost the citation. (#78GitHub)
  • fix: Reject a custom platforms file whose user pattern is a list, does not start with @, or does not have exactly one capture group. Such a pattern could crash the filter or link the wrong username. Gitlink now reports the error and uses the built-in platforms only, so a document that asks for a platform from that file gets no links. (#78GitHub)
  • fix: Keep a citation whose id is in the bibliography as a citation, unless the id is listed in mentions. Every citation was turned into a user mention link, such as [@canouil_nacho_2020] linking to https://github.com/canouil. (#74GitHub)
  • fix: Render Typst documents that have a bibliography. The filter stopped with “File ’’ not found in resource path” because Quarto passes the bibliography paths to Typst as raw text. (#74GitHub)
  • fix: Read a Typst bibliography path that starts with / from the project root, as Typst does. The filter stopped with “does not exist” because it looked for the file at the root of the file system. (#74GitHub)

1.11.2 (2026-10-05)

Bug Fixes
  • fix: Draw the platform badge in the configured colours at full opacity, with black or white text by default, whichever contrasts more. In HTML, Bootstrap’s secondary colour overrode both options and a 70% fade pushed the text below WCAG AA. (#70GitHub)
  • fix: Ignore a badge colour written as a hex code of 5 or 7 digits, with a warning. Only 3, 4, 6, and 8 digits are valid hex colours. (#70GitHub)
  • fix: Read badge-background-color and badge-text-color, the US spellings of the badge colour options. Both were ignored before. (#70GitHub)
  • fix: Fall back to the default badge colour when a colour option is not a string, such as true, instead of stopping the render. (#70GitHub)
  • fix: Take the alpha of a translucent badge background into account when picking the text colour, and warn when neither black nor white text is readable on the pages the badge can sit on. (#70GitHub)

1.11.1 (2026-09-23)

New Features
  • feat: Report a key nested inside an option that the schema does not declare, such as a typo in a nested setting. Only top-level keys were checked before. (#67GitHub)
Bug Fixes
  • fix: Read the boolean options through the schema, so a value that is not a boolean is reported rather than guessed at. Each was read from the document text and accepted one spelling, with enabled treating everything but false as true and fetch-titles treating everything but true as false. (#67GitHub)
  • fix: Report that nested key as a warning rather than an error, so the typo does not invalidate the whole configuration. (#67GitHub)
Documentation
  • docs: Serve the extension’s social card as the Open Graph image, so a shared link shows the card rather than the first image on the page. (#65GitHub)
Refactoring
  • build: Update the vendored Lua modules to 2.3.0. A module no longer carries a version line in its header, so its checksum changes only when its code changes. (#66GitHub)
  • build: Update the vendored Lua modules to 2.5.0, which adds the accessor that reads what the schema resolves an option to. The schema validator moves to its own release train and is pinned at schema-v2.2.0, which accepts only true and false as a boolean. (#67GitHub)

1.11.0 (2026-09-06)

New Features
  • feat: Check the document configuration against the extension schema and report what it does not accept. (#61GitHub)
Refactoring
  • build: Declare the vendored Lua modules in _extensions/gitlink/_dependencies.yml and move them to _extensions/gitlink/_vendor/. Each module names the release it came from, so it can be checked against that release. (#60GitHub)

1.10

1.10.1 (2026-08-28)

Bug Fixes
  • fix: Load the string module by its own path in the Bitbucket module, so another extension’s module cannot be used instead. (#57GitHub)
  • fix: Keep a platform URL in a navigation link target, and a reference in the social metadata, as plain text. A reference in a navigation title or entry text stays plain text as well. (#58GitHub)
Refactoring
  • refactor: Rename the platform validation module to platform-schema, freeing the shared schema module name. (#57GitHub)

1.10.0 (2026-08-01)

Bug Fixes
  • fix: Register the filter at post-quarto in the extension manifest, so listing gitlink under filters is enough and the entry point no longer has to be named in project or document YAML. The long form path/at overrides the entry point of every filter an extension contributes, so it is best avoided.
  • fix: Raise quarto-required to >=1.9.38, the first version whose _extension.yml schema accepts a filter entry point.

1.9

1.9.2 (2026-08-01)

Documentation
  • docs: Add a documentation website under docs/, built on the atelier project type and published to https://m.canouil.dev/quarto-gitlink/, with in-text rewriting enabled so the pages show the filter working.
  • docs: Trim README.md to a landing page pointing at the website.
  • docs: Add the Pages workflow, which renders docs/ on pull requests and deploys it from the release tag.
  • docs: Add the Quarto Extensions Updates workflow, scanning docs for the website’s own dependencies.

1.9.1 (2026-08-01)

Bug Fixes
  • fix: Keep a sidebar tools widget’s menu inside the sidebar, so a docked sidebar carrying the widget no longer has a permanent horizontal scrollbar. Quarto’s sidebar sets overflow-y: auto and leaves overflow-x at visible, which computes to auto, so a menu wider than the column scrolled it sideways instead of being clipped; the menu was anchored to the centred trigger and sized to its content, so it ran past the right edge, and because it is hidden with visibility rather than display it did so even while shut. The menu is now stretched between both edges of the tools row, which spans the column. The navbar and sidebar.contents placements are unaffected.

1.9.0 (2026-07-31)

New Features
  • feat: Support the repository widget in the sidebar, so book-like sites with navbar: false can use it; the #gitlink-widget placeholder goes in sidebar.tools or sidebar.contents, and both may be used on the same site.
  • feat: Fit the widget to Quarto’s sidebar navigation: a tools widget takes its own centred line below the colour-scheme and reader toggles and above search, with an overlay menu, while a contents widget spans the sidebar width and expands its menu inline so the sidebar scroll area never clips it.
  • feat: Replace every #gitlink-widget placeholder on a page instead of only the first; each widget gets unique element ids, and they share a single stats request.

1.8

1.8.0 (2026-07-24)

New Features
  • feat: Add gitlink.widget navbar widget for HTML websites, replacing a navbar item with href #gitlink-widget by a button showing live star/fork counts (fetched from the platform API, cached for four hours) and a dropdown of repository links.
  • feat: Add per-platform widget sections to platforms.yml (menu paths, labels, stats API endpoint and fields) for GitHub, GitLab, Codeberg, Gitea, and Bitbucket; Bitbucket renders without counters as its API exposes no star count.
  • feat: Add gitlink.widget.links toggles, gitlink.widget.extra-links custom entries, gitlink.widget.sponsor, and gitlink.widget.icon options to customise the dropdown; icon takes Quarto’s bundled Bootstrap icon names (as in navbar tools) or one of about sixty embedded octicons (16px bodies from primer/octicons), and shortcode output in an entry’s text (e.g. iconify) is preserved when the filter runs at post-quarto.
  • feat: Size Quarto’s navbar search button and colour-scheme toggle to match the widget, with consistent spacing across the navbar-right control group; the optional gitlink.widget.style-navbar-tools option additionally applies the widget’s bordered pill style to both.
  • feat: Allow widget-only usage with gitlink.enabled: false and gitlink.widget.enabled: true.

1.7

1.7.0 (2026-07-21)

Bug Fixes
  • fix: Recognise groups of references separated by commas, both spaced ((#2, #3), (#1, #2, #3)) and without spaces ((#2,#3), #2,#3); a comma-separated group is linked only when every item is a valid reference.
  • fix: Shorten autolinked platform URLs (e.g. <https://github.com/owner/repo/issues/1>) to a single clean reference link instead of a malformed nested link; non-platform autolinks keep their original link.

1.6

1.6.0 (2026-05-31)

New Features
  • feat: Add gitlink.enabled option so drafts and templates can opt out of link rewriting.
  • feat: Add gitlink.normalize-links option to toggle URL shortening of autolinked platform URLs.
  • feat: Add gitlink.fetch-titles option to use the page title of an autolinked platform URL as the link text (best-effort via curl).
  • feat: Add gitlink.mentions list to force-treat specific citation IDs as Git hosting mentions even when a bibliography reference with the same id exists.
Bug Fixes
  • fix: Validate badge-background-colour and badge-text-colour against hex codes and CSS named colours; invalid values are now warned and ignored instead of producing broken inline styles or invalid Typst rgb() calls.
  • fix: Reject cross-repository commit references (owner/repo@<sha>) whose SHA is shorter than 7 or longer than 40 hexadecimal characters; previously over-length SHAs produced an incorrect link.
  • fix: Reset module-level state at the start of each document so batch renders no longer leak platform, repository, badge, or reference-set state across documents.
  • fix: Respect boolean false for show-platform-badge, enabled, and normalize-links (the previous metadata accessor treated false as missing).
Refactoring
  • refactor: Cache platform-config lookups per render to avoid repeated module calls on every Str element.
  • refactor: Add canonical colour.lua shared module for hex/named colour validation.

1.5

1.5.2 (2026-04-17)

Bug Fixes
  • fix: Recognise references inside bracket pairs surrounded by additional text or punctuation, e.g. something(#1), (#1)., .(#1)., (mcanouil/quarto-gitlink#1)something.

1.5.1 (2026-04-15)

Refactoring
  • refactor: Synchronise shared modules (logging.lua, git.lua, string.lua) with canonical versions.

1.5.0 (2026-04-15)

New Features
  • feat: Support references surrounded by parentheses, brackets, quotes, and trailing punctuation.

1.4

1.4.0 (2026-04-09)

New Features
  • feat: Auto-detect repository from Quarto project repo-url for website and book projects.

1.3

1.3.0 (2026-03-23)

Refactoring
  • refactor: Replace monolithic utils.lua with focused modules (string.lua, logging.lua, metadata.lua, pandoc-helpers.lua, html.lua, paths.lua, colour.lua).

1.2

1.2.0 (2026-02-21)

New Features
  • feat: Add extension-provided code snippets (#22GitHub).
  • feat: Add _schema.yml for configuration validation and IDE support (#18GitHub).

1.1

1.1.1 (2026-02-11)

Bug Fixes
  • fix: Update copyright year.

1.1.0 (2025-12-04)

New Features
  • feat: Add support for custom Git hosting platforms and schema validation (#15GitHub).
  • feat: Shorten URLs (#14GitHub).
Documentation
  • docs: Drop old filter syntax.
  • docs: Remove outdated comments and use panel tabset.
  • docs: Tip about not using bare URLs.

1.0

1.0.0 (2025-11-30)

Bug Fixes
  • fix: Update and fix Bitbucket support and update documentation (#10GitHub).
  • fix: Gitea pattern.
  • fix: Missing import prefix.
Refactoring
  • refactor: Use module structure and enhance dependency management (#9GitHub).

0

0.1

0.1.0 (2025-08-23)

New Features
  • feat: Initial implementation of githost extension for Quarto (#1GitHub).
Bug Fixes
  • fix: Change output-file.
Refactoring
  • refactor: Rename extension directory.
  • refactor: Rename extension to gitlink (#7GitHub).
Back to top