Font Awesome Plugin v2.0.0

• Breaking: adds viewBox attribute to output svg for proper aspect ratio and sizing.
• Recommended CSS: svg { height: 1em; } svg, symbol { overflow: visible; }
• Icon class names now recognize all Font Awesome 7 families and styles, including Chisel, Etch, Jelly, Slab, Notdog, Thumbprint, Utility, Whiteboard and Semibold (37 prefixes, up from 17).
• Upgraded to Font Awesome v7.3.1, entities v8 and nanoid v6.

Full Changelog: v1.0.1...v2.0.0

Eleventy Font Awesome Plugin v1.0.1

• Upgrade to Font Awesome v7.1.0 (from v7.0.1)
• Uses npm Trusted Publishers (OIDC) release workflow

Full Changelog: v1.0.0...v1.0.1

Eleventy Font Awesome Plugin v1.0.0

The Font Awesome Eleventy Plugin finally graduates to its first stable release! This plugin unlocks unlocks use of all 2089 free icons in Font Awesome v7.0.1. You can add your pro sets to use here too!

Step 1: Install with npm install @11ty/font-awesome.

Step 2: Add to your configuration file:

import fontAwesomePlugin from "@11ty/font-awesome";

export default function(eleventyConfig) {
	eleventyConfig.addPlugin(fontAwesomePlugin);
};

Step 3: Use the HTML icon markup (in any Eleventy template syntax) copied directly from the Font Awesome docs!

<i class="fa-brands fa-eleventy"></i>

Step 4: Unclench your jaw, take two deep breaths, cope, make space for yourself (your icons are working now)

• Head back over to the full plugin documentation.
• Review the GitHub Milestone for v1.0.0

Eleventy Font Awesome Plugin v1.0.0-beta.12

• Adds support for shortcode alt attribute option to set accessible fallback text for an icon. {% icon "icon-name", { alt: "Accessible Text" } %}

Full Changelog: v1.0.0-beta.11...v1.0.0-beta.12

Eleventy Font Awesome Plugin v1.0.0-beta.11

• Adds options.useXlinkHref option (default true) to opt-out of xlink:href attributes on generated SVG. Read more: https://docs.fontawesome.com/web/add-icons/svg-symbols#what-about-xlinkhref-what-happened-to-that

Full Changelog: v1.0.0-beta.10...v1.0.0-beta.11

Eleventy Font Awesome v1.0.0-beta.9

• Fixes bug with aliased icon names, e.g. <i class="fas fa-tshirt"></i> should map to fa-solid fa-shirt

v1 Milestone: https://github.com/11ty/eleventy-plugin-font-awesome/milestone/1?closed=1
Full Changelog: v1.0.0-beta.8...v1.0.0-beta.9

Eleventy Font Awesome v1.0.0-beta.8

• Fixes for Pro icon class names
• Adds fa- sizing classes as preserved class names in output.
• Adds ignoredClasses: [] plugin option to skip elements with any matching classname. (e.g. ignoredClasses: ["fak"] to use client JavaScript bundle for kit icons)
• Fixes bug with missing Pro icons not throwing errors (even with failOnError: true)

v1 Milestone: https://github.com/11ty/eleventy-plugin-font-awesome/milestone/1?closed=1
Full Changelog: v1.0.0-beta.7...v1.0.0-beta.8

Eleventy Font Awesome v1.0.0-beta.10

• Adds support for accessible text for SVG sprite icons, a la https://docs.fontawesome.com/web/dig-deeper/accessibility#making-icons-accessible-manually, usage example: <i class="fas fa-tshirt">shirt</i>

v1 Milestone: https://github.com/11ty/eleventy-plugin-font-awesome/milestone/1?closed=1
Full Changelog: v1.0.0-beta.9...v1.0.0-beta.10

Eleventy Font Awesome v1.0.0-beta.7

• Fixes bug with importing other Font Awesome icon sets via sets plugin option #1
• Adds support for <i class="fa-fw"> for fixed width icons.
• Improves error messaging when an icon can’t be found.

v1 Milestone: https://github.com/11ty/eleventy-plugin-font-awesome/milestone/1?closed=1
Full Changelog: v1.0.0-beta.6...v1.0.0-beta.7

Eleventy Font Awesome v1.0.0-beta.6

• Adds defaultAttributes: {} option (used in both shortcode and transform)
• Removes prerelease shortcodeClass option.

Full Changelog: v1.0.0-beta.5...v1.0.0-beta.6