WiredViews.Xperience.FontAwesomeIntegrator 1.0.0

Prefix Reserved
dotnet tool install --global WiredViews.Xperience.FontAwesomeIntegrator --version 1.0.0                
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local WiredViews.Xperience.FontAwesomeIntegrator --version 1.0.0                
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=WiredViews.Xperience.FontAwesomeIntegrator&version=1.0.0                
nuke :add-package WiredViews.Xperience.FontAwesomeIntegrator --version 1.0.0                

Xperience Font Awesome Integrator

This project is a .NET global tool that helps integrate Font Awesome 5 into the Kentico Xperience content management application.

It requires the .NET Core SDK to run at the command line (which should already be installed with Visual Studio).

View the NuGet Package

Adding Icons to Xperience

Kentico Xperience already provides a set of icons for developers and content editors to use in the content management application.

Icons can also be added to the default set, but this requires some customization if you are trying to integrate the Font Awesome 5 icons.

This global tool will handle all the file/folder processing for you. It works with the Free and Pro versions of Font Awesome 5.

Examples

First install the global tool:

dotnet tool install --global WiredViews.Xperience.FontAwesomeIntegrator

Extract the .zip file downloaded from Font Awesome's site.

Execute the tool to process and copy files to your CMS application

fpath is the path to the extracted Font Awesome content folder (containing /css, /webfonts, and /metadata folders). cpath is the path to your Xperience CMS application folder

> xperience-fa-integrator -fpath C:\dev\fontawesome-free-5.14.0-web -cpath C:\dev\Xperience\CMS

This tool does not include the copied files into your project. You will need to either edit the CMSApp.csproj project file and add the entries or use the Visual Studio Solution Explorer to add the files. If the files are not added to the project, they will not be included during deployments.

References

Font Awesome

.NET Global Tool Docs

Kentico Docs

Blog Posts

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.1 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
1.0.0 502 9/18/2020