Font Icons

JekyllFaces provides support for several popular font icon sets. The majority of which support loading the icons from a local copy that's stored on your site, or a copy that's served from one of several content delivery networks (CDNs).

Supported font icon sets include:

Font Icon	Allowed Values
boxicons	false / local / cdn
codicons	false / local
devicons	false / local / cdn
drip	false / local / cdn
elegant	false / local
fontawesome	false / local / cdn
foundation	false / local / cdn
glyphicons	false / local
helium	false / local
icomoon	false / local / cdn
ionicons	false / local / cdn
linear	false / local
lineawesome	false / local / cdn
lineicons	false / local / cdn
material	false / local / cdn
octicons	false / local / cdn
themify	false / local / cdn
tonicons	false / local
zondicons	false / local

Usage

In your site configuration, there is an entry for every supported font icon set. You enable the icons (zero, one, or more) by setting the value next to the name to one of false, local, or cdn.

For example, to include the Font Awesome icons from a CDN, you would edit your configuration to resemble the following.

In the _jekyllfaces/config.md file, update the fontawesome entry in the page metadata.

customize:
  fonticons:
    fontawesome: 
      include: cdn
      website: https://fontawesome.com/search?m=free&o=r
    ...

In the _data/site.js file, update the fontawesome entry in the module.exports.

module.exports = {
  customize: {
    fonticons: {
      fontawesome: {
        include: "cdn",
        website: "https://fontawesome.com/search?m=free&o=r",
      },
      ...
    },
  }
};

Last modified: 25 May 2024