Icons

J1 Theme supports popular icons font sets out-of-the-box. The icon sets MDI and FA are very good in design and have a rich set of different icons for many categories used for the Web. Iconify icons are not a locally stored icon-set like MDI or FA. All Iconify icons are loaded over the Internet using the so-called Unified OpenSource Icon Framework.

J1 Theme supports popular icons font sets out-of-the-box:

The icon sets MDI and FA are very good in design and have a rich set of different icons for many categories used for the Web. See below for some details for Material Design Icons and FontAwesome Icons.

Iconify icons are not a locally stored icon-set like MDI or FA. All icons are loaded over the Internet using the so-called Unified OpenSource Icon Framework. See section Iconify Icons for more information.

Material Design Icons

The primary icon-set for the J1 Theme is Material Design Icons, because it is a rich set providing more than 5900+ icons for the current version (v5.9.55). MDI has excellent Material Design support from a design perspective and comes with the original icon set created by Google build-in.

Material Design Icons (MDI) is a beneficial design resource for Web Design based on Google's Material Design. MDI is a community-driven project to create an increased number of icons based on Google's official repository and MD style specification.

Table 1. Material Design Icons
Size	Modifier	Markup
1x	no modifier set	All icons can be found for preview at the MDI Icons page online. No modifiers `mdi:account[1x]`
3x	no modifier set	All icons can be found for preview at the MDI Icons page online. No modifiers `mdi:account[3x]`
5x	no modifier set	All icons can be found for preview at the MDI Icons page online. No modifiers `mdi:account[5x]`
5x	`mdi-rotate-45`	All icons can be found for preview at the MDI Icons page online. Rotate 45 degrees `mdi:account[5x mdi-rotate-45]`
5x	`mdi-rotate-315`	All icons can be found for preview at the MDI Icons page online. Rotate 315 degrees `mdi:account[5x mdi-rotate-315]`
5x	`mdi-light` `mdi-flip-v`	All icons can be found for preview at the MDI Icons page online. Color set to (md) light-grey and flipped vertical `mdi:alert[5x mdi-light mdi-flip-v]`
5x	`md-indigo`	All icons can be found for preview at the MDI Icons page online. Color set to (md) indigo `mdi:alert[5x md-indigo]`
5x	`md-pink`	All icons can be found for preview at the MDI Icons page online. Color set to (md) pink `mdi:alert[5x md-pink]`
5x	`mdi-spin`	All icons can be found for preview at the MDI Icons page online. Added animation of type rotate (spin) `mdi:loading[5x mdi-spin]`
5x	`md-red-900` `mdi-pulsed`	All icons can be found for preview at the MDI Icons page online. Color set to (md) color dark-red and added animation of type pulsed `mdi:heart[5x md-red-900 mdi-pulsed]`

Using Material Design Icons with Asciidoc is easy as an inline macro mdi: is available to place icons wherever you want. See more about this in section Asciidoc Extensions.

MDI is a growing collection to allow designers and developers targeting various platforms to download icons in the format, color, and size they need for any project. The repo today contains 6000+ icons (v5.4.55) including converted icons from the official set created by Google.

J1 Theme supports the full set of MDI for the Web (Webfont, WOFF). The icon set is fully integrated and can be used out-of-the-box.

FontAwesome Icons

FontAwesome is a font and icon toolkit based on CSS, initially created by Dave Gandy. The previous version 4 was mainly for the use of Twitter Bootstrap V3. The new version V5, released in December 2017, focuses on all frameworks used for web development. Today, the free FA icon set comes with 1400+ icons included.

Since version 5, the icon set comes in two packages: FontAwesome Free and the proprietary, commercial FontAwesome Pro version but requires a license fee to pay.

The free versions (all releases up to 4 and the free version for 5) are available under SIL Open Font License 1.1, Creative Commons Attribution 4.0, and the MIT License.

FontAwesome V5 meets the Material Design idea (of Google), and in comparison to Version 4, the current version is much more than face-lifting. Version 5 comes with more than 2300+ icons, but many are available only with the Pro license. For the Free version, only a subset of 900+ icons is available.

The CSS styles for FontAwesome V5 have been extended for the J1 Theme to the same classes (and their respective names) for other Font Icon sets. Already existing styles like fa-flip-vertical are available as fa-flip-v as well.

You can check out what icons available at FontAwesome Icons. FontAwesome V5 is fully integrated - no need for additional resources to load. But in comparison to Version 4, a lot of differences need to be noticed.

If you haven’t used V5 yet, it is highly recommended to visit the Get started pages to learn the basics and features and styles.

With version V5 of FontAwesome, the icon set is split into two general parts:

standard icons (symbols) indicated by FAS
brand icons (icons for companies and brands) indicated by FAB

Using FontAwesome with Asciidoc is quite easy to use as two inline macros fab: and fas: are available to place icons where ever you want. See more about this in section Asciidoc Extensions.

Find below examples of both and the use with J1 Theme.

Brand icons

Table 2. FontAwesome Icons (FAB)
Size	Modifier	Markup	Render
2x	no modifier set	All icons can be found for preview at the FA Gallery page online. No modifiers `fab:google[2x]`
5x	`md-blue`	All icons can be found for preview at the FA Gallery page online. Color blue `fab:blogger[5x md-blue]`

Standard icons

Table 3. FontAwesome Icons (FAS)
Size	Modifier	Markup
1x	no modifier set	All icons can be found for preview at the FA Gallery page online. No modifiers `fas:user[1x]`
3x	no modifier set	All icons can be found for preview at the FA Gallery page online. No modifiers `fas:user[3x]`
5x	no modifier set	All icons can be found for preview at the FA Gallery page online. No modifiers `fas:user[5x]`
5x	`fa-rotate-90`	All icons can be found for preview at the FA Gallery page online. Rotate 90 degrees `fas:user[5x fa-rotate-90]`
5x	`md-indigo`	All icons can be found for preview at the FA Gallery page online. Color set to MD Indigo `fas:user[5x md-indigo]`
5x	`md-pink`	All icons can be found for preview at the FA Gallery page online. Color set to MD Pink `fas:user[5x md-pink]`
5x	`mdi-light`	All icons can be found for preview at the FA Gallery page online. Color set to MD Light (Grey) `fas:exclamation-triangle[5x mdi-light]`
5x	`fa-flip-v`	All icons can be found for preview at the FA Gallery page online. Orientation is set to flipped vertical `fas:exclamation-triangle[5x fa-flip-v]`
5x	`md-red-900` `fa-flip-v`	All icons can be found for preview at the FA Gallery page online. Color set to MD dark red and flipped vertical `fas:exclamation-triangle[5x md-red-900 fa-flip-v]`
5x	`fa-spin`	All icons can be found for preview at the FA Gallery page online. Added animation of type spin (rotate) `fas:circle-notch[5x fa-spin]`
5x	`md-red-900` `fa-pulsed`	All icons can be found for preview at the FA Gallery page online. Color set to MD dark red and added animation of type pulsed `fas:heart[5x md-red-900 fa-pulsed]`

Iconify Icons

MDI and FA are rich icon sets but designed for general use. Sometimes icons are missing in one of these fonts, like a specific brand or theme icon. An interesting solution for using font icons from a remote repository is Iconify. Iconify is a so-called unified OpenSource icon framework that makes it possible to use icons from different icon sets using one (unified) syntax.

To access that framework, a Javascript client is needed. For the J1 Theme, the client is build-in and is loaded if Iconify is requested as a resource. To see what icon sets are available with that framework, check the page Iconify Icon Sets.

Using Iconify icons with J1 Theme is quite easy. An Asciidoctor inline macro iconify: (Asciidoctor Extension) is available to place icons where ever you want. See more about this in section Asciidoc Extensions.

Currently, over 40,000 vector icons are available for many different use cases. Find some examples below.

Table 4. Brand Icons
Size	Modifier	Markup
3x	no modifier set	All icons can be found for preview at SVG Logos page online. No modifiers `iconify:logos:opensource[3x]`
3x	no modifier set	All icons can be found for preview at SVG Logos page online. No modifiers `iconify:logos:asciidoctor[3x]`
3x	no modifier set	All icons can be found for preview at SVG Logos page online. No modifiers `iconify:logos:jupyter[3x]`

Table 5. Medical Icons
Size	Modifier	Markup	Render
3x	no modifier set	All icons can be found for preview at Medical Icons page online. No modifiers `iconify:medical-icon:i-ear-nose-throat[3x]`
5x	`md-red-900`	All icons can be found for preview at Medical Icons page online. Color (md) red `iconify:medical-icon:i-ear-nose-throat[5x md-red-900]`

What next

Have you’ve enjoyed the possibilities J1 offers for managing and manipulating font icons. Do you think these icon sets can fit your needs? Using Iconify, for all topics, you will find a suitable icon. And it’s simple.

J1 Theme implements some handy Ruby-based enhancements for Asciidoctor. Providing extensions for a Jekyll theme is a unique feature of JekyllOne (J1) compared to other Jekyll themes and templates. Most extensions are based on well-documented examples from the Asciidoctor Extensions Lab.

To make the use of modules for the template easier, some more extensions support you to place for example lightboxes, sliders, galleries or fonts icons using Asciidoc block elements. I’m sure, you’ll love it.

To check the more the J1 Theme offers, go for the Asciidoc Extensions made for J1!