{"id":13477402,"url":"https://github.com/mcanouil/quarto-iconify","last_synced_at":"2025-04-06T02:07:51.120Z","repository":{"id":56734714,"uuid":"524357559","full_name":"mcanouil/quarto-iconify","owner":"mcanouil","description":"Use Iconify icons in HTML-based Quarto documents (over 200,000 open source vector icons).","archived":false,"fork":false,"pushed_at":"2025-03-22T10:35:41.000Z","size":86,"stargazers_count":131,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T01:05:54.082Z","etag":null,"topics":["iconify","icons","quarto","quarto-extension","quarto-pub","quarto-shortcode","quartopub"],"latest_commit_sha":null,"homepage":"https://m.canouil.dev/quarto-iconify/","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mcanouil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"mcanouil","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-08-13T09:42:43.000Z","updated_at":"2025-03-22T10:34:12.000Z","dependencies_parsed_at":"2024-01-05T23:46:22.861Z","dependency_job_id":"0fdbefc6-1185-4e05-8658-fcc12421bf97","html_url":"https://github.com/mcanouil/quarto-iconify","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcanouil%2Fquarto-iconify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcanouil%2Fquarto-iconify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcanouil%2Fquarto-iconify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcanouil%2Fquarto-iconify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mcanouil","download_url":"https://codeload.github.com/mcanouil/quarto-iconify/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247423513,"owners_count":20936626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["iconify","icons","quarto","quarto-extension","quarto-pub","quarto-shortcode","quartopub"],"created_at":"2024-07-31T16:01:42.282Z","updated_at":"2025-04-06T02:07:51.097Z","avatar_url":"https://github.com/mcanouil.png","language":"Lua","readme":"# Iconify Extension for Quarto\n\nThis extension provides support to free and open source icons provided by [Iconify](https://icon-sets.iconify.design/).  \nIcons can be used only in HTML-based documents.\n\n## Installing\n\n```sh\nquarto add mcanouil/quarto-iconify\n```\n\nThis will install the extension under the `_extensions` subdirectory.  \nIf you're using version control, you will want to check in this directory.\n\n## Using\n\nTo embed an icon, use the `{{\u003c iconify \u003e}}` shortcode[^1]. For example:\n\n```default\n{{\u003c iconify exploding-head \u003e}}\n{{\u003c iconify fluent-emoji exploding-head \u003e}}\n{{\u003c iconify fluent-emoji:exploding-head \u003e}}\n{{\u003c iconify exploding-head size=2xl \u003e}}\n{{\u003c iconify exploding-head size=5x rotate=180deg \u003e}}\n{{\u003c iconify exploding-head size=Huge \u003e}}\n{{\u003c iconify fluent-emoji-high-contrast 1st-place-medal \u003e}}\n{{\u003c iconify twemoji 1st-place-medal \u003e}}\n{{\u003c iconify line-md loading-alt-loop \u003e}}\n{{\u003c iconify fa6-brands apple width=50px height=10px rotate=90deg flip=vertical \u003e}}\n{{\u003c iconify simple-icons:quarto \u003e}}\n```\n\nThis extension includes support for thousands of icons (including animated icons).\nYou can browse all of the available sets of icons here:\n\n\u003chttps://icon-sets.iconify.design/\u003e\n\n[^1]: The default icon set is `fluent-emoji` (source: \u003chttps://github.com/microsoft/fluentui-emoji\u003e).\n\n### Iconify Attributes\n\nIconify API provides additional attributes: \u003chttps://docs.iconify.design/iconify-icon/\u003e.  \nCurrently, this extension supports: `size`, `width`, `height`, `flip`, `rotate`, `title`[^2], `label`[^2] (_i.e._, `aria-label`), and `inline`[^3].\n\n``` markdown\n{{\u003c iconify \u003cset\u003e \u003cicon\u003e \u003csize=...\u003e \u003cwidth=...\u003e \u003cheight=...\u003e \u003cflip=...\u003e \u003crotate=...\u003e \u003ctitle=...\u003e \u003clabel=...\u003e \u003cinline=...\u003e \u003e}}\n{{\u003c iconify \u003cset:icon\u003e \u003csize=...\u003e \u003cwidth=...\u003e \u003cheight=...\u003e \u003cflip=...\u003e \u003crotate=...\u003e \u003ctitle=...\u003e \u003clabel=...\u003e \u003cinline=...\u003e \u003e}}\n```\n\n[^2]: `title` and `label` takes the following default value: `Icon \u003cicon\u003e from \u003cset\u003e Iconify.design set.`.\n[^3]: `inline` is a boolean attribute that can be set to `true` or `false`. Default is `true`.\n\n### Sizing Icons\n\nThis extension provides relative, literal, and LaTeX-style sizing for icons.  \nWhen the size is invalid, no size changes are made.\n\n- CSS-style sizing: `{{\u003c iconify exploding-head size=42px \u003e}}`.\n\n- Relative sizing: `{{\u003c iconify exploding-head size=2xl \u003e}}`.\n\n  | Relative Sizing | Font Size | Equivalent in Pixels |\n  |-----------------|-----------|----------------------|\n  | 2xs             | 0.625em   | 10px                 |\n  | xs              | 0.75em    | 12px                 |\n  | sm              | 0.875em   | 14px                 |\n  | lg              | 1.25em    | 20px                 |\n  | xl              | 1.5em     | 24px                 |\n  | 2xl             | 2em       | 32px                 |\n\n- Literal sizing: `{{\u003c iconify exploding-head size=5x \u003e}}`.\n\n  | Literal Sizing | Font Size |\n  |----------------|-----------|\n  | 1x             | 1em       |\n  | 2x             | 2em       |\n  | 3x             | 3em       |\n  | 4x             | 4em       |\n  | 5x             | 5em       |\n  | 6x             | 6em       |\n  | 7x             | 7em       |\n  | 8x             | 8em       |\n  | 9x             | 9em       |\n  | 10x            | 10em      |\n\n- LaTeX-style sizing: `{{\u003c iconify exploding-head size=Huge \u003e}}`.\n\n  | Sizing Command                   | Font Size (HTML) |\n  | -------------------------------- | ---------------- |\n  | tiny (= `\\tiny`)                 | 0.5em            |\n  | scriptsize (= `\\scriptsize`)     | 0.7em            |\n  | footnotesize (= `\\footnotesize`) | 0.8em            |\n  | small (= `\\small`)               | 0.9em            |\n  | normalsize (= `\\normalsize`)     | 1em              |\n  | large (= `\\large`)               | 1.25em           |\n  | Large (= `\\Large`)               | 1.5em            |\n  | LARGE (= `\\LARGE`)               | 1.75em           |\n  | huge (= `\\huge`)                 | 2em              |\n  | Huge (= `\\Huge`)                 | 2.5em            |\n\n- `width` or `height` can be set to define icon's property while keeping aspect ratio.  \n  _Note:_ `width` and `height` are not set if `size` was defined.\n\n## Example\n\nHere is the source code for a minimal example: [example.qmd](example.qmd).\n\nThis is the output of `example.qmd` for [HTML](https://m.canouil.dev/quarto-iconify/).\n\n---\n\n[Iconify](https://github.com/iconify/iconify) by Vjacheslav Trushkin under MIT License.\n","funding_links":["https://github.com/sponsors/mcanouil"],"categories":["Lua","Extensions"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcanouil%2Fquarto-iconify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcanouil%2Fquarto-iconify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcanouil%2Fquarto-iconify/lists"}