Icon support
The entire theme adds FontClass format icon support in mutiple places.
You can use iconfont and fontawesome to add icons to your project.
- For china users, iconfont is recommended
- For overseas users, fontawesome is recommended
# Iconfont
Iconfont (opens new window) is a vector icon management and communication platform created by Alimama MUX.
The designer uploads the icon to the Iconfont platform, and the user can customize the download of icons in a variety of formats. Users can also convert the icon into a font.
# How to use
First, you need to create a new project to set and manage your website’s icons:
- Log in to Iconfont using GitHub or Weibo.
- Find "Resources → My Projects" at the top of the website, and click the "New Project" icon in the upper right corner.
- Set a recognizable project name
- Fill in
FontClass/Symbol prefix
withicon-
(you can also fill in according to your preference, but you need to set this value tothemeConfig.iconPrefix
) - Font Family please keep
iconfont
# Import icon
Search freely through iconfont to find the icon you want to use, and click the "Add to Library" button on the icon
After searching for all the icons, click the "Add to Library" icon in the upper right corner, click "Add to Project" below and select the project you created then confirm.
# Edit icon
On the project page, you can edit the icons in the project, including adjustments with position, size, rotate, color, Unicode number and Font Class / Symbol.
# Generate icon files
Please click the "Font Class" button above the project and click Generate.
Import the link in
index.styl
of.vuepress/styles
. E.g:@import "//at.alicdn.com/t/font_2410206_a0xb9hku9iu.css";
1
Tips
If you add a new icon in the future, please regenerate the new CSS address and overwrite the old CSS address in .vuepress/styles/index.styl
.
# Fontawesome
This theme has built-in Fontawesome support.
# Import
Add in index.styl
of .vuepress/styles
:
@import "~vuepress-shared/styles/font-awesome";
Font-awesome current version is 5.15.3
And set themeConfig.iconPrefix
to 'fas fa-'
.
# Use
Please follow fontawesome document (opens new window).
# other instructions
- Icon will have
iconfont
class name by default - The prefix of the icon class is
icon-
by default, which can be changed in theiconPrefix
field in themeConfig
# Featured Icons
@import '//at.alicdn.com/t/font_2410206_a0xb9hku9iu.css';