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-bgand 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-toolsget 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-urlandbook.repo-urland 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-widgetitem. 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-urland the git remote, and when it warns about them. (#86GitHub)
Refactoring
- refactor: Read the project metadata once per page with
get_project_metadatafrom 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-requestandcommitpatterns of a custom platform. The filter only knew the built-in patterns and ignored any other, such asPROJ%-(%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
platformwithout 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@1a2b3c4when 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_2020linked tohttps://github.com/canouil, and[@mcanouil; @canouil_nacho_2020]lost the citation. (#78GitHub) - fix: Reject a custom platforms file whose
userpattern 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 tohttps://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-colorandbadge-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
enabledtreating everything butfalseas true andfetch-titlestreating everything buttrueas 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 onlytrueandfalseas 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.ymland 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
stringmodule 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 sharedschemamodule name. (#57GitHub)
1.10.0 (2026-08-01)
Bug Fixes
- fix: Register the filter at
post-quartoin the extension manifest, so listinggitlinkunderfiltersis enough and the entry point no longer has to be named in project or document YAML. The long formpath/atoverrides the entry point of every filter an extension contributes, so it is best avoided. - fix: Raise
quarto-requiredto>=1.9.38, the first version whose_extension.ymlschema accepts a filter entry point.
1.9
1.9.2 (2026-08-01)
Documentation
- docs: Add a documentation website under
docs/, built on theatelierproject 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.mdto 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
docsfor 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: autoand leavesoverflow-xatvisible, which computes toauto, 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 withvisibilityrather thandisplayit did so even while shut. The menu is now stretched between both edges of the tools row, which spans the column. The navbar andsidebar.contentsplacements are unaffected.
1.9.0 (2026-07-31)
New Features
- feat: Support the repository widget in the sidebar, so book-like sites with
navbar: falsecan use it; the#gitlink-widgetplaceholder goes insidebar.toolsorsidebar.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-widgetplaceholder 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.widgetnavbar widget for HTML websites, replacing a navbar item with href#gitlink-widgetby 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
widgetsections toplatforms.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.linkstoggles,gitlink.widget.extra-linkscustom entries,gitlink.widget.sponsor, andgitlink.widget.iconoptions to customise the dropdown;icontakes 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’stext(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-toolsoption additionally applies the widget’s bordered pill style to both. - feat: Allow widget-only usage with
gitlink.enabled: falseandgitlink.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.enabledoption so drafts and templates can opt out of link rewriting. - feat: Add
gitlink.normalize-linksoption to toggle URL shortening of autolinked platform URLs. - feat: Add
gitlink.fetch-titlesoption to use the page title of an autolinked platform URL as the link text (best-effort viacurl). - feat: Add
gitlink.mentionslist 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-colourandbadge-text-colouragainst hex codes and CSS named colours; invalid values are now warned and ignored instead of producing broken inline styles or invalid Typstrgb()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
falseforshow-platform-badge,enabled, andnormalize-links(the previous metadata accessor treatedfalseas missing).
Refactoring
- refactor: Cache platform-config lookups per render to avoid repeated module calls on every Str element.
- refactor: Add canonical
colour.luashared 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-urlfor website and book projects.
1.3
1.3.0 (2026-03-23)
Refactoring
- refactor: Replace monolithic
utils.luawith 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
1.1
1.1.1 (2026-02-11)
Bug Fixes
- fix: Update copyright year.
1.1.0 (2025-12-04)
New Features
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).