diff --git a/.hugo_build.lock b/.hugo_build.lock
new file mode 100644
index 00000000..e69de29b
diff --git a/config.toml b/config.toml
index f73696d4..67079ee4 100644
--- a/config.toml
+++ b/config.toml
@@ -3,6 +3,36 @@
extended = true
min = "0.62.0"
+ # Menu config
+[menu]
+ [[menu.main]]
+ weight = 1
+ identifier = "posts"
+ # you can add extra information before the name (HTML format is supported), such as icons
+ pre = ""
+ # you can add extra information after the name (HTML format is supported), such as icons
+ post = ""
+ name = "Posts"
+ url = "/posts/"
+ # title will be shown when you hover on this menu link
+ title = ""
+ [[menu.main]]
+ weight = 2
+ identifier = "tags"
+ pre = ""
+ post = ""
+ name = "Tags"
+ url = "/tags/"
+ title = ""
+ [[menu.main]]
+ weight = 3
+ identifier = "categories"
+ pre = ""
+ post = ""
+ name = "Categories"
+ url = "/categories/"
+ title = ""
+
[params]
# site default theme ["auto", "light", "dark"]
defaultTheme = "auto"
@@ -14,9 +44,9 @@
# date format
dateFormat = "2006-01-02"
# website title for Open Graph and Twitter Cards
- title = "My cool site"
+ title = "KeepIt"
# website description for RSS, SEO, Open Graph and Twitter Cards
- description = "This is my cool site"
+ description = "This is my KeepIt site"
# website images for Open Graph and Twitter Cards
images = []
@@ -31,7 +61,7 @@
# URL of the LOGO
logo = ""
# title name
- name = "My cool site"
+ name = "My KeepIt site"
# you can add extra information before the name (HTML format is supported), such as icons
pre = ""
# you can add extra information after the name (HTML format is supported), such as icons
@@ -78,7 +108,7 @@
# App icon config
[params.app]
# optional site title override for the app when added to an iOS home screen or Android launcher
- title = "My cool site"
+ title = "My KeepIt site"
# whether to omit favicon resource links
noFavicon = false
# modern SVG favicon to use in place of older style .png and .ico files
@@ -120,13 +150,13 @@
[params.home.profile]
enable = true
# Gravatar Email for preferred avatar in home page
- gravatarEmail = ""
+ gravatarEmail = "mathias.hansen@example.com"
# URL of avatar shown in home page
avatarURL = ""
# title shown in home page (HTML format is supported)
title = ""
# subtitle shown in home page
- subtitle = "This is my cool site"
+ subtitle = "This is my KeepIt site"
# whether to use typeit animation for subtitle
typeit = true
# whether to show social links
diff --git a/content/about/index.en.md b/content/about/index.en.md
new file mode 100644
index 00000000..1aaa3282
--- /dev/null
+++ b/content/about/index.en.md
@@ -0,0 +1,120 @@
+---
+title: "About KeepIt"
+date: 2019-08-02T11:04:49+08:00
+draft: false
+description: "About KeepIt"
+images: ["/Apple-Devices-Preview.png"]
+
+lightgallery: true
+
+math:
+ enable: true
+---
+
+{{< style "img { height: 1.25rem; }" >}}
+[](https://github.com/Fastbyte01/KeepIt/releases)
+[](https://gohugo.io/)
+[](https://github.com/Fastbyte01/KeepIt/blob/master/LICENSE)
+[](https://github.com/Fastbyte01/KeepIt)
+[](https://github.com/Fastbyte01/KeepIt/fork)
+{{< /style >}}
+
+> [:(far fa-kiss-wink-heart fa-fw): KeepIt](https://github.com/Fastbyte01/KeepIt) is a **clean**, **elegant** but **advanced** blog theme for [Hugo](https://gohugo.io/) developed by [Dillon](https://dillonzq.com).
+>
+> It is based on the original [LeaveIt Theme](https://github.com/liuzc/LeaveIt) and [KeepIt Theme](https://github.com/Fastbyte01/KeepIt).
+
+
+
+### Features
+
+#### Performance and SEO
+
+* :(fas fa-rocket fa-fw): Optimized for **performance**: [99]/[100] on mobile and [100]/[100] on desktop in [Google PageSpeed Insights](https://developers.google.com/speed/pagespeed/insights)
+* :(fab fa-searchengin fa-fw): Optimized SEO performance with a correct **SEO SCHEMA** based on JSON-LD
+* :(fab fa-google fa-fw): **[Google Analytics](https://analytics.google.com/analytics)** supported
+* :(far fa-chart-bar fa-fw): **[Fathom Analytics](https://usefathom.com/)** supported
+* :(fas fa-sitemap fa-fw): Search engine **verification** supported (Google, Bind, Yandex and Baidu)
+* :(fas fa-tachometer-alt fa-fw): **CDN** for third-party libraries supported
+* :(fas fa-cloud-download-alt fa-fw): Automatically converted images with **Lazy Load** by [lazysizes](https://github.com/aFarkas/lazysizes)
+
+#### Appearance and Layout
+
+* :(fas fa-mobile-screen fa-fw): **[Desktop]/[Mobile] responsive** layout
+* :(fas fa-circle-half-stroke fa-rotate-180 fa-fw): **[Light]/[Dark]** mode
+* :(fas fa-layer-group fa-fw): Globally consistent **design language**
+* :(fas fa-ellipsis-h fa-fw): **Pagination** supported
+* :(far fa-list-alt fa-fw): Easy-to-use and self-expanding **table of contents**
+* :(fas fa-language fa-fw): **Multilanguage** supported and i18n ready
+* :(fab fa-css3-alt fa-fw): Beautiful **CSS animation**
+
+#### Social and Comment Systems
+
+* :(far fa-user fa-fw): **Gravatar** supported by [Gravatar](https://gravatar.com)
+* :(fas fa-user-circle fa-fw): Local **Avatar** supported
+* :(far fa-id-card fa-fw): Up to **64** social links supported
+* :(fas fa-share-square fa-fw): Up to **24** share sites supported
+* :(far fa-comment fa-fw): **Disqus** comment system supported by [Disqus](https://disqus.com)
+* :(far fa-comment-dots fa-fw): **Gitalk** comment system supported by [Gitalk](https://github.com/gitalk/gitalk)
+* :(far fa-comment-alt fa-fw): **Valine** comment system supported by [Valine](https://valine.js.org/)
+* :(far fa-comments fa-fw): **Facebook comments** system supported by [Facebook](https://developers.facebook.com/docs/plugins/comments/)
+* :(fas fa-comment fa-fw): **Telegram comments** system supported by [Comments](https://comments.app/)
+* :(fas fa-comment-dots fa-fw): **Commento** comment system supported by [Commento](https://commento.io/)
+* :(fas fa-comment-alt fa-fw): **Utterances** comment system supported by [Utterances](https://utteranc.es/)
+
+#### Extended Features
+
+* :(fas fa-search fa-fw): **Search** supported by [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/)
+* :(far fa-grin-tongue-wink fa-fw): **Twemoji** supported
+* :(fas fa-code fa-fw): Automatically **highlighting** code
+* :(far fa-copy fa-fw): **Copy code** to clipboard with one click
+* :(far fa-images fa-fw): **Images gallery** supported by [lightGallery](https://github.com/sachinchoolur/lightgallery)
+* :(fab fa-font-awesome fa-fw): Extended Markdown syntax for **[Font Awesome](https://fontawesome.com/) icons**
+* :(fas fa-superscript fa-fw): Extended Markdown syntax for **ruby annotation**
+* :(fas fa-percentage fa-fw): Extended Markdown syntax for **fraction**
+* :(fas fa-square-root-alt fa-fw): **Mathematical formula** supported by [$\KaTeX$](https://katex.org/)
+* :(fas fa-project-diagram fa-fw): **Diagrams** shortcode supported by [mermaid](https://github.com/mermaid-js/mermaid)
+* :(fas fa-chart-pie fa-fw): **Interactive data visualization** shortcode supported by [ECharts](https://echarts.apache.org/)
+* :(fas fa-map-marked-alt fa-fw): **Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
+* :(fas fa-music fa-fw): **Music player** shortcode supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)
+* :(fab fa-bilibili fa-fw): **Bilibili player** shortcode
+* :(fas fa-note-sticky fa-fw): Kinds of **admonitions** shortcode
+* :(fab fa-css3 fa-fw): **Custom style** shortcode
+* :(fab fa-js-square fa-fw): **Custom script** shortcode
+* :(fas fa-i-cursor fa-fw): **Animated typing** supported by [TypeIt](https://typeitjs.com/)
+* :(fas fa-cookie-bite fa-fw): **Cookie consent banner** supported by [cookieconsent](https://github.com/osano/cookieconsent)
+* ...
+
+### License
+
+KeepIt is licensed under the **MIT** license.
+
+Check the [LICENSE file](https://github.com/Fastbyte01/KeepIt/blob/master/LICENSE) for details.
+
+### Special Thanks
+
+Thanks to the authors of following resources included in the theme:
+
+* [normalize.css](https://github.com/necolas/normalize.css)
+* [Font Awesome](https://fontawesome.com/)
+* [Simple Icons](https://github.com/simple-icons/simple-icons)
+* [Animate.css](https://daneden.github.io/animate.css/)
+* [autocomplete](https://github.com/algolia/autocomplete)
+* [Lunr.js](https://lunrjs.com/)
+* [algoliasearch](https://github.com/algolia/algoliasearch-client-javascript)
+* [lazysizes](https://github.com/aFarkas/lazysizes)
+* [object-fit-images](https://github.com/fregante/object-fit-images)
+* [Twemoji](https://github.com/twitter/twemoji)
+* [emoji-data](https://github.com/iamcal/emoji-data)
+* [lightGallery](https://github.com/sachinchoolur/lightgallery)
+* [clipboard.js](https://github.com/zenorocha/clipboard.js)
+* [Sharer.js](https://github.com/ellisonleao/sharer.js)
+* [TypeIt](https://typeitjs.com/)
+* [$\KaTeX$](https://katex.org/)
+* [mermaid](https://github.com/mermaid-js/mermaid)
+* [ECharts](https://echarts.apache.org/)
+* [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
+* [APlayer](https://github.com/MoePlayer/APlayer)
+* [MetingJS](https://github.com/metowolf/MetingJS)
+* [Gitalk](https://github.com/gitalk/gitalk)
+* [Valine](https://valine.js.org/)
+* [cookieconsent](https://github.com/osano/cookieconsent)
diff --git a/content/categories/documentation/_index.en.md b/content/categories/documentation/_index.en.md
new file mode 100644
index 00000000..b40df67a
--- /dev/null
+++ b/content/categories/documentation/_index.en.md
@@ -0,0 +1,3 @@
+---
+title: "Documentation"
+---
diff --git a/content/posts/basic-markdown-syntax/featured-image.png b/content/posts/basic-markdown-syntax/featured-image.png
new file mode 100644
index 00000000..b31e1a58
Binary files /dev/null and b/content/posts/basic-markdown-syntax/featured-image.png differ
diff --git a/content/posts/basic-markdown-syntax/index.en.md b/content/posts/basic-markdown-syntax/index.en.md
new file mode 100644
index 00000000..3806ee13
--- /dev/null
+++ b/content/posts/basic-markdown-syntax/index.en.md
@@ -0,0 +1,764 @@
+---
+weight: 4
+title: "Basic Markdown Syntax"
+date: 2019-12-01T21:57:40+08:00
+lastmod: 2020-01-01T16:45:40+08:00
+draft: false
+author: "Dillon"
+authorLink: "https://dillonzq.com"
+description: "This article shows the basic Markdown syntax and format."
+images: []
+resources:
+- name: "featured-image"
+ src: "featured-image.png"
+
+tags: ["Markdown", "HTML"]
+categories: ["Markdown"]
+
+lightgallery: true
+---
+
+This article offers a sample of basic Markdown syntax that can be used in Hugo content files.
+
+
+
+{{< admonition >}}
+This article is a shameful copy of the great [Grav original page](http://learn.getgrav.org/content/markdown).
+
+If you want to know about the extended Markdown syntax of **KeepIt** theme, please read [extended Markdown syntax page](../theme-documentation-content#extended-markdown-syntax).
+{{< /admonition >}}
+
+Let's face it: Writing content for the Web is tiresome. WYSIWYG editors help alleviate this task, but they generally result in horrible code, or worse yet, ugly web pages.
+
+**Markdown** is a better way to write **HTML**, without all the complexities and ugliness that usually accompanies it.
+
+Some of the key benefits are:
+
+1. Markdown is simple to learn, with minimal extra characters, so it's also quicker to write content.
+2. Less chance of errors when writing in Markdown.
+3. Produces valid XHTML output.
+4. Keeps the content and the visual display separate, so you cannot mess up the look of your site.
+5. Write in any text editor or Markdown application you like.
+6. Markdown is a joy to use!
+
+John Gruber, the author of Markdown, puts it like this:
+
+> The overriding design goal for Markdown’s formatting syntax is to make it as readable as possible.
+> The idea is that a Markdown-formatted document should be publishable as-is, as plain text,
+> without looking like it’s been marked up with tags or formatting instructions.
+> While Markdown’s syntax has been influenced by several existing text-to-HTML filters,
+> the single biggest source of inspiration for Markdown’s syntax is the format of plain text email.
+>
+> {{< style "text-align: right;" >}}-- _John Gruber_{{< /style >}}
+
+Without further delay, let us go over the main elements of Markdown and what the resulting HTML looks like!
+
+{{< admonition tip >}}
+:(far fa-bookmark fa-fw): Bookmark this page for easy future reference!
+{{< /admonition >}}
+
+## 1 Headings
+
+Headings from `h2` through `h6` are constructed with a `#` for each level:
+
+```markdown
+## h2 Heading
+### h3 Heading
+#### h4 Heading
+##### h5 Heading
+###### h6 Heading
+```
+
+The HTML looks like this:
+
+```html
+
h2 Heading
+
h3 Heading
+
h4 Heading
+
h5 Heading
+
h6 Heading
+```
+
+{{< admonition note "Heading IDs" >}}
+To add a custom heading ID, enclose the custom ID in curly braces on the same line as the heading:
+
+```markdown
+### A Great Heading {#custom-id}
+```
+
+The HTML looks like this:
+
+```html
+
A Great Heading
+```
+{{< /admonition >}}
+
+## 2 Comments
+
+Comments should be HTML compatible.
+
+```html
+
+```
+
+Comment below should **NOT** be seen:
+
+
+
+## 3 Horizontal Rules
+
+The HTML `` element is for creating a "thematic break" between paragraph-level elements.
+In Markdown, you can create a `` with any of the following:
+
+* `___`: three consecutive underscores
+* `---`: three consecutive dashes
+* `***`: three consecutive asterisks
+
+The rendered output looks like this:
+
+___
+---
+***
+
+## 4 Body Copy
+
+Body copy written as normal, plain text will be wrapped with `` tags in the rendered HTML.
+
+So this body copy:
+
+```markdown
+Lorem ipsum dolor sit amet, graecis denique ei vel, at duo primis mandamus. Et legere ocurreret pri,
+animal tacimates complectitur ad cum. Cu eum inermis inimicus efficiendi. Labore officiis his ex,
+soluta officiis concludaturque ei qui, vide sensibus vim ad.
+```
+
+The HTML looks like this:
+
+```html
+
Lorem ipsum dolor sit amet, graecis denique ei vel, at duo primis mandamus. Et legere ocurreret pri, animal tacimates complectitur ad cum. Cu eum inermis inimicus efficiendi. Labore officiis his ex, soluta officiis concludaturque ei qui, vide sensibus vim ad.
+```
+
+A **line break** can be done with one blank line.
+
+## 5 Inline HTML
+
+If you need a certain HTML tag (with a class) you can simply use HTML:
+
+```html
+Paragraph in Markdown.
+
+
+ This is HTML
+
+
+Paragraph in Markdown.
+```
+
+## 6 Emphasis
+
+### Bold
+
+For emphasizing a snippet of text with a heavier font-weight.
+
+The following snippet of text is **rendered as bold text**.
+
+```markdown
+**rendered as bold text**
+__rendered as bold text__
+```
+
+The HTML looks like this:
+
+```html
+rendered as bold text
+```
+
+### Italics
+
+For emphasizing a snippet of text with italics.
+
+The following snippet of text is _rendered as italicized text_.
+
+```markdown
+*rendered as italicized text*
+_rendered as italicized text_
+```
+
+The HTML looks like this:
+
+```html
+rendered as italicized text
+```
+
+### Strikethrough
+
+In [[GFM]^(GitHub flavored Markdown)](https://github.github.com/gfm/) you can do strikethroughs.
+
+```markdown
+~~Strike through this text.~~
+```
+
+The rendered output looks like this:
+
+~~Strike through this text.~~
+
+The HTML looks like this:
+
+```html
+Strike through this text.
+```
+
+### Combination
+
+Bold, italics, and strikethrough can be used in combination.
+
+```markdown
+***bold and italics***
+~~**strikethrough and bold**~~
+~~*strikethrough and italics*~~
+~~***bold, italics and strikethrough***~~
+```
+
+The rendered output looks like this:
+
+***bold and italics***
+
+~~**strikethrough and bold**~~
+
+~~*strikethrough and italics*~~
+
+~~***bold, italics and strikethrough***~~
+
+The HTML looks like this:
+
+```html
+bold and italics
+strikethrough and bold
+strikethrough and italics
+bold, italics and strikethrough
+```
+
+## 7 Blockquotes
+
+For quoting blocks of content from another source within your document.
+
+Add `>` before any text you want to quote:
+
+```markdown
+> **Fusion Drive** combines a hard drive with a flash storage (solid-state drive) and presents it as a single logical volume with the space of both drives combined.
+```
+
+The rendered output looks like this:
+
+> **Fusion Drive** combines a hard drive with a flash storage (solid-state drive) and presents it as a single logical volume with the space of both drives combined.
+
+The HTML looks like this:
+
+```html
+
+
+ Fusion Drive combines a hard drive with a flash storage (solid-state drive) and presents it as a single logical volume with the space of both drives combined.
+
+
+```
+
+Blockquotes can also be nested:
+
+```markdown
+> Donec massa lacus, ultricies a ullamcorper in, fermentum sed augue.
+Nunc augue augue, aliquam non hendrerit ac, commodo vel nisi.
+>> Sed adipiscing elit vitae augue consectetur a gravida nunc vehicula. Donec auctor
+odio non est accumsan facilisis. Aliquam id turpis in dolor tincidunt mollis ac eu diam.
+```
+
+The rendered output looks like this:
+
+> Donec massa lacus, ultricies a ullamcorper in, fermentum sed augue.
+Nunc augue augue, aliquam non hendrerit ac, commodo vel nisi.
+>> Sed adipiscing elit vitae augue consectetur a gravida nunc vehicula. Donec auctor
+odio non est accumsan facilisis. Aliquam id turpis in dolor tincidunt mollis ac eu diam.
+
+## 8 Lists
+
+### Unordered
+
+A list of items in which the order of the items does not explicitly matter.
+
+You may use any of the following symbols to denote bullets for each list item:
+
+```markdown
+* valid bullet
+- valid bullet
++ valid bullet
+```
+
+For example:
+
+```markdown
+* Lorem ipsum dolor sit amet
+* Consectetur adipiscing elit
+* Integer molestie lorem at massa
+* Facilisis in pretium nisl aliquet
+* Nulla volutpat aliquam velit
+ * Phasellus iaculis neque
+ * Purus sodales ultricies
+ * Vestibulum laoreet porttitor sem
+ * Ac tristique libero volutpat at
+* Faucibus porta lacus fringilla vel
+* Aenean sit amet erat nunc
+* Eget porttitor lorem
+```
+
+The rendered output looks like this:
+
+* Lorem ipsum dolor sit amet
+* Consectetur adipiscing elit
+* Integer molestie lorem at massa
+* Facilisis in pretium nisl aliquet
+* Nulla volutpat aliquam velit
+ * Phasellus iaculis neque
+ * Purus sodales ultricies
+ * Vestibulum laoreet porttitor sem
+ * Ac tristique libero volutpat at
+* Faucibus porta lacus fringilla vel
+* Aenean sit amet erat nunc
+* Eget porttitor lorem
+
+The HTML looks like this:
+
+```html
+
+
Lorem ipsum dolor sit amet
+
Consectetur adipiscing elit
+
Integer molestie lorem at massa
+
Facilisis in pretium nisl aliquet
+
Nulla volutpat aliquam velit
+
+
Phasellus iaculis neque
+
Purus sodales ultricies
+
Vestibulum laoreet porttitor sem
+
Ac tristique libero volutpat at
+
+
+
Faucibus porta lacus fringilla vel
+
Aenean sit amet erat nunc
+
Eget porttitor lorem
+
+```
+
+### Ordered
+
+A list of items in which the order of items does explicitly matter.
+
+```markdown
+1. Lorem ipsum dolor sit amet
+2. Consectetur adipiscing elit
+3. Integer molestie lorem at massa
+4. Facilisis in pretium nisl aliquet
+5. Nulla volutpat aliquam velit
+6. Faucibus porta lacus fringilla vel
+7. Aenean sit amet erat nunc
+8. Eget porttitor lorem
+```
+
+The rendered output looks like this:
+
+1. Lorem ipsum dolor sit amet
+2. Consectetur adipiscing elit
+3. Integer molestie lorem at massa
+4. Facilisis in pretium nisl aliquet
+5. Nulla volutpat aliquam velit
+6. Faucibus porta lacus fringilla vel
+7. Aenean sit amet erat nunc
+8. Eget porttitor lorem
+
+The HTML looks like this:
+
+```html
+
+
Lorem ipsum dolor sit amet
+
Consectetur adipiscing elit
+
Integer molestie lorem at massa
+
Facilisis in pretium nisl aliquet
+
Nulla volutpat aliquam velit
+
Faucibus porta lacus fringilla vel
+
Aenean sit amet erat nunc
+
Eget porttitor lorem
+
+```
+
+{{< admonition tip >}}
+If you just use `1.` for each number, Markdown will automatically number each item. For example:
+
+```markdown
+1. Lorem ipsum dolor sit amet
+1. Consectetur adipiscing elit
+1. Integer molestie lorem at massa
+1. Facilisis in pretium nisl aliquet
+1. Nulla volutpat aliquam velit
+1. Faucibus porta lacus fringilla vel
+1. Aenean sit amet erat nunc
+1. Eget porttitor lorem
+```
+
+The rendered output looks like this:
+
+1. Lorem ipsum dolor sit amet
+1. Consectetur adipiscing elit
+1. Integer molestie lorem at massa
+1. Facilisis in pretium nisl aliquet
+1. Nulla volutpat aliquam velit
+1. Faucibus porta lacus fringilla vel
+1. Aenean sit amet erat nunc
+1. Eget porttitor lorem
+{{< /admonition >}}
+
+### Task Lists
+
+Task lists allow you to create a list of items with checkboxes. To create a task list, add dashes (`-`) and brackets with a space (`[ ]`) before task list items. To select a checkbox, add an x in between the brackets (`[x]`).
+
+```markdown
+- [x] Write the press release
+- [ ] Update the website
+- [ ] Contact the media
+```
+
+The rendered output looks like this:
+
+- [x] Write the press release
+- [ ] Update the website
+- [ ] Contact the media
+
+## 9 Code
+
+### Inline Code
+
+Wrap inline snippets of code with `.
+
+```markdown
+In this example, `` should be wrapped as **code**.
+```
+
+The rendered output looks like this:
+
+In this example, `` should be wrapped as **code**.
+
+The HTML looks like this:
+
+```html
+
+ In this example, <section></section> should be wrapped with code.
+
+```
+
+### Indented Code
+
+Or indent several lines of code by at least four spaces, as in:
+
+```markdown
+ // Some comments
+ line 1 of code
+ line 2 of code
+ line 3 of code
+```
+
+The rendered output looks like this:
+
+ // Some comments
+ line 1 of code
+ line 2 of code
+ line 3 of code
+
+The HTML looks like this:
+
+```html
+
+
+ // Some comments
+ line 1 of code
+ line 2 of code
+ line 3 of code
+
+
+```
+
+### Block Fenced Code
+
+Use "fences" ``` to block in multiple lines of code with a language attribute.
+
+{{< highlight markdown >}}
+```markdown
+Sample text here...
+```
+{{< / highlight >}}
+
+The HTML looks like this:
+
+```html
+
+ Sample text here...
+
+```
+
+### Syntax Highlighting
+
+[GFM]^(GitHub Flavored Markdown) also supports syntax highlighting.
+
+To activate it, simply add the file extension of the language you want to use directly after the first code "fence",
+```js, and syntax highlighting will automatically be applied in the rendered HTML.
+
+For example, to apply syntax highlighting to JavaScript code:
+
+{{< highlight markdown >}}
+```js
+grunt.initConfig({
+ assemble: {
+ options: {
+ assets: 'docs/assets',
+ data: 'src/data/*.{json,yml}',
+ helpers: 'src/custom-helpers.js',
+ partials: ['src/partials/**/*.{hbs,md}']
+ },
+ pages: {
+ options: {
+ layout: 'default.hbs'
+ },
+ files: {
+ './': ['src/templates/pages/index.hbs']
+ }
+ }
+ }
+};
+```
+{{< / highlight >}}
+
+The rendered output looks like this:
+
+```js
+grunt.initConfig({
+ assemble: {
+ options: {
+ assets: 'docs/assets',
+ data: 'src/data/*.{json,yml}',
+ helpers: 'src/custom-helpers.js',
+ partials: ['src/partials/**/*.{hbs,md}']
+ },
+ pages: {
+ options: {
+ layout: 'default.hbs'
+ },
+ files: {
+ './': ['src/templates/pages/index.hbs']
+ }
+ }
+ }
+};
+```
+
+{{< admonition >}}
+[Syntax highlighting page](https://gohugo.io/content-management/syntax-highlighting/) in **Hugo** Docs introduces more about syntax highlighting, including highlight shortcode.
+{{< /admonition >}}
+
+## 10 Tables
+
+Tables are created by adding pipes as dividers between each cell, and by adding a line of dashes (also separated by bars) beneath the header. Note that the pipes do not need to be vertically aligned.
+
+```markdown
+| Option | Description |
+| ------ | ----------- |
+| data | path to data files to supply the data that will be passed into templates. |
+| engine | engine to be used for processing templates. Handlebars is the default. |
+| ext | extension to be used for dest files. |
+```
+
+The rendered output looks like this:
+
+| Option | Description |
+| ------ | ----------- |
+| data | path to data files to supply the data that will be passed into templates. |
+| engine | engine to be used for processing templates. Handlebars is the default. |
+| ext | extension to be used for dest files. |
+
+The HTML looks like this:
+
+```html
+
+
+
+
Option
+
Description
+
+
+
+
+
data
+
path to data files to supply the data that will be passed into templates.
+
+
+
engine
+
engine to be used for processing templates. Handlebars is the default.
+
+
+
ext
+
extension to be used for dest files.
+
+
+
+```
+
+{{< admonition note "Right or center aligned text" >}}
+Adding a colon on the right side of the dashes below any heading will right align text for that column.
+
+Adding colons on both sides of the dashes below any heading will center align text for that column.
+
+```markdown
+| Option | Description |
+|:------:| -----------:|
+| data | path to data files to supply the data that will be passed into templates. |
+| engine | engine to be used for processing templates. Handlebars is the default. |
+| ext | extension to be used for dest files. |
+```
+
+The rendered output looks like this:
+
+| Option | Description |
+|:------:| -----------:|
+| data | path to data files to supply the data that will be passed into templates. |
+| engine | engine to be used for processing templates. Handlebars is the default. |
+| ext | extension to be used for dest files. |
+{{< /admonition >}}
+
+## 11 Links {#links}
+
+### Basic Link
+
+```markdown
+
+
+[Assemble](https://assemble.io)
+```
+
+The rendered output looks like this (hover over the link, there is no tooltip):
+
+
+
+
+
+[Assemble](https://assemble.io)
+
+The HTML looks like this:
+
+```html
+https://assemble.io
+contact@revolunet.com
+Assemble
+```
+
+### Add a Title
+
+```markdown
+[Upstage](https://github.com/upstage/ "Visit Upstage!")
+```
+
+The rendered output looks like this (hover over the link, there should be a tooltip):
+
+[Upstage](https://github.com/upstage/ "Visit Upstage!")
+
+The HTML looks like this:
+
+```html
+Upstage
+```
+
+### Named Anchors
+
+Named anchors enable you to jump to the specified anchor point on the same page. For example, each of these chapters:
+
+```markdown
+## Table of Contents
+ * [Chapter 1](#chapter-1)
+ * [Chapter 2](#chapter-2)
+ * [Chapter 3](#chapter-3)
+```
+
+will jump to these sections:
+
+```markdown
+## Chapter 1
+Content for chapter one.
+
+## Chapter 2
+Content for chapter one.
+
+## Chapter 3
+Content for chapter one.
+```
+
+{{< admonition >}}
+The specific placement of the anchor tag seems to be arbitrary. They are placed inline here since it seems to be unobtrusive, and it works.
+{{< /admonition >}}
+
+## 12 Footnotes
+
+Footnotes allow you to add notes and references without cluttering the body of the document. When you create a footnote, a superscript number with a link appears where you added the footnote reference. Readers can click the link to jump to the content of the footnote at the bottom of the page.
+
+To create a footnote reference, add a caret and an identifier inside brackets (`[^1]`). Identifiers can be numbers or words, but they can’t contain spaces or tabs. Identifiers only correlate the footnote reference with the footnote itself — in the output, footnotes are numbered sequentially.
+
+Add the footnote using another caret and number inside brackets with a colon and text (`[^1]: My footnote.`). You don’t have to put footnotes at the end of the document. You can put them anywhere except inside other elements like lists, block quotes, and tables.
+
+```markdown
+This is a digital footnote[^1].
+This is a footnote with "label"[^label]
+
+[^1]: This is a digital footnote
+[^label]: This is a footnote with "label"
+```
+
+This is a digital footnote[^1].
+
+This is a footnote with "label"[^label]
+
+[^1]: This is a digital footnote
+[^label]: This is a footnote with "label"
+
+## 13 Images
+
+Images have a similar syntax to links but include a preceding exclamation point.
+
+```markdown
+
+```
+
+
+
+or:
+
+```markdown
+
+```
+
+
+
+Like links, images also have a footnote style syntax:
+
+```markdown
+![Alt text][id]
+```
+
+![Alt text][id]
+
+With a reference later in the document defining the URL location:
+
+```markdown
+[id]: https://octodex.github.com/images/dojocat.jpg "The Dojocat"
+```
+
+[id]: https://octodex.github.com/images/dojocat.jpg "The Dojocat"
+
+{{< admonition tip >}}
+**KeepIt** theme has [special shortcode for image](../theme-documentation-extended-shortcodes#image), which provides more features.
+{{< /admonition >}}
diff --git a/content/posts/emoji-support/featured-image.jpg b/content/posts/emoji-support/featured-image.jpg
new file mode 100644
index 00000000..5758440e
Binary files /dev/null and b/content/posts/emoji-support/featured-image.jpg differ
diff --git a/content/posts/emoji-support/index.en.md b/content/posts/emoji-support/index.en.md
new file mode 100644
index 00000000..76b6d0d5
--- /dev/null
+++ b/content/posts/emoji-support/index.en.md
@@ -0,0 +1,1285 @@
+---
+weight: 5
+title: "Emoji Support"
+date: 2019-10-01T17:55:28+08:00
+lastmod: 2019-10-01T17:55:28+08:00
+draft: false
+author: "Dillon"
+authorLink: "https://dillonzq.com"
+description: "Guide to emoji usage in Hugo and KeepIt."
+images: []
+resources:
+- name: "featured-image"
+ src: "featured-image.jpg"
+
+tags: ["emoji"]
+categories: ["Markdown"]
+
+twemoji: false
+lightgallery: true
+---
+
+Emoji can be enabled in a Hugo project in a number of ways.
+
+
+
+The [`emojify`](https://gohugo.io/functions/emojify/) function can be called directly in templates or [Inline Shortcodes](https://gohugo.io/templates/shortcode-templates#inline-shortcodes).
+
+To enable emoji globally, set `enableEmoji` to `true` in your [site configuration](https://gohugo.io/getting-started/configuration/) and then you can type emoji shorthand codes directly in content files.
+
+These begin and end with a **colon** and include the **code** of an emoji:
+
+```markdown
+Gone camping! {?:}tent: Be back soon.
+
+That is so funny! {?:}joy:
+```
+
+The rendered output looks like this:
+
+Gone camping! :tent: Be back soon.
+
+That is so funny! :joy:
+
+The following **cheat sheet** is a useful reference for emoji shorthand codes.
+
+## Smileys & Emotion
+
+### Face Smiling
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :grinning: | `grinning` | :smiley: | `smiley` |
+| :smile: | `smile` | :grin: | `grin` |
+| :laughing: | `laughing` `satisfied` | :sweat_smile: | `sweat_smile` |
+| :rofl: | `rofl` | :joy: | `joy` |
+| :slightly_smiling_face: | `slightly_smiling_face` | :upside_down_face: | `upside_down_face` |
+| :wink: | `wink` | :blush: | `blush` |
+| :innocent: | `innocent` | | |
+
+### Face Affection
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :heart_eyes: | `heart_eyes` | :kissing_heart: | `kissing_heart` |
+| :kissing: | `kissing` | :relaxed: | `relaxed` |
+| :kissing_closed_eyes: | `kissing_closed_eyes` | :kissing_smiling_eyes: | `kissing_smiling_eyes` |
+
+### Face Tongue
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :yum: | `yum` | :stuck_out_tongue: | `stuck_out_tongue` |
+| :stuck_out_tongue_winking_eye: | `stuck_out_tongue_winking_eye` | :stuck_out_tongue_closed_eyes: | `stuck_out_tongue_closed_eyes` |
+| :money_mouth_face: | `money_mouth_face` | | |
+
+### Face Hand
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :hugs: | `hugs` | :thinking: | `thinking` |
+
+### Face Neutral Skeptical
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :zipper_mouth_face: | `zipper_mouth_face` | :neutral_face: | `neutral_face` |
+| :expressionless: | `expressionless` | :no_mouth: | `no_mouth` |
+| :smirk: | `smirk` | :unamused: | `unamused` |
+| :roll_eyes: | `roll_eyes` | :grimacing: | `grimacing` |
+| :lying_face: | `lying_face` | | |
+
+### Face Sleepy
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :relieved: | `relieved` | :pensive: | `pensive` |
+| :sleepy: | `sleepy` | :drooling_face: | `drooling_face` |
+| :sleeping: | `sleeping` | | |
+
+### Face Unwell
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :mask: | `mask` | :face_with_thermometer: | `face_with_thermometer` |
+| :face_with_head_bandage: | `face_with_head_bandage` | :nauseated_face: | `nauseated_face` |
+| :sneezing_face: | `sneezing_face` | :dizzy_face: | `dizzy_face` |
+
+### Face Hat
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :cowboy_hat_face: | `cowboy_hat_face` | | |
+
+### Face Glasses
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :sunglasses: | `sunglasses` | :nerd_face: | `nerd_face` |
+
+### Face Concerned
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :confused: | `confused` | :worried: | `worried` |
+| :slightly_frowning_face: | `slightly_frowning_face` | :frowning_face: | `frowning_face` |
+| :open_mouth: | `open_mouth` | :hushed: | `hushed` |
+| :astonished: | `astonished` | :flushed: | `flushed` |
+| :frowning: | `frowning` | :anguished: | `anguished` |
+| :fearful: | `fearful` | :cold_sweat: | `cold_sweat` |
+| :disappointed_relieved: | `disappointed_relieved` | :cry: | `cry` |
+| :sob: | `sob` | :scream: | `scream` |
+| :confounded: | `confounded` | :persevere: | `persevere` |
+| :disappointed: | `disappointed` | :sweat: | `sweat` |
+| :weary: | `weary` | :tired_face: | `tired_face` |
+
+### Face Negative
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :triumph: | `triumph` | :pout: | `pout` `rage` |
+| :angry: | `angry` | :smiling_imp: | `smiling_imp` |
+| :imp: | `imp` | :skull: | `skull` |
+| :skull_and_crossbones: | `skull_and_crossbones` | | |
+
+### Face Costume
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :hankey: | `hankey` `poop` `shit` | :clown_face: | `clown_face` |
+| :japanese_ogre: | `japanese_ogre` | :japanese_goblin: | `japanese_goblin` |
+| :ghost: | `ghost` | :alien: | `alien` |
+| :space_invader: | `space_invader` | :robot: | `robot` |
+
+### Cat Face
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :smiley_cat: | `smiley_cat` | :smile_cat: | `smile_cat` |
+| :joy_cat: | `joy_cat` | :heart_eyes_cat: | `heart_eyes_cat` |
+| :smirk_cat: | `smirk_cat` | :kissing_cat: | `kissing_cat` |
+| :scream_cat: | `scream_cat` | :crying_cat_face: | `crying_cat_face` |
+| :pouting_cat: | `pouting_cat` | | |
+
+### Monkey Face
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :see_no_evil: | `see_no_evil` | :hear_no_evil: | `hear_no_evil` |
+| :speak_no_evil: | `speak_no_evil` | | |
+
+### Emotion
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :kiss: | `kiss` | :love_letter: | `love_letter` |
+| :cupid: | `cupid` | :gift_heart: | `gift_heart` |
+| :sparkling_heart: | `sparkling_heart` | :heartpulse: | `heartpulse` |
+| :heartbeat: | `heartbeat` | :revolving_hearts: | `revolving_hearts` |
+| :two_hearts: | `two_hearts` | :heart_decoration: | `heart_decoration` |
+| :heavy_heart_exclamation: | `heavy_heart_exclamation` | :broken_heart: | `broken_heart` |
+| :heart: | `heart` | :yellow_heart: | `yellow_heart` |
+| :green_heart: | `green_heart` | :blue_heart: | `blue_heart` |
+| :purple_heart: | `purple_heart` | :black_heart: | `black_heart` |
+| :100: | `100` | :anger: | `anger` |
+| :boom: | `boom` `collision` | :dizzy: | `dizzy` |
+| :sweat_drops: | `sweat_drops` | :dash: | `dash` |
+| :hole: | `hole` | :bomb: | `bomb` |
+| :speech_balloon: | `speech_balloon` | :eye_speech_bubble: | `eye_speech_bubble` |
+| :right_anger_bubble: | `right_anger_bubble` | :thought_balloon: | `thought_balloon` |
+| :zzz: | `zzz` | | |
+
+## People & Body
+
+### Hand Fingers Open
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :wave: | `wave` | :raised_back_of_hand: | `raised_back_of_hand` |
+| :raised_hand_with_fingers_splayed: | `raised_hand_with_fingers_splayed` | :hand: | `hand` `raised_hand` |
+| :vulcan_salute: | `vulcan_salute` | | |
+
+### Hand Fingers Partial
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :ok_hand: | `ok_hand` | :v: | `v` |
+| :crossed_fingers: | `crossed_fingers` | :metal: | `metal` |
+| :call_me_hand: | `call_me_hand` | | |
+
+### Hand Single Finger
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :point_left: | `point_left` | :point_right: | `point_right` |
+| :point_up_2: | `point_up_2` | :fu: | `fu` `middle_finger` |
+| :point_down: | `point_down` | :point_up: | `point_up` |
+
+### Hand Fingers Closed
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :+1: | `+1` `thumbsup` | :-1: | `-1` `thumbsdown` |
+| :fist: | `fist` `fist_raised` | :facepunch: | `facepunch` `fist_oncoming` `punch` |
+| :fist_left: | `fist_left` | :fist_right: | `fist_right` |
+
+### Hands
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :clap: | `clap` | :raised_hands: | `raised_hands` |
+| :open_hands: | `open_hands` | :handshake: | `handshake` |
+| :pray: | `pray` | | |
+
+### Hand Prop
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :writing_hand: | `writing_hand` | :nail_care: | `nail_care` |
+| :selfie: | `selfie` | | |
+
+### Body Parts
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :muscle: | `muscle` | :ear: | `ear` |
+| :nose: | `nose` | :eyes: | `eyes` |
+| :eye: | `eye` | :tongue: | `tongue` |
+| :lips: | `lips` | | |
+
+### Person
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :baby: | `baby` | :boy: | `boy` |
+| :girl: | `girl` | :blonde_man: | `blonde_man` `person_with_blond_hair` |
+| :man: | `man` | :woman: | `woman` |
+| :blonde_woman: | `blonde_woman` | :older_man: | `older_man` |
+| :older_woman: | `older_woman` | | |
+
+### Person Gesture
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :frowning_woman: | `frowning_woman` `person_frowning` | :frowning_man: | `frowning_man` |
+| :person_with_pouting_face: | `person_with_pouting_face` `pouting_woman` | :pouting_man: | `pouting_man` |
+| :ng_woman: | `ng_woman` `no_good` `no_good_woman` | :ng_man: | `ng_man` `no_good_man` |
+| :ok_woman: | `ok_woman` | :ok_man: | `ok_man` |
+| :information_desk_person: | `information_desk_person` `sassy_woman` `tipping_hand_woman` | :sassy_man: | `sassy_man` `tipping_hand_man` |
+| :raising_hand: | `raising_hand` `raising_hand_woman` | :raising_hand_man: | `raising_hand_man` |
+| :bow: | `bow` `bowing_man` | :bowing_woman: | `bowing_woman` |
+| :man_facepalming: | `man_facepalming` | :woman_facepalming: | `woman_facepalming` |
+| :man_shrugging: | `man_shrugging` | :woman_shrugging: | `woman_shrugging` |
+
+### Person Role
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :man_health_worker: | `man_health_worker` | :woman_health_worker: | `woman_health_worker` |
+| :man_student: | `man_student` | :woman_student: | `woman_student` |
+| :man_teacher: | `man_teacher` | :woman_teacher: | `woman_teacher` |
+| :man_judge: | `man_judge` | :woman_judge: | `woman_judge` |
+| :man_farmer: | `man_farmer` | :woman_farmer: | `woman_farmer` |
+| :man_cook: | `man_cook` | :woman_cook: | `woman_cook` |
+| :man_mechanic: | `man_mechanic` | :woman_mechanic: | `woman_mechanic` |
+| :man_factory_worker: | `man_factory_worker` | :woman_factory_worker: | `woman_factory_worker` |
+| :man_office_worker: | `man_office_worker` | :woman_office_worker: | `woman_office_worker` |
+| :man_scientist: | `man_scientist` | :woman_scientist: | `woman_scientist` |
+| :man_technologist: | `man_technologist` | :woman_technologist: | `woman_technologist` |
+| :man_singer: | `man_singer` | :woman_singer: | `woman_singer` |
+| :man_artist: | `man_artist` | :woman_artist: | `woman_artist` |
+| :man_pilot: | `man_pilot` | :woman_pilot: | `woman_pilot` |
+| :man_astronaut: | `man_astronaut` | :woman_astronaut: | `woman_astronaut` |
+| :man_firefighter: | `man_firefighter` | :woman_firefighter: | `woman_firefighter` |
+| :cop: | `cop` `policeman` | :policewoman: | `policewoman` |
+| :detective: | `detective` `male_detective` | :female_detective: | `female_detective` |
+| :guardsman: | `guardsman` | :guardswoman: | `guardswoman` |
+| :construction_worker: | `construction_worker` `construction_worker_man` | :construction_worker_woman: | `construction_worker_woman` |
+| :prince: | `prince` | :princess: | `princess` |
+| :man_with_turban: | `man_with_turban` | :woman_with_turban: | `woman_with_turban` |
+| :man_with_gua_pi_mao: | `man_with_gua_pi_mao` | :man_in_tuxedo: | `man_in_tuxedo` |
+| :bride_with_veil: | `bride_with_veil` | :pregnant_woman: | `pregnant_woman` |
+
+### Person Fantasy
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :angel: | `angel` | :santa: | `santa` |
+| :mrs_claus: | `mrs_claus` | | |
+
+### Person Activity
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :massage: | `massage` `massage_woman` | :massage_man: | `massage_man` |
+| :haircut: | `haircut` `haircut_woman` | :haircut_man: | `haircut_man` |
+| :walking: | `walking` `walking_man` | :walking_woman: | `walking_woman` |
+| :runner: | `runner` `running` `running_man` | :running_woman: | `running_woman` |
+| :dancer: | `dancer` | :man_dancing: | `man_dancing` |
+| :business_suit_levitating: | `business_suit_levitating` | :dancers: | `dancers` `dancing_women` |
+| :dancing_men: | `dancing_men` | | |
+
+### Person Sport
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :person_fencing: | `person_fencing` | :horse_racing: | `horse_racing` |
+| :skier: | `skier` | :snowboarder: | `snowboarder` |
+| :golfing_man: | `golfing_man` | :golfing_woman: | `golfing_woman` |
+| :surfer: | `surfer` `surfing_man` | :surfing_woman: | `surfing_woman` |
+| :rowboat: | `rowboat` `rowing_man` | :rowing_woman: | `rowing_woman` |
+| :swimmer: | `swimmer` `swimming_man` | :swimming_woman: | `swimming_woman` |
+| :basketball_man: | `basketball_man` | :basketball_woman: | `basketball_woman` |
+| :weight_lifting_man: | `weight_lifting_man` | :weight_lifting_woman: | `weight_lifting_woman` |
+| :bicyclist: | `bicyclist` `biking_man` | :biking_woman: | `biking_woman` |
+| :mountain_bicyclist: | `mountain_bicyclist` `mountain_biking_man` | :mountain_biking_woman: | `mountain_biking_woman` |
+| :man_cartwheeling: | `man_cartwheeling` | :woman_cartwheeling: | `woman_cartwheeling` |
+| :men_wrestling: | `men_wrestling` | :women_wrestling: | `women_wrestling` |
+| :man_playing_water_polo: | `man_playing_water_polo` | :woman_playing_water_polo: | `woman_playing_water_polo` |
+| :man_playing_handball: | `man_playing_handball` | :woman_playing_handball: | `woman_playing_handball` |
+| :man_juggling: | `man_juggling` | :woman_juggling: | `woman_juggling` |
+
+### Person Resting
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :bath: | `bath` | :sleeping_bed: | `sleeping_bed` |
+
+### Family
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :two_women_holding_hands: | `two_women_holding_hands` | :couple: | `couple` |
+| :two_men_holding_hands: | `two_men_holding_hands` | :couplekiss_man_woman: | `couplekiss_man_woman` |
+| :couplekiss_man_man: | `couplekiss_man_man` | :couplekiss_woman_woman: | `couplekiss_woman_woman` |
+| :couple_with_heart: | `couple_with_heart` `couple_with_heart_woman_man` | :couple_with_heart_man_man: | `couple_with_heart_man_man` |
+| :couple_with_heart_woman_woman: | `couple_with_heart_woman_woman` | :family: | `family` `family_man_woman_boy` |
+| :family_man_woman_girl: | `family_man_woman_girl` | :family_man_woman_girl_boy: | `family_man_woman_girl_boy` |
+| :family_man_woman_boy_boy: | `family_man_woman_boy_boy` | :family_man_woman_girl_girl: | `family_man_woman_girl_girl` |
+| :family_man_man_boy: | `family_man_man_boy` | :family_man_man_girl: | `family_man_man_girl` |
+| :family_man_man_girl_boy: | `family_man_man_girl_boy` | :family_man_man_boy_boy: | `family_man_man_boy_boy` |
+| :family_man_man_girl_girl: | `family_man_man_girl_girl` | :family_woman_woman_boy: | `family_woman_woman_boy` |
+| :family_woman_woman_girl: | `family_woman_woman_girl` | :family_woman_woman_girl_boy: | `family_woman_woman_girl_boy` |
+| :family_woman_woman_boy_boy: | `family_woman_woman_boy_boy` | :family_woman_woman_girl_girl: | `family_woman_woman_girl_girl` |
+| :family_man_boy: | `family_man_boy` | :family_man_boy_boy: | `family_man_boy_boy` |
+| :family_man_girl: | `family_man_girl` | :family_man_girl_boy: | `family_man_girl_boy` |
+| :family_man_girl_girl: | `family_man_girl_girl` | :family_woman_boy: | `family_woman_boy` |
+| :family_woman_boy_boy: | `family_woman_boy_boy` | :family_woman_girl: | `family_woman_girl` |
+| :family_woman_girl_boy: | `family_woman_girl_boy` | :family_woman_girl_girl: | `family_woman_girl_girl` |
+
+### Person Symbol
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :speaking_head: | `speaking_head` | :bust_in_silhouette: | `bust_in_silhouette` |
+| :busts_in_silhouette: | `busts_in_silhouette` | :footprints: | `footprints` |
+
+## Animals & Nature
+
+### Animal Mammal
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :monkey_face: | `monkey_face` | :monkey: | `monkey` |
+| :gorilla: | `gorilla` | :dog: | `dog` |
+| :dog2: | `dog2` | :poodle: | `poodle` |
+| :wolf: | `wolf` | :fox_face: | `fox_face` |
+| :cat: | `cat` | :cat2: | `cat2` |
+| :lion: | `lion` | :tiger: | `tiger` |
+| :tiger2: | `tiger2` | :leopard: | `leopard` |
+| :horse: | `horse` | :racehorse: | `racehorse` |
+| :unicorn: | `unicorn` | :deer: | `deer` |
+| :cow: | `cow` | :ox: | `ox` |
+| :water_buffalo: | `water_buffalo` | :cow2: | `cow2` |
+| :pig: | `pig` | :pig2: | `pig2` |
+| :boar: | `boar` | :pig_nose: | `pig_nose` |
+| :ram: | `ram` | :sheep: | `sheep` |
+| :goat: | `goat` | :dromedary_camel: | `dromedary_camel` |
+| :camel: | `camel` | :elephant: | `elephant` |
+| :rhinoceros: | `rhinoceros` | :mouse: | `mouse` |
+| :mouse2: | `mouse2` | :rat: | `rat` |
+| :hamster: | `hamster` | :rabbit: | `rabbit` |
+| :rabbit2: | `rabbit2` | :chipmunk: | `chipmunk` |
+| :bat: | `bat` | :bear: | `bear` |
+| :koala: | `koala` | :panda_face: | `panda_face` |
+| :feet: | `feet` `paw_prints` | | |
+
+### Animal Bird
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :turkey: | `turkey` | :chicken: | `chicken` |
+| :rooster: | `rooster` | :hatching_chick: | `hatching_chick` |
+| :baby_chick: | `baby_chick` | :hatched_chick: | `hatched_chick` |
+| :bird: | `bird` | :penguin: | `penguin` |
+| :dove: | `dove` | :eagle: | `eagle` |
+| :duck: | `duck` | :owl: | `owl` |
+
+### Animal Amphibian
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :frog: | `frog` |
+
+### Animal Reptile
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :crocodile: | `crocodile` | :turtle: | `turtle` |
+| :lizard: | `lizard` | :snake: | `snake` |
+| :dragon_face: | `dragon_face` | :dragon: | `dragon` |
+
+### Animal Marine
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :whale: | `whale` | :whale2: | `whale2` |
+| :dolphin: | `dolphin` `flipper` | :fish: | `fish` |
+| :tropical_fish: | `tropical_fish` | :blowfish: | `blowfish` |
+| :shark: | `shark` | :octopus: | `octopus` |
+| :shell: | `shell` | | |
+
+### Animal Bug
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :snail: | `snail` | :butterfly: | `butterfly` |
+| :bug: | `bug` | :ant: | `ant` |
+| :bee: | `bee` `honeybee` | :beetle: | `beetle` |
+| :spider: | `spider` | :spider_web: | `spider_web` |
+| :scorpion: | `scorpion` | | |
+
+### Plant Flower
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :bouquet: | `bouquet` | :cherry_blossom: | `cherry_blossom` |
+| :white_flower: | `white_flower` | :rosette: | `rosette` |
+| :rose: | `rose` | :wilted_flower: | `wilted_flower` |
+| :hibiscus: | `hibiscus` | :sunflower: | `sunflower` |
+| :blossom: | `blossom` | :tulip: | `tulip` |
+
+### Plant Other
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :seedling: | `seedling` | :evergreen_tree: | `evergreen_tree` |
+| :deciduous_tree: | `deciduous_tree` | :palm_tree: | `palm_tree` |
+| :cactus: | `cactus` | :ear_of_rice: | `ear_of_rice` |
+| :herb: | `herb` | :shamrock: | `shamrock` |
+| :four_leaf_clover: | `four_leaf_clover` | :maple_leaf: | `maple_leaf` |
+| :fallen_leaf: | `fallen_leaf` | :leaves: | `leaves` |
+
+## Food & Drink
+
+### Food Fruit
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :grapes: | `grapes` | :melon: | `melon` |
+| :watermelon: | `watermelon` | :mandarin: | `mandarin` `orange` `tangerine` |
+| :lemon: | `lemon` | :banana: | `banana` |
+| :pineapple: | `pineapple` | :apple: | `apple` |
+| :green_apple: | `green_apple` | :pear: | `pear` |
+| :peach: | `peach` | :cherries: | `cherries` |
+| :strawberry: | `strawberry` | :kiwi_fruit: | `kiwi_fruit` |
+| :tomato: | `tomato` | | |
+
+### Food Vegetable
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :avocado: | `avocado` | :eggplant: | `eggplant` |
+| :potato: | `potato` | :carrot: | `carrot` |
+| :corn: | `corn` | :hot_pepper: | `hot_pepper` |
+| :cucumber: | `cucumber` | :mushroom: | `mushroom` |
+| :peanuts: | `peanuts` | :chestnut: | `chestnut` |
+
+### Food Prepared
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :bread: | `bread` | :croissant: | `croissant` |
+| :baguette_bread: | `baguette_bread` | :pancakes: | `pancakes` |
+| :cheese: | `cheese` | :meat_on_bone: | `meat_on_bone` |
+| :poultry_leg: | `poultry_leg` | :bacon: | `bacon` |
+| :hamburger: | `hamburger` | :fries: | `fries` |
+| :pizza: | `pizza` | :hotdog: | `hotdog` |
+| :taco: | `taco` | :burrito: | `burrito` |
+| :stuffed_flatbread: | `stuffed_flatbread` | :egg: | `egg` |
+| :fried_egg: | `fried_egg` | :shallow_pan_of_food: | `shallow_pan_of_food` |
+| :stew: | `stew` | :green_salad: | `green_salad` |
+| :popcorn: | `popcorn` | | |
+
+### Food Asian
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :bento: | `bento` | :rice_cracker: | `rice_cracker` |
+| :rice_ball: | `rice_ball` | :rice: | `rice` |
+| :curry: | `curry` | :ramen: | `ramen` |
+| :spaghetti: | `spaghetti` | :sweet_potato: | `sweet_potato` |
+| :oden: | `oden` | :sushi: | `sushi` |
+| :fried_shrimp: | `fried_shrimp` | :fish_cake: | `fish_cake` |
+| :dango: | `dango` | | |
+
+### Food Marine
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :crab: | `crab` | :shrimp: | `shrimp` |
+| :squid: | `squid` | | |
+
+### Food Sweet
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :icecream: | `icecream` | :shaved_ice: | `shaved_ice` |
+| :ice_cream: | `ice_cream` | :doughnut: | `doughnut` |
+| :cookie: | `cookie` | :birthday: | `birthday` |
+| :cake: | `cake` | :chocolate_bar: | `chocolate_bar` |
+| :candy: | `candy` | :lollipop: | `lollipop` |
+| :custard: | `custard` | :honey_pot: | `honey_pot` |
+
+### Drink
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :baby_bottle: | `baby_bottle` | :milk_glass: | `milk_glass` |
+| :coffee: | `coffee` | :tea: | `tea` |
+| :sake: | `sake` | :champagne: | `champagne` |
+| :wine_glass: | `wine_glass` | :cocktail: | `cocktail` |
+| :tropical_drink: | `tropical_drink` | :beer: | `beer` |
+| :beers: | `beers` | :clinking_glasses: | `clinking_glasses` |
+| :tumbler_glass: | `tumbler_glass` | | |
+
+### Dishware
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :plate_with_cutlery: | `plate_with_cutlery` | :fork_and_knife: | `fork_and_knife` |
+| :spoon: | `spoon` | :hocho: | `hocho` `knife` |
+| :amphora: | `amphora` | | |
+
+## Travel & Places
+
+### Place Map
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :earth_africa: | `earth_africa` | :earth_americas: | `earth_americas` |
+| :earth_asia: | `earth_asia` | :globe_with_meridians: | `globe_with_meridians` |
+| :world_map: | `world_map` | :japan: | `japan` |
+
+### Place Geographic
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :mountain_snow: | `mountain_snow` | :mountain: | `mountain` |
+| :volcano: | `volcano` | :mount_fuji: | `mount_fuji` |
+| :camping: | `camping` | :beach_umbrella: | `beach_umbrella` |
+| :desert: | `desert` | :desert_island: | `desert_island` |
+| :national_park: | `national_park` | | |
+
+### Place Building
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :stadium: | `stadium` | :classical_building: | `classical_building` |
+| :building_construction: | `building_construction` | :houses: | `houses` |
+| :derelict_house: | `derelict_house` | :house: | `house` |
+| :house_with_garden: | `house_with_garden` | :office: | `office` |
+| :post_office: | `post_office` | :european_post_office: | `european_post_office` |
+| :hospital: | `hospital` | :bank: | `bank` |
+| :hotel: | `hotel` | :love_hotel: | `love_hotel` |
+| :convenience_store: | `convenience_store` | :school: | `school` |
+| :department_store: | `department_store` | :factory: | `factory` |
+| :japanese_castle: | `japanese_castle` | :european_castle: | `european_castle` |
+| :wedding: | `wedding` | :tokyo_tower: | `tokyo_tower` |
+| :statue_of_liberty: | `statue_of_liberty` | | |
+
+### Place Religious
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :church: | `church` | :mosque: | `mosque` |
+| :synagogue: | `synagogue` | :shinto_shrine: | `shinto_shrine` |
+| :kaaba: | `kaaba` | | |
+
+### Place Other
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :fountain: | `fountain` | :tent: | `tent` |
+| :foggy: | `foggy` | :night_with_stars: | `night_with_stars` |
+| :cityscape: | `cityscape` | :sunrise_over_mountains: | `sunrise_over_mountains` |
+| :sunrise: | `sunrise` | :city_sunset: | `city_sunset` |
+| :city_sunrise: | `city_sunrise` | :bridge_at_night: | `bridge_at_night` |
+| :hotsprings: | `hotsprings` | :carousel_horse: | `carousel_horse` |
+| :ferris_wheel: | `ferris_wheel` | :roller_coaster: | `roller_coaster` |
+| :barber: | `barber` | :circus_tent: | `circus_tent` |
+
+### Transport Ground
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :steam_locomotive: | `steam_locomotive` | :railway_car: | `railway_car` |
+| :bullettrain_side: | `bullettrain_side` | :bullettrain_front: | `bullettrain_front` |
+| :train2: | `train2` | :metro: | `metro` |
+| :light_rail: | `light_rail` | :station: | `station` |
+| :tram: | `tram` | :monorail: | `monorail` |
+| :mountain_railway: | `mountain_railway` | :train: | `train` |
+| :bus: | `bus` | :oncoming_bus: | `oncoming_bus` |
+| :trolleybus: | `trolleybus` | :minibus: | `minibus` |
+| :ambulance: | `ambulance` | :fire_engine: | `fire_engine` |
+| :police_car: | `police_car` | :oncoming_police_car: | `oncoming_police_car` |
+| :taxi: | `taxi` | :oncoming_taxi: | `oncoming_taxi` |
+| :car: | `car` `red_car` | :oncoming_automobile: | `oncoming_automobile` |
+| :blue_car: | `blue_car` | :truck: | `truck` |
+| :articulated_lorry: | `articulated_lorry` | :tractor: | `tractor` |
+| :racing_car: | `racing_car` | :motorcycle: | `motorcycle` |
+| :motor_scooter: | `motor_scooter` | :bike: | `bike` |
+| :kick_scooter: | `kick_scooter` | :busstop: | `busstop` |
+| :motorway: | `motorway` | :railway_track: | `railway_track` |
+| :oil_drum: | `oil_drum` | :fuelpump: | `fuelpump` |
+| :rotating_light: | `rotating_light` | :traffic_light: | `traffic_light` |
+| :vertical_traffic_light: | `vertical_traffic_light` | :stop_sign: | `stop_sign` |
+| :construction: | `construction` | | |
+
+### Transport Water
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :anchor: | `anchor` | :boat: | `boat` `sailboat` |
+| :canoe: | `canoe` | :speedboat: | `speedboat` |
+| :passenger_ship: | `passenger_ship` | :ferry: | `ferry` |
+| :motor_boat: | `motor_boat` | :ship: | `ship` |
+
+### Transport Air
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :airplane: | `airplane` | :small_airplane: | `small_airplane` |
+| :flight_departure: | `flight_departure` | :flight_arrival: | `flight_arrival` |
+| :seat: | `seat` | :helicopter: | `helicopter` |
+| :suspension_railway: | `suspension_railway` | :mountain_cableway: | `mountain_cableway` |
+| :aerial_tramway: | `aerial_tramway` | :artificial_satellite: | `artificial_satellite` |
+| :rocket: | `rocket` | | |
+
+### Hotel
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :bellhop_bell: | `bellhop_bell` |
+
+### Time
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :hourglass: | `hourglass` | :hourglass_flowing_sand: | `hourglass_flowing_sand` |
+| :watch: | `watch` | :alarm_clock: | `alarm_clock` |
+| :stopwatch: | `stopwatch` | :timer_clock: | `timer_clock` |
+| :mantelpiece_clock: | `mantelpiece_clock` | :clock12: | `clock12` |
+| :clock1230: | `clock1230` | :clock1: | `clock1` |
+| :clock130: | `clock130` | :clock2: | `clock2` |
+| :clock230: | `clock230` | :clock3: | `clock3` |
+| :clock330: | `clock330` | :clock4: | `clock4` |
+| :clock430: | `clock430` | :clock5: | `clock5` |
+| :clock530: | `clock530` | :clock6: | `clock6` |
+| :clock630: | `clock630` | :clock7: | `clock7` |
+| :clock730: | `clock730` | :clock8: | `clock8` |
+| :clock830: | `clock830` | :clock9: | `clock9` |
+| :clock930: | `clock930` | :clock10: | `clock10` |
+| :clock1030: | `clock1030` | :clock11: | `clock11` |
+| :clock1130: | `clock1130` | | |
+
+### Sky & Weather
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :new_moon: | `new_moon` | :waxing_crescent_moon: | `waxing_crescent_moon` |
+| :first_quarter_moon: | `first_quarter_moon` | :moon: | `moon` `waxing_gibbous_moon` |
+| :full_moon: | `full_moon` | :waning_gibbous_moon: | `waning_gibbous_moon` |
+| :last_quarter_moon: | `last_quarter_moon` | :waning_crescent_moon: | `waning_crescent_moon` |
+| :crescent_moon: | `crescent_moon` | :new_moon_with_face: | `new_moon_with_face` |
+| :first_quarter_moon_with_face: | `first_quarter_moon_with_face` | :last_quarter_moon_with_face: | `last_quarter_moon_with_face` |
+| :thermometer: | `thermometer` | :sunny: | `sunny` |
+| :full_moon_with_face: | `full_moon_with_face` | :sun_with_face: | `sun_with_face` |
+| :star: | `star` | :star2: | `star2` |
+| :stars: | `stars` | :milky_way: | `milky_way` |
+| :cloud: | `cloud` | :partly_sunny: | `partly_sunny` |
+| :cloud_with_lightning_and_rain: | `cloud_with_lightning_and_rain` | :sun_behind_small_cloud: | `sun_behind_small_cloud` |
+| :sun_behind_large_cloud: | `sun_behind_large_cloud` | :sun_behind_rain_cloud: | `sun_behind_rain_cloud` |
+| :cloud_with_rain: | `cloud_with_rain` | :cloud_with_snow: | `cloud_with_snow` |
+| :cloud_with_lightning: | `cloud_with_lightning` | :tornado: | `tornado` |
+| :fog: | `fog` | :wind_face: | `wind_face` |
+| :cyclone: | `cyclone` | :rainbow: | `rainbow` |
+| :closed_umbrella: | `closed_umbrella` | :open_umbrella: | `open_umbrella` |
+| :umbrella: | `umbrella` | :parasol_on_ground: | `parasol_on_ground` |
+| :zap: | `zap` | :snowflake: | `snowflake` |
+| :snowman_with_snow: | `snowman_with_snow` | :snowman: | `snowman` |
+| :comet: | `comet` | :fire: | `fire` |
+| :droplet: | `droplet` | :ocean: | `ocean` |
+
+## Activities
+
+### Event
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :jack_o_lantern: | `jack_o_lantern` | :christmas_tree: | `christmas_tree` |
+| :fireworks: | `fireworks` | :sparkler: | `sparkler` |
+| :sparkles: | `sparkles` | :balloon: | `balloon` |
+| :tada: | `tada` | :confetti_ball: | `confetti_ball` |
+| :tanabata_tree: | `tanabata_tree` | :bamboo: | `bamboo` |
+| :dolls: | `dolls` | :flags: | `flags` |
+| :wind_chime: | `wind_chime` | :rice_scene: | `rice_scene` |
+| :ribbon: | `ribbon` | :gift: | `gift` |
+| :reminder_ribbon: | `reminder_ribbon` | :tickets: | `tickets` |
+| :ticket: | `ticket` | | |
+
+### Award Medal
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :medal_military: | `medal_military` | :trophy: | `trophy` |
+| :medal_sports: | `medal_sports` | :1st_place_medal: | `1st_place_medal` |
+| :2nd_place_medal: | `2nd_place_medal` | :3rd_place_medal: | `3rd_place_medal` |
+
+### Sport
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :soccer: | `soccer` | :baseball: | `baseball` |
+| :basketball: | `basketball` | :volleyball: | `volleyball` |
+| :football: | `football` | :rugby_football: | `rugby_football` |
+| :tennis: | `tennis` | :bowling: | `bowling` |
+| :cricket: | `cricket` | :field_hockey: | `field_hockey` |
+| :ice_hockey: | `ice_hockey` | :ping_pong: | `ping_pong` |
+| :badminton: | `badminton` | :boxing_glove: | `boxing_glove` |
+| :martial_arts_uniform: | `martial_arts_uniform` | :goal_net: | `goal_net` |
+| :golf: | `golf` | :ice_skate: | `ice_skate` |
+| :fishing_pole_and_fish: | `fishing_pole_and_fish` | :running_shirt_with_sash: | `running_shirt_with_sash` |
+| :ski: | `ski` | | |
+
+### Game
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :dart: | `dart` | :8ball: | `8ball` |
+| :crystal_ball: | `crystal_ball` | :video_game: | `video_game` |
+| :joystick: | `joystick` | :slot_machine: | `slot_machine` |
+| :game_die: | `game_die` | :spades: | `spades` |
+| :hearts: | `hearts` | :diamonds: | `diamonds` |
+| :clubs: | `clubs` | :black_joker: | `black_joker` |
+| :mahjong: | `mahjong` | :flower_playing_cards: | `flower_playing_cards` |
+
+### Arts & Crafts
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :performing_arts: | `performing_arts` | :framed_picture: | `framed_picture` |
+| :art: | `art` | | |
+
+## Objects
+
+### Clothing
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :eyeglasses: | `eyeglasses` | :dark_sunglasses: | `dark_sunglasses` |
+| :necktie: | `necktie` | :shirt: | `shirt` `tshirt` |
+| :jeans: | `jeans` | :dress: | `dress` |
+| :kimono: | `kimono` | :bikini: | `bikini` |
+| :womans_clothes: | `womans_clothes` | :purse: | `purse` |
+| :handbag: | `handbag` | :pouch: | `pouch` |
+| :shopping: | `shopping` | :school_satchel: | `school_satchel` |
+| :mans_shoe: | `mans_shoe` `shoe` | :athletic_shoe: | `athletic_shoe` |
+| :high_heel: | `high_heel` | :sandal: | `sandal` |
+| :boot: | `boot` | :crown: | `crown` |
+| :womans_hat: | `womans_hat` | :tophat: | `tophat` |
+| :mortar_board: | `mortar_board` | :rescue_worker_helmet: | `rescue_worker_helmet` |
+| :prayer_beads: | `prayer_beads` | :lipstick: | `lipstick` |
+| :ring: | `ring` | :gem: | `gem` |
+
+### Sound
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :mute: | `mute` | :speaker: | `speaker` |
+| :sound: | `sound` | :loud_sound: | `loud_sound` |
+| :loudspeaker: | `loudspeaker` | :mega: | `mega` |
+| :postal_horn: | `postal_horn` | :bell: | `bell` |
+| :no_bell: | `no_bell` | | |
+
+### Music
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :musical_score: | `musical_score` | :musical_note: | `musical_note` |
+| :notes: | `notes` | :studio_microphone: | `studio_microphone` |
+| :level_slider: | `level_slider` | :control_knobs: | `control_knobs` |
+| :microphone: | `microphone` | :headphones: | `headphones` |
+| :radio: | `radio` | | |
+
+### Musical Instrument
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :saxophone: | `saxophone` | :guitar: | `guitar` |
+| :musical_keyboard: | `musical_keyboard` | :trumpet: | `trumpet` |
+| :violin: | `violin` | :drum: | `drum` |
+
+### Phone
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :iphone: | `iphone` | :calling: | `calling` |
+| :phone: | `phone` `telephone` | :telephone_receiver: | `telephone_receiver` |
+| :pager: | `pager` | :fax: | `fax` |
+
+### Computer
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :battery: | `battery` | :electric_plug: | `electric_plug` |
+| :computer: | `computer` | :desktop_computer: | `desktop_computer` |
+| :printer: | `printer` | :keyboard: | `keyboard` |
+| :computer_mouse: | `computer_mouse` | :trackball: | `trackball` |
+| :minidisc: | `minidisc` | :floppy_disk: | `floppy_disk` |
+| :cd: | `cd` | :dvd: | `dvd` |
+
+### Light & Video
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :movie_camera: | `movie_camera` | :film_strip: | `film_strip` |
+| :film_projector: | `film_projector` | :clapper: | `clapper` |
+| :tv: | `tv` | :camera: | `camera` |
+| :camera_flash: | `camera_flash` | :video_camera: | `video_camera` |
+| :vhs: | `vhs` | :mag: | `mag` |
+| :mag_right: | `mag_right` | :candle: | `candle` |
+| :bulb: | `bulb` | :flashlight: | `flashlight` |
+| :izakaya_lantern: | `izakaya_lantern` `lantern` | | |
+
+### Book Paper
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :notebook_with_decorative_cover: | `notebook_with_decorative_cover` | :closed_book: | `closed_book` |
+| :book: | `book` `open_book` | :green_book: | `green_book` |
+| :blue_book: | `blue_book` | :orange_book: | `orange_book` |
+| :books: | `books` | :notebook: | `notebook` |
+| :ledger: | `ledger` | :page_with_curl: | `page_with_curl` |
+| :scroll: | `scroll` | :page_facing_up: | `page_facing_up` |
+| :newspaper: | `newspaper` | :newspaper_roll: | `newspaper_roll` |
+| :bookmark_tabs: | `bookmark_tabs` | :bookmark: | `bookmark` |
+| :label: | `label` | | |
+
+### Money
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :moneybag: | `moneybag` | :yen: | `yen` |
+| :dollar: | `dollar` | :euro: | `euro` |
+| :pound: | `pound` | :money_with_wings: | `money_with_wings` |
+| :credit_card: | `credit_card` | :chart: | `chart` |
+
+### Mail
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :email: | `email` `envelope` | :e-mail: | `:e-mail:` |
+| :incoming_envelope: | `incoming_envelope` | :envelope_with_arrow: | `envelope_with_arrow` |
+| :outbox_tray: | `outbox_tray` | :inbox_tray: | `inbox_tray` |
+| :package: | `package` | :mailbox: | `mailbox` |
+| :mailbox_closed: | `mailbox_closed` | :mailbox_with_mail: | `mailbox_with_mail` |
+| :mailbox_with_no_mail: | `mailbox_with_no_mail` | :postbox: | `postbox` |
+| :ballot_box: | `ballot_box` | | |
+
+### Writing
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :pencil2: | `pencil2` | :black_nib: | `black_nib` |
+| :fountain_pen: | `fountain_pen` | :pen: | `pen` |
+| :paintbrush: | `paintbrush` | :crayon: | `crayon` |
+| :memo: | `memo` `pencil` | | |
+
+### Office
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :briefcase: | `briefcase` | :file_folder: | `file_folder` |
+| :open_file_folder: | `open_file_folder` | :card_index_dividers: | `card_index_dividers` |
+| :date: | `date` | :calendar: | `calendar` |
+| :spiral_notepad: | `spiral_notepad` | :spiral_calendar: | `spiral_calendar` |
+| :card_index: | `card_index` | :chart_with_upwards_trend: | `chart_with_upwards_trend` |
+| :chart_with_downwards_trend: | `chart_with_downwards_trend` | :bar_chart: | `bar_chart` |
+| :clipboard: | `clipboard` | :pushpin: | `pushpin` |
+| :round_pushpin: | `round_pushpin` | :paperclip: | `paperclip` |
+| :paperclips: | `paperclips` | :straight_ruler: | `straight_ruler` |
+| :triangular_ruler: | `triangular_ruler` | :scissors: | `scissors` |
+| :card_file_box: | `card_file_box` | :file_cabinet: | `file_cabinet` |
+| :wastebasket: | `wastebasket` | | |
+
+### Lock
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :lock: | `lock` | :unlock: | `unlock` |
+| :lock_with_ink_pen: | `lock_with_ink_pen` | :closed_lock_with_key: | `closed_lock_with_key` |
+| :key: | `key` | :old_key: | `old_key` |
+
+### Tool
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :hammer: | `hammer` | :pick: | `pick` |
+| :hammer_and_pick: | `hammer_and_pick` | :hammer_and_wrench: | `hammer_and_wrench` |
+| :dagger: | `dagger` | :crossed_swords: | `crossed_swords` |
+| :gun: | `gun` | :bow_and_arrow: | `bow_and_arrow` |
+| :shield: | `shield` | :wrench: | `wrench` |
+| :nut_and_bolt: | `nut_and_bolt` | :gear: | `gear` |
+| :clamp: | `clamp` | :balance_scale: | `balance_scale` |
+| :link: | `link` | :chains: | `chains` |
+
+### Science
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :alembic: | `alembic` | :microscope: | `microscope` |
+| :telescope: | `telescope` | :satellite: | `satellite` |
+
+### Medical
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :syringe: | `syringe` | :pill: | `pill` |
+
+### Household
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :door: | `door` | :bed: | `bed` |
+| :couch_and_lamp: | `couch_and_lamp` | :toilet: | `toilet` |
+| :shower: | `shower` | :bathtub: | `bathtub` |
+| :shopping_cart: | `shopping_cart` | | |
+
+### Other Object
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :smoking: | `smoking` | :coffin: | `coffin` |
+| :funeral_urn: | `funeral_urn` | :moyai: | `moyai` |
+
+## Symbols
+
+### Transport Sign
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :atm: | `atm` | :put_litter_in_its_place: | `put_litter_in_its_place` |
+| :potable_water: | `potable_water` | :wheelchair: | `wheelchair` |
+| :mens: | `mens` | :womens: | `womens` |
+| :restroom: | `restroom` | :baby_symbol: | `baby_symbol` |
+| :wc: | `wc` | :passport_control: | `passport_control` |
+| :customs: | `customs` | :baggage_claim: | `baggage_claim` |
+| :left_luggage: | `left_luggage` | | |
+
+### Warning
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :warning: | `warning` | :children_crossing: | `children_crossing` |
+| :no_entry: | `no_entry` | :no_entry_sign: | `no_entry_sign` |
+| :no_bicycles: | `no_bicycles` | :no_smoking: | `no_smoking` |
+| :do_not_litter: | `do_not_litter` | :non-potable_water: | `:non-potable_water:` |
+| :no_pedestrians: | `no_pedestrians` | :no_mobile_phones: | `no_mobile_phones` |
+| :underage: | `underage` | :radioactive: | `radioactive` |
+| :biohazard: | `biohazard` | | |
+
+### Arrow
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :arrow_up: | `arrow_up` | :arrow_upper_right: | `arrow_upper_right` |
+| :arrow_right: | `arrow_right` | :arrow_lower_right: | `arrow_lower_right` |
+| :arrow_down: | `arrow_down` | :arrow_lower_left: | `arrow_lower_left` |
+| :arrow_left: | `arrow_left` | :arrow_upper_left: | `arrow_upper_left` |
+| :arrow_up_down: | `arrow_up_down` | :left_right_arrow: | `left_right_arrow` |
+| :leftwards_arrow_with_hook: | `leftwards_arrow_with_hook` | :arrow_right_hook: | `arrow_right_hook` |
+| :arrow_heading_up: | `arrow_heading_up` | :arrow_heading_down: | `arrow_heading_down` |
+| :arrows_clockwise: | `arrows_clockwise` | :arrows_counterclockwise: | `arrows_counterclockwise` |
+| :back: | `back` | :end: | `end` |
+| :on: | `on` | :soon: | `soon` |
+| :top: | `top` | | |
+
+### Religion
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :place_of_worship: | `place_of_worship` | :atom_symbol: | `atom_symbol` |
+| :om: | `om` | :star_of_david: | `star_of_david` |
+| :wheel_of_dharma: | `wheel_of_dharma` | :yin_yang: | `yin_yang` |
+| :latin_cross: | `latin_cross` | :orthodox_cross: | `orthodox_cross` |
+| :star_and_crescent: | `star_and_crescent` | :peace_symbol: | `peace_symbol` |
+| :menorah: | `menorah` | :six_pointed_star: | `six_pointed_star` |
+
+### Zodiac
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :aries: | `aries` | :taurus: | `taurus` |
+| :gemini: | `gemini` | :cancer: | `cancer` |
+| :leo: | `leo` | :virgo: | `virgo` |
+| :libra: | `libra` | :scorpius: | `scorpius` |
+| :sagittarius: | `sagittarius` | :capricorn: | `capricorn` |
+| :aquarius: | `aquarius` | :pisces: | `pisces` |
+| :ophiuchus: | `ophiuchus` | | |
+
+### Av Symbol
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :twisted_rightwards_arrows: | `twisted_rightwards_arrows` | :repeat: | `repeat` |
+| :repeat_one: | `repeat_one` | :arrow_forward: | `arrow_forward` |
+| :fast_forward: | `fast_forward` | :next_track_button: | `next_track_button` |
+| :play_or_pause_button: | `play_or_pause_button` | :arrow_backward: | `arrow_backward` |
+| :rewind: | `rewind` | :previous_track_button: | `previous_track_button` |
+| :arrow_up_small: | `arrow_up_small` | :arrow_double_up: | `arrow_double_up` |
+| :arrow_down_small: | `arrow_down_small` | :arrow_double_down: | `arrow_double_down` |
+| :pause_button: | `pause_button` | :stop_button: | `stop_button` |
+| :record_button: | `record_button` | :cinema: | `cinema` |
+| :low_brightness: | `low_brightness` | :high_brightness: | `high_brightness` |
+| :signal_strength: | `signal_strength` | :vibration_mode: | `vibration_mode` |
+| :mobile_phone_off: | `mobile_phone_off` | | |
+
+### Math
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :heavy_multiplication_x: | `heavy_multiplication_x` | :heavy_plus_sign: | `heavy_plus_sign` |
+| :heavy_minus_sign: | `heavy_minus_sign` | :heavy_division_sign: | `heavy_division_sign` |
+
+### Punctuation
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :bangbang: | `bangbang` | :interrobang: | `interrobang` |
+| :question: | `question` | :grey_question: | `grey_question` |
+| :grey_exclamation: | `grey_exclamation` | :exclamation: | `exclamation` `heavy_exclamation_mark` |
+| :wavy_dash: | `wavy_dash` | | |
+
+### Currency
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :currency_exchange: | `currency_exchange` | :heavy_dollar_sign: | `heavy_dollar_sign` |
+
+### Keycap
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :hash: | `hash` | :asterisk: | `asterisk` |
+| :zero: | `zero` | :one: | `one` |
+| :two: | `two` | :three: | `three` |
+| :four: | `four` | :five: | `five` |
+| :six: | `six` | :seven: | `seven` |
+| :eight: | `eight` | :nine: | `nine` |
+| :keycap_ten: | `keycap_ten` | | |
+
+### Alphabet
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :capital_abcd: | `capital_abcd` | :abcd: | `abcd` |
+| :1234: | `1234` | :symbols: | `symbols` |
+| :abc: | `abc` | :a: | `a` |
+| :ab: | `ab` | :b: | `b` |
+| :cl: | `cl` | :cool: | `cool` |
+| :free: | `free` | :information_source: | `information_source` |
+| :id: | `id` | :m: | `m` |
+| :new: | `new` | :ng: | `ng` |
+| :o2: | `o2` | :ok: | `ok` |
+| :parking: | `parking` | :sos: | `sos` |
+| :up: | `up` | :vs: | `vs` |
+| :koko: | `koko` | :sa: | `sa` |
+| :u6708: | `u6708` | :u6709: | `u6709` |
+| :u6307: | `u6307` | :ideograph_advantage: | `ideograph_advantage` |
+| :u5272: | `u5272` | :u7121: | `u7121` |
+| :u7981: | `u7981` | :accept: | `accept` |
+| :u7533: | `u7533` | :u5408: | `u5408` |
+| :u7a7a: | `u7a7a` | :congratulations: | `congratulations` |
+| :secret: | `secret` | :u55b6: | `u55b6` |
+| :u6e80: | `u6e80` | | |
+
+### Geometric
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :red_circle: | `red_circle` | :large_blue_circle: | `large_blue_circle` |
+| :black_circle: | `black_circle` | :white_circle: | `white_circle` |
+| :black_large_square: | `black_large_square` | :white_large_square: | `white_large_square` |
+| :black_medium_square: | `black_medium_square` | :white_medium_square: | `white_medium_square` |
+| :black_medium_small_square: | `black_medium_small_square` | :white_medium_small_square: | `white_medium_small_square` |
+| :black_small_square: | `black_small_square` | :white_small_square: | `white_small_square` |
+| :large_orange_diamond: | `large_orange_diamond` | :large_blue_diamond: | `large_blue_diamond` |
+| :small_orange_diamond: | `small_orange_diamond` | :small_blue_diamond: | `small_blue_diamond` |
+| :small_red_triangle: | `small_red_triangle` | :small_red_triangle_down: | `small_red_triangle_down` |
+| :diamond_shape_with_a_dot_inside: | `diamond_shape_with_a_dot_inside` | :radio_button: | `radio_button` |
+| :white_square_button: | `white_square_button` | :black_square_button: | `black_square_button` |
+
+### Other Symbol
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :recycle: | `recycle` | :fleur_de_lis: | `fleur_de_lis` |
+| :trident: | `trident` | :name_badge: | `name_badge` |
+| :beginner: | `beginner` | :o: | `o` |
+| :white_check_mark: | `white_check_mark` | :ballot_box_with_check: | `ballot_box_with_check` |
+| :heavy_check_mark: | `heavy_check_mark` | :x: | `x` |
+| :negative_squared_cross_mark: | `negative_squared_cross_mark` | :curly_loop: | `curly_loop` |
+| :loop: | `loop` | :part_alternation_mark: | `part_alternation_mark` |
+| :eight_spoked_asterisk: | `eight_spoked_asterisk` | :eight_pointed_black_star: | `eight_pointed_black_star` |
+| :sparkle: | `sparkle` | :copyright: | `copyright` |
+| :registered: | `registered` | :tm: | `tm` |
+
+## Flags
+
+### Common Flags
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :checkered_flag: | `checkered_flag` | :triangular_flag_on_post: | `triangular_flag_on_post` |
+| :crossed_flags: | `crossed_flags` | :black_flag: | `black_flag` |
+| :white_flag: | `white_flag` | :rainbow_flag: | `rainbow_flag` |
+
+### Country and Region Flags
+
+| icon | code | icon | code |
+| :-: | - | :-: | - |
+| :andorra: | `andorra` | :united_arab_emirates: | `united_arab_emirates` |
+| :afghanistan: | `afghanistan` | :antigua_barbuda: | `antigua_barbuda` |
+| :anguilla: | `anguilla` | :albania: | `albania` |
+| :armenia: | `armenia` | :angola: | `angola` |
+| :antarctica: | `antarctica` | :argentina: | `argentina` |
+| :american_samoa: | `american_samoa` | :austria: | `austria` |
+| :australia: | `australia` | :aruba: | `aruba` |
+| :aland_islands: | `aland_islands` | :azerbaijan: | `azerbaijan` |
+| :bosnia_herzegovina: | `bosnia_herzegovina` | :barbados: | `barbados` |
+| :bangladesh: | `bangladesh` | :belgium: | `belgium` |
+| :burkina_faso: | `burkina_faso` | :bulgaria: | `bulgaria` |
+| :bahrain: | `bahrain` | :burundi: | `burundi` |
+| :benin: | `benin` | :st_barthelemy: | `st_barthelemy` |
+| :bermuda: | `bermuda` | :brunei: | `brunei` |
+| :bolivia: | `bolivia` | :caribbean_netherlands: | `caribbean_netherlands` |
+| :brazil: | `brazil` | :bahamas: | `bahamas` |
+| :bhutan: | `bhutan` | :botswana: | `botswana` |
+| :belarus: | `belarus` | :belize: | `belize` |
+| :canada: | `canada` | :cocos_islands: | `cocos_islands` |
+| :congo_kinshasa: | `congo_kinshasa` | :central_african_republic: | `central_african_republic` |
+| :congo_brazzaville: | `congo_brazzaville` | :switzerland: | `switzerland` |
+| :cote_divoire: | `cote_divoire` | :cook_islands: | `cook_islands` |
+| :chile: | `chile` | :cameroon: | `cameroon` |
+| :cn: | `cn` | :colombia: | `colombia` |
+| :costa_rica: | `costa_rica` | :cuba: | `cuba` |
+| :cape_verde: | `cape_verde` | :curacao: | `curacao` |
+| :christmas_island: | `christmas_island` | :cyprus: | `cyprus` |
+| :czech_republic: | `czech_republic` | :de: | `de` |
+| :djibouti: | `djibouti` | :denmark: | `denmark` |
+| :dominica: | `dominica` | :dominican_republic: | `dominican_republic` |
+| :algeria: | `algeria` | :ecuador: | `ecuador` |
+| :estonia: | `estonia` | :egypt: | `egypt` |
+| :western_sahara: | `western_sahara` | :eritrea: | `eritrea` |
+| :es: | `es` | :ethiopia: | `ethiopia` |
+| :eu: | `eu` `european_union` | :finland: | `finland` |
+| :fiji: | `fiji` | :falkland_islands: | `falkland_islands` |
+| :micronesia: | `micronesia` | :faroe_islands: | `faroe_islands` |
+| :fr: | `fr` | :gabon: | `gabon` |
+| :gb: | `gb` `uk` | :grenada: | `grenada` |
+| :georgia: | `georgia` | :french_guiana: | `french_guiana` |
+| :guernsey: | `guernsey` | :ghana: | `ghana` |
+| :gibraltar: | `gibraltar` | :greenland: | `greenland` |
+| :gambia: | `gambia` | :guinea: | `guinea` |
+| :guadeloupe: | `guadeloupe` | :equatorial_guinea: | `equatorial_guinea` |
+| :greece: | `greece` | :south_georgia_south_sandwich_islands: | `south_georgia_south_sandwich_islands` |
+| :guatemala: | `guatemala` | :guam: | `guam` |
+| :guinea_bissau: | `guinea_bissau` | :guyana: | `guyana` |
+| :hong_kong: | `hong_kong` | :honduras: | `honduras` |
+| :croatia: | `croatia` | :haiti: | `haiti` |
+| :hungary: | `hungary` | :canary_islands: | `canary_islands` |
+| :indonesia: | `indonesia` | :ireland: | `ireland` |
+| :israel: | `israel` | :isle_of_man: | `isle_of_man` |
+| :india: | `india` | :british_indian_ocean_territory: | `british_indian_ocean_territory` |
+| :iraq: | `iraq` | :iran: | `iran` |
+| :iceland: | `iceland` | :it: | `it` |
+| :jersey: | `jersey` | :jamaica: | `jamaica` |
+| :jordan: | `jordan` | :jp: | `jp` |
+| :kenya: | `kenya` | :kyrgyzstan: | `kyrgyzstan` |
+| :cambodia: | `cambodia` | :kiribati: | `kiribati` |
+| :comoros: | `comoros` | :st_kitts_nevis: | `st_kitts_nevis` |
+| :north_korea: | `north_korea` | :kr: | `kr` |
+| :kuwait: | `kuwait` | :cayman_islands: | `cayman_islands` |
+| :kazakhstan: | `kazakhstan` | :laos: | `laos` |
+| :lebanon: | `lebanon` | :st_lucia: | `st_lucia` |
+| :liechtenstein: | `liechtenstein` | :sri_lanka: | `sri_lanka` |
+| :liberia: | `liberia` | :lesotho: | `lesotho` |
+| :lithuania: | `lithuania` | :luxembourg: | `luxembourg` |
+| :latvia: | `latvia` | :libya: | `libya` |
+| :morocco: | `morocco` | :monaco: | `monaco` |
+| :moldova: | `moldova` | :montenegro: | `montenegro` |
+| :madagascar: | `madagascar` | :marshall_islands: | `marshall_islands` |
+| :macedonia: | `macedonia` | :mali: | `mali` |
+| :myanmar: | `myanmar` | :mongolia: | `mongolia` |
+| :macau: | `macau` | :northern_mariana_islands: | `northern_mariana_islands` |
+| :martinique: | `martinique` | :mauritania: | `mauritania` |
+| :montserrat: | `montserrat` | :malta: | `malta` |
+| :mauritius: | `mauritius` | :maldives: | `maldives` |
+| :malawi: | `malawi` | :mexico: | `mexico` |
+| :malaysia: | `malaysia` | :mozambique: | `mozambique` |
+| :namibia: | `namibia` | :new_caledonia: | `new_caledonia` |
+| :niger: | `niger` | :norfolk_island: | `norfolk_island` |
+| :nigeria: | `nigeria` | :nicaragua: | `nicaragua` |
+| :netherlands: | `netherlands` | :norway: | `norway` |
+| :nepal: | `nepal` | :nauru: | `nauru` |
+| :niue: | `niue` | :new_zealand: | `new_zealand` |
+| :oman: | `oman` | :panama: | `panama` |
+| :peru: | `peru` | :french_polynesia: | `french_polynesia` |
+| :papua_new_guinea: | `papua_new_guinea` | :philippines: | `philippines` |
+| :pakistan: | `pakistan` | :poland: | `poland` |
+| :st_pierre_miquelon: | `st_pierre_miquelon` | :pitcairn_islands: | `pitcairn_islands` |
+| :puerto_rico: | `puerto_rico` | :palestinian_territories: | `palestinian_territories` |
+| :portugal: | `portugal` | :palau: | `palau` |
+| :paraguay: | `paraguay` | :qatar: | `qatar` |
+| :reunion: | `reunion` | :romania: | `romania` |
+| :serbia: | `serbia` | :ru: | `ru` |
+| :rwanda: | `rwanda` | :saudi_arabia: | `saudi_arabia` |
+| :solomon_islands: | `solomon_islands` | :seychelles: | `seychelles` |
+| :sudan: | `sudan` | :sweden: | `sweden` |
+| :singapore: | `singapore` | :st_helena: | `st_helena` |
+| :slovenia: | `slovenia` | :slovakia: | `slovakia` |
+| :sierra_leone: | `sierra_leone` | :san_marino: | `san_marino` |
+| :senegal: | `senegal` | :somalia: | `somalia` |
+| :suriname: | `suriname` | :south_sudan: | `south_sudan` |
+| :sao_tome_principe: | `sao_tome_principe` | :el_salvador: | `el_salvador` |
+| :sint_maarten: | `sint_maarten` | :syria: | `syria` |
+| :swaziland: | `swaziland` | :turks_caicos_islands: | `turks_caicos_islands` |
+| :chad: | `chad` | :french_southern_territories: | `french_southern_territories` |
+| :togo: | `togo` | :thailand: | `thailand` |
+| :tajikistan: | `tajikistan` | :tokelau: | `tokelau` |
+| :timor_leste: | `timor_leste` | :turkmenistan: | `turkmenistan` |
+| :tunisia: | `tunisia` | :tonga: | `tonga` |
+| :tr: | `tr` | :trinidad_tobago: | `trinidad_tobago` |
+| :tuvalu: | `tuvalu` | :taiwan: | `taiwan` |
+| :tanzania: | `tanzania` | :ukraine: | `ukraine` |
+| :uganda: | `uganda` | :us: | `us` |
+| :uruguay: | `uruguay` | :uzbekistan: | `uzbekistan` |
+| :vatican_city: | `vatican_city` | :st_vincent_grenadines: | `st_vincent_grenadines` |
+| :venezuela: | `venezuela` | :british_virgin_islands: | `british_virgin_islands` |
+| :us_virgin_islands: | `us_virgin_islands` | :vietnam: | `vietnam` |
+| :vanuatu: | `vanuatu` | :wallis_futuna: | `wallis_futuna` |
+| :samoa: | `samoa` | :kosovo: | `kosovo` |
+| :yemen: | `yemen` | :mayotte: | `mayotte` |
+| :south_africa: | `south_africa` | :zambia: | `zambia` |
+| :zimbabwe: | `zimbabwe` | | |
diff --git a/content/posts/theme-documentation-basics/basic-configuration-preview.png b/content/posts/theme-documentation-basics/basic-configuration-preview.png
new file mode 100644
index 00000000..00a4e65e
Binary files /dev/null and b/content/posts/theme-documentation-basics/basic-configuration-preview.png differ
diff --git a/content/posts/theme-documentation-basics/basic-configuration-preview.zh-cn.png b/content/posts/theme-documentation-basics/basic-configuration-preview.zh-cn.png
new file mode 100644
index 00000000..1b1d2938
Binary files /dev/null and b/content/posts/theme-documentation-basics/basic-configuration-preview.zh-cn.png differ
diff --git a/content/posts/theme-documentation-basics/complete-configuration-preview.png b/content/posts/theme-documentation-basics/complete-configuration-preview.png
new file mode 100644
index 00000000..27726741
Binary files /dev/null and b/content/posts/theme-documentation-basics/complete-configuration-preview.png differ
diff --git a/content/posts/theme-documentation-basics/complete-configuration-preview.zh-cn.png b/content/posts/theme-documentation-basics/complete-configuration-preview.zh-cn.png
new file mode 100644
index 00000000..7990929e
Binary files /dev/null and b/content/posts/theme-documentation-basics/complete-configuration-preview.zh-cn.png differ
diff --git a/content/posts/theme-documentation-basics/featured-image.jpg b/content/posts/theme-documentation-basics/featured-image.jpg
new file mode 100644
index 00000000..87f5401b
Binary files /dev/null and b/content/posts/theme-documentation-basics/featured-image.jpg differ
diff --git a/content/posts/theme-documentation-basics/index.en.md b/content/posts/theme-documentation-basics/index.en.md
new file mode 100644
index 00000000..addc9e03
--- /dev/null
+++ b/content/posts/theme-documentation-basics/index.en.md
@@ -0,0 +1,1035 @@
+---
+weight: 1
+title: "Theme Documentation - Basics"
+date: 2020-03-06T21:29:01+08:00
+lastmod: 2020-03-06T21:29:01+08:00
+draft: false
+author: "Dillon"
+authorLink: "https://dillonzq.com"
+description: "Discover what the Hugo - KeepIt theme is all about and the core-concepts behind it."
+images: []
+resources:
+- name: "featured-image"
+ src: "featured-image.jpg"
+
+tags: ["installation", "configuration"]
+categories: ["documentation"]
+
+lightgallery: true
+
+toc:
+ auto: false
+---
+
+Discover what the Hugo - **KeepIt** theme is all about and the core-concepts behind it.
+
+
+
+## 1 Requirements
+
+Thanks to the simplicity of Hugo, [Hugo](https://gohugo.io/) is the only dependency of this theme.
+
+Just install latest version of [:(far fa-file-archive fa-fw): Hugo (> 0.62.0)](https://gohugo.io/getting-started/installing/) for your OS (**Windows**, **Linux**, **macOS**).
+
+{{< admonition note "Why not support earlier versions of Hugo?" >}}
+Since [Markdown Render Hooks](https://gohugo.io/getting-started/configuration-markup#markdown-render-hooks) was introduced in the [Hugo Christmas Edition](https://gohugo.io/news/0.62.0-relnotes/), this theme only supports Hugo versions above **0.62.0**.
+{{< /admonition >}}
+
+{{< admonition tip "Hugo extended version is recommended" >}}
+Since some features of this theme need to processes :(fab fa-sass fa-fw): SCSS to :(fab fa-css3 fa-fw): CSS, it is recommended to use Hugo **extended** version for better experience.
+{{< /admonition >}}
+
+## 2 Installation
+
+The following steps are here to help you initialize your new website. If you don’t know Hugo at all, we strongly suggest you learn more about it by following this [great documentation for beginners](https://gohugo.io/getting-started/quick-start/).
+
+### 2.1 Create Your Project
+
+Hugo provides a `new` command to create a new website:
+
+```bash
+hugo new site my_website
+cd my_website
+```
+
+### 2.2 Install the Theme
+
+The **KeepIt** theme’s repository is: [https://github.com/Fastbyte01/KeepIt](https://github.com/Fastbyte01/KeepIt).
+
+You can download the [latest release :(far fa-file-archive fa-fw): .zip file](https://github.com/Fastbyte01/KeepIt/releases) of the theme and extract it in the `themes` directory.
+
+Alternatively, clone this repository to the `themes` directory:
+
+```bash
+git clone https://github.com/Fastbyte01/KeepIt.git themes/KeepIt
+```
+
+Or, create an empty git repository and make this repository a submodule of your site directory:
+
+```bash
+git init
+git submodule add https://github.com/Fastbyte01/KeepIt.git themes/KeepIt
+```
+
+### 2.3 Basic Configuration {#basic-configuration}
+
+The following is a basic configuration for the KeepIt theme:
+
+```toml
+baseURL = "http://example.org/"
+
+# Change the default theme to be use when building the site with Hugo
+theme = "KeepIt"
+
+# website title
+title = "My New Hugo Site"
+
+# language code ["en", "zh-CN", "fr", "pl", ...]
+languageCode = "en"
+# language name ["English", "简体中文", "Français", "Polski", ...]
+languageName = "English"
+
+# Author config
+[author]
+ name = "xxxx"
+ email = ""
+ link = ""
+
+# Menu config
+[menu]
+ [[menu.main]]
+ weight = 1
+ identifier = "posts"
+ # you can add extra information before the name (HTML format is supported), such as icons
+ pre = ""
+ # you can add extra information after the name (HTML format is supported), such as icons
+ post = ""
+ name = "Posts"
+ url = "/posts/"
+ # title will be shown when you hover on this menu link
+ title = ""
+ [[menu.main]]
+ weight = 2
+ identifier = "tags"
+ pre = ""
+ post = ""
+ name = "Tags"
+ url = "/tags/"
+ title = ""
+ [[menu.main]]
+ weight = 3
+ identifier = "categories"
+ pre = ""
+ post = ""
+ name = "Categories"
+ url = "/categories/"
+ title = ""
+
+# Markup related configuration in Hugo
+[markup]
+ # Syntax Highlighting (https://gohugo.io/content-management/syntax-highlighting)
+ [markup.highlight]
+ # false is a necessary configuration (https://github.com/Fastbyte01/KeepIt/issues/158)
+ noClasses = false
+```
+
+{{< admonition >}}
+When building the website, you can set a theme by using `--theme` option. However, we suggest you modify the configuration file (**config.toml**) and set the theme as the default.
+{{< /admonition >}}
+
+### 2.4 Create Your First Post
+
+Here is the way to create your first post:
+
+```bash
+hugo new posts/first_post.md
+```
+
+Feel free to edit the post file by adding some sample content and replacing the title value in the beginning of the file.
+
+{{< admonition >}}
+By default all posts and pages are created as a draft. If you want to render these pages, remove the property `draft: true` from the metadata, set the property `draft: false` or add `-D`/`--buildDrafts` parameter to `hugo` command.
+{{< /admonition >}}
+
+### 2.5 Launching the Website Locally
+
+Launch by using the following command:
+
+```bash
+hugo serve
+```
+
+Go to `http://localhost:1313`.
+
+
+
+{{< admonition tip >}}
+When you run `hugo serve`, when the contents of the files change, the page automatically refreshes with the changes.
+{{< /admonition >}}
+
+{{< admonition >}}
+Since the theme use `.Scratch` in Hugo to implement some features,
+it is highly recommended that you add `--disableFastRender` parameter to `hugo server` command for the live preview of the page you are editing.
+
+```bash
+hugo serve --disableFastRender
+```
+{{< /admonition >}}
+
+### 2.6 Build the Website
+
+When your site is ready to deploy, run the following command:
+
+```bash
+hugo
+```
+
+A `public` folder will be generated, containing all static content and assets for your website. It can now be deployed on any web server.
+
+{{< admonition tip >}}
+The website can be automatically published and hosted with [Netlify](https://www.netlify.com/) (Read more about [Automated HUGO deployments with Netlify](https://www.netlify.com/blog/2015/07/30/hosting-hugo-on-netlifyinsanely-fast-deploys/)).
+Alternatively, you can use [AWS Amplify](https://gohugo.io/hosting-and-deployment/hosting-on-aws-amplify/), [Github pages](https://gohugo.io/hosting-and-deployment/hosting-on-github/), [Render](https://gohugo.io/hosting-and-deployment/hosting-on-render/) and more...
+{{< /admonition >}}
+
+## 3 Configuration
+
+### 3.1 Site Configuration {#site-configuration}
+
+In addition to [Hugo global configuration](https://gohugo.io/overview/configuration/) and [menu configuration](#basic-configuration), **KeepIt** lets you define the following parameters in your site configuration (here is a `config.toml`, whose values are default).
+
+Please open the code block below to view the complete sample configuration :(far fa-hand-point-down fa-fw)::
+
+```toml
+[params]
+ # site default theme ["auto", "light", "dark"]
+ defaultTheme = "auto"
+ # public git repo url only then enableGitInfo is true
+ gitRepo = ""
+ # {{< version 0.1.1 >}} which hash function used for SRI, when empty, no SRI is used
+ # ["sha256", "sha384", "sha512", "md5"]
+ fingerprint = ""
+ # {{< version 0.2.0 >}} date format
+ dateFormat = "2006-01-02"
+ # website title for Open Graph and Twitter Cards
+ title = "My cool site"
+ # website description for RSS, SEO, Open Graph and Twitter Cards
+ description = "This is my cool site"
+ # website images for Open Graph and Twitter Cards
+ images = ["/logo.png"]
+
+ # Header config
+ [params.header]
+ # desktop header mode ["fixed", "normal", "auto"]
+ desktopMode = "fixed"
+ # mobile header mode ["fixed", "normal", "auto"]
+ mobileMode = "auto"
+ # {{< version 0.2.0 >}} Header title config
+ [params.header.title]
+ # URL of the LOGO
+ logo = ""
+ # title name
+ name = ""
+ # you can add extra information before the name (HTML format is supported), such as icons
+ pre = ""
+ # you can add extra information after the name (HTML format is supported), such as icons
+ post = ""
+ # {{< version 0.2.5 >}} whether to use typeit animation for title name
+ typeit = false
+
+ # Footer config
+ [params.footer]
+ enable = true
+ # {{< version 0.2.0 >}} Custom content (HTML format is supported)
+ custom = ''
+ # {{< version 0.2.0 >}} whether to show Hugo and theme info
+ hugo = true
+ # {{< version 0.2.0 >}} whether to show copyright info
+ copyright = true
+ # {{< version 0.2.0 >}} whether to show the author
+ author = true
+ # Site creation time
+ since = 2019
+ # ICP info only in China (HTML format is supported)
+ icp = ""
+ # license info (HTML format is supported)
+ license = 'CC BY-NC 4.0'
+
+ # {{< version 0.2.0 >}} Section (all posts) page config
+ [params.section]
+ # special amount of posts in each section page
+ paginate = 20
+ # date format (month and day)
+ dateFormat = "01-02"
+ # amount of RSS pages
+ rss = 10
+
+ # {{< version 0.2.0 >}} List (category or tag) page config
+ [params.list]
+ # special amount of posts in each list page
+ paginate = 20
+ # date format (month and day)
+ dateFormat = "01-02"
+ # amount of RSS pages
+ rss = 10
+
+ # {{< version 0.2.0 >}} App icon config
+ [params.app]
+ # optional site title override for the app when added to an iOS home screen or Android launcher
+ title = "My cool site"
+ # whether to omit favicon resource links
+ noFavicon = false
+ # modern SVG favicon to use in place of older style .png and .ico files
+ svgFavicon = ""
+ # Android browser theme color
+ themeColor = "#ffffff"
+ # Safari mask icon color
+ iconColor = "#5bbad5"
+ # Windows v8-10 tile color
+ tileColor = "#da532c"
+
+ # {{< version 0.2.0 >}} Search config
+ [params.search]
+ enable = true
+ # type of search engine ["lunr", "algolia"]
+ type = "lunr"
+ # max index length of the chunked content
+ contentLength = 4000
+ # placeholder of the search bar
+ placeholder = ""
+ # {{< version 0.2.1 >}} max number of results length
+ maxResultLength = 10
+ # {{< version 0.2.3 >}} snippet length of the result
+ snippetLength = 30
+ # {{< version 0.2.1 >}} HTML tag name of the highlight part in results
+ highlightTag = "em"
+ # {{< version 0.2.4 >}} whether to use the absolute URL based on the baseURL in search index
+ absoluteURL = false
+ [params.search.algolia]
+ index = ""
+ appID = ""
+ searchKey = ""
+
+ # Home page config
+ [params.home]
+ # {{< version 0.2.0 >}} amount of RSS pages
+ rss = 10
+ # Home page profile
+ [params.home.profile]
+ enable = true
+ # Gravatar Email for preferred avatar in home page
+ gravatarEmail = ""
+ # URL of avatar shown in home page
+ avatarURL = "/images/avatar.png"
+ # {{< version 0.2.7 changed >}} title shown in home page (HTML format is supported)
+ title = ""
+ # subtitle shown in home page
+ subtitle = "This is My New Hugo Site"
+ # whether to use typeit animation for subtitle
+ typeit = true
+ # whether to show social links
+ social = true
+ # {{< version 0.2.0 >}} disclaimer (HTML format is supported)
+ disclaimer = ""
+ # Home page posts
+ [params.home.posts]
+ enable = true
+ # special amount of posts in each home posts page
+ paginate = 6
+ # {{< version 0.2.0 deleted >}} replaced with hiddenFromHomePage in params.page
+ # default behavior when you don't set "hiddenFromHomePage" in front matter
+ defaultHiddenFromHomePage = false
+
+ # Social config about the author
+ [params.social]
+ GitHub = "xxxx"
+ Linkedin = ""
+ Twitter = "xxxx"
+ Instagram = "xxxx"
+ Facebook = "xxxx"
+ Telegram = "xxxx"
+ Medium = ""
+ Gitlab = ""
+ Youtubelegacy = ""
+ Youtubecustom = ""
+ Youtubechannel = ""
+ Tumblr = ""
+ Quora = ""
+ Keybase = ""
+ Pinterest = ""
+ Reddit = ""
+ Codepen = ""
+ FreeCodeCamp = ""
+ Bitbucket = ""
+ Stackoverflow = ""
+ Weibo = ""
+ Odnoklassniki = ""
+ VK = ""
+ Flickr = ""
+ Xing = ""
+ Snapchat = ""
+ Soundcloud = ""
+ Spotify = ""
+ Bandcamp = ""
+ Paypal = ""
+ Fivehundredpx = ""
+ Mix = ""
+ Goodreads = ""
+ Lastfm = ""
+ Foursquare = ""
+ Hackernews = ""
+ Kickstarter = ""
+ Patreon = ""
+ Steam = ""
+ Twitch = ""
+ Strava = ""
+ Skype = ""
+ Whatsapp = ""
+ Zhihu = ""
+ Douban = ""
+ Angellist = ""
+ Slidershare = ""
+ Jsfiddle = ""
+ Deviantart = ""
+ Behance = ""
+ Dribbble = ""
+ Wordpress = ""
+ Vine = ""
+ Googlescholar = ""
+ Researchgate = ""
+ Mastodon = ""
+ Thingiverse = ""
+ Devto = ""
+ Gitea = ""
+ XMPP = ""
+ Matrix = ""
+ Bilibili = ""
+ Email = "xxxx@xxxx.com"
+ RSS = true # {{< version 0.2.0 >}}
+
+ # {{< version 0.2.0 changed >}} Page global config
+ [params.page]
+ # {{< version 0.2.0 >}} whether to hide a page from home page
+ hiddenFromHomePage = false
+ # {{< version 0.2.0 >}} whether to hide a page from search results
+ hiddenFromSearch = false
+ # {{< version 0.2.0 >}} whether to enable twemoji
+ twemoji = false
+ # whether to enable lightgallery
+ lightgallery = false
+ # {{< version 0.2.0 >}} whether to enable the ruby extended syntax
+ ruby = true
+ # {{< version 0.2.0 >}} whether to enable the fraction extended syntax
+ fraction = true
+ # {{< version 0.2.0 >}} whether to enable the fontawesome extended syntax
+ fontawesome = true
+ # whether to show link to Raw Markdown content of the content
+ linkToMarkdown = true
+ # {{< version 0.2.4 >}} whether to show the full text content in RSS
+ rssFullText = false
+ # {{< version 0.2.0 >}} Table of the contents config
+ [params.page.toc]
+ # whether to enable the table of the contents
+ enable = true
+ # {{< version 0.2.9 >}} whether to keep the static table of the contents in front of the post
+ keepStatic = true
+ # whether to make the table of the contents in the sidebar automatically collapsed
+ auto = true
+ # {{< version 0.2.0 changed >}} {{< link "https://katex.org/" KaTeX >}} mathematical formulas
+ [params.page.math]
+ enable = true
+ # {{< version 0.2.11 changed >}} default inline delimiter is $ ... $ and \( ... \)
+ inlineLeftDelimiter = ""
+ inlineRightDelimiter = ""
+ # {{< version 0.2.11 changed >}} default block delimiter is $$ ... $$, \[ ... \], \begin{equation} ... \end{equation} and some other functions
+ blockLeftDelimiter = ""
+ blockRightDelimiter = ""
+ # KaTeX extension copy_tex
+ copyTex = true
+ # KaTeX extension mhchem
+ mhchem = true
+ # {{< version 0.2.0 >}} Code config
+ [params.page.code]
+ # whether to show the copy button of the code block
+ copy = true
+ # the maximum number of lines of displayed code by default
+ maxShownLines = 50
+ # {{< version 0.2.0 >}} {{< link "https://docs.mapbox.com/mapbox-gl-js" "Mapbox GL JS" >}} config
+ [params.page.mapbox]
+ # access token of Mapbox GL JS
+ accessToken = ""
+ # style for the light theme
+ lightStyle = "mapbox://styles/mapbox/light-v10?optimize=true"
+ # style for the dark theme
+ darkStyle = "mapbox://styles/mapbox/dark-v10?optimize=true"
+ # whether to add {{< link "https://docs.mapbox.com/mapbox-gl-js/api#navigationcontrol" NavigationControl >}}
+ navigation = true
+ # whether to add {{< link "https://docs.mapbox.com/mapbox-gl-js/api#geolocatecontrol" GeolocateControl >}}
+ geolocate = true
+ # whether to add {{< link "https://docs.mapbox.com/mapbox-gl-js/api#scalecontrol" ScaleControl >}}
+ scale = true
+ # whether to add {{< link "https://docs.mapbox.com/mapbox-gl-js/api#fullscreencontrol" FullscreenControl >}}
+ fullscreen = true
+ # {{< version 0.2.0 changed >}} social share links in post page
+ [params.page.share]
+ enable = true
+ Twitter = true
+ Facebook = true
+ Linkedin = false
+ Whatsapp = false
+ Pinterest = false
+ Tumblr = false
+ HackerNews = true
+ Reddit = false
+ VK = false
+ Buffer = false
+ Xing = false
+ Line = true
+ Instapaper = false
+ Pocket = false
+ Flipboard = false
+ Weibo = true
+ Blogger = false
+ Baidu = false
+ Odnoklassniki = false
+ Evernote = false
+ Skype = false
+ Trello = false
+ Mix = false
+ # {{< version 0.2.0 changed >}} Comment config
+ [params.page.comment]
+ enable = false
+ # {{< link "https://disqus.com/" Disqus >}} comment config
+ [params.page.comment.disqus]
+ # {{< version 0.1.1 >}}
+ enable = false
+ # Disqus shortname to use Disqus in posts
+ shortname = ""
+ # {{< link "https://github.com/gitalk/gitalk" Gitalk >}} comment config
+ [params.page.comment.gitalk]
+ # {{< version 0.1.1 >}}
+ enable = false
+ owner = ""
+ repo = ""
+ clientId = ""
+ clientSecret = ""
+ # {{< link "https://github.com/xCss/Valine" Valine >}} comment config
+ [params.page.comment.valine]
+ enable = false
+ appId = ""
+ appKey = ""
+ placeholder = ""
+ avatar = "mp"
+ meta= ""
+ pageSize = 10
+ lang = ""
+ visitor = true
+ recordIP = true
+ highlight = true
+ enableQQ = false
+ serverURLs = ""
+ # {{< version 0.2.6 >}} emoji data file name, default is "google.yml"
+ # ["apple.yml", "google.yml", "facebook.yml", "twitter.yml"]
+ # located in "themes/KeepIt/assets/data/emoji/" directory
+ # you can store your own data files in the same path under your project:
+ # "assets/data/emoji/"
+ emoji = ""
+ # {{< link "https://developers.facebook.com/docs/plugins/comments" "Facebook comment" >}} config
+ [params.page.comment.facebook]
+ enable = false
+ width = "100%"
+ numPosts = 10
+ appId = ""
+ languageCode = ""
+ # {{< version 0.2.0 >}} {{< link "https://comments.app/" "Telegram comments" >}} config
+ [params.page.comment.telegram]
+ enable = false
+ siteID = ""
+ limit = 5
+ height = ""
+ color = ""
+ colorful = true
+ dislikes = false
+ outlined = false
+ # {{< version 0.2.0 >}} {{< link "https://commento.io/" "Commento" >}} comment config
+ [params.page.comment.commento]
+ enable = false
+ # {{< version 0.2.5 >}} {{< link "https://utteranc.es/" "Utterances" >}} comment config
+ [params.page.comment.utterances]
+ enable = false
+ # owner/repo
+ repo = ""
+ issueTerm = "pathname"
+ label = ""
+ lightTheme = "github-light"
+ darkTheme = "github-dark"
+ # {{< version 0.2.7 >}} Third-party library config
+ [params.page.library]
+ [params.page.library.css]
+ # someCSS = "some.css"
+ # located in "assets/"
+ # Or
+ # someCSS = "https://cdn.example.com/some.css"
+ [params.page.library.js]
+ # someJavascript = "some.js"
+ # located in "assets/"
+ # Or
+ # someJavascript = "https://cdn.example.com/some.js"
+ # {{< version 0.2.10 changed >}} Page SEO config
+ [params.page.seo]
+ # image URL
+ images = []
+ # Publisher info
+ [params.page.seo.publisher]
+ name = ""
+ logoUrl = ""
+
+ # {{< version 0.2.5 >}} TypeIt config
+ [params.typeit]
+ # typing speed between each step (measured in milliseconds)
+ speed = 100
+ # blinking speed of the cursor (measured in milliseconds)
+ cursorSpeed = 1000
+ # character used for the cursor (HTML format is supported)
+ cursorChar = "|"
+ # cursor duration after typing finishing (measured in milliseconds, "-1" means unlimited)
+ duration = -1
+
+ # Site verification code config for Google/Bing/Yandex/Pinterest/Baidu
+ [params.verification]
+ google = ""
+ bing = ""
+ yandex = ""
+ pinterest = ""
+ baidu = ""
+
+ # {{< version 0.2.10 >}} Site SEO config
+ [params.seo]
+ # image URL
+ image = ""
+ # thumbnail URL
+ thumbnailUrl = ""
+
+ # {{< version 0.2.0 >}} Analytics config
+ [params.analytics]
+ enable = false
+ # Google Analytics
+ [params.analytics.google]
+ id = ""
+ # whether to anonymize IP
+ anonymizeIP = true
+ # Fathom Analytics
+ [params.analytics.fathom]
+ id = ""
+ # server url for your tracker if you're self hosting
+ server = ""
+
+ # {{< version 0.2.7 >}} Cookie consent config
+ [params.cookieconsent]
+ enable = true
+ # text strings used for Cookie consent banner
+ [params.cookieconsent.content]
+ message = ""
+ dismiss = ""
+ link = ""
+
+ # {{< version 0.2.7 changed >}} CDN config for third-party library files
+ [params.cdn]
+ # CDN data file name, disabled by default
+ # ["jsdelivr.yml"]
+ # located in "themes/KeepIt/assets/data/cdn/" directory
+ # you can store your own data files in the same path under your project:
+ # "assets/data/cdn/"
+ data = ""
+
+ # {{< version 0.2.8 >}} Compatibility config
+ [params.compatibility]
+ # whether to use Polyfill.io to be compatible with older browsers
+ polyfill = false
+ # whether to use object-fit-images to be compatible with older browsers
+ objectFit = false
+
+# Markup related config in Hugo
+[markup]
+ # {{< link "https://gohugo.io/content-management/syntax-highlighting" "Syntax Highlighting" >}}
+ [markup.highlight]
+ codeFences = true
+ guessSyntax = true
+ lineNos = true
+ lineNumbersInTable = true
+ # false is a necessary configuration
+ # ({{< link "https://github.com/Fastbyte01/KeepIt/issues/158" >}})
+ noClasses = false
+ # Goldmark is from Hugo 0.60 the default library used for Markdown
+ [markup.goldmark]
+ [markup.goldmark.extensions]
+ definitionList = true
+ footnote = true
+ linkify = true
+ strikethrough = true
+ table = true
+ taskList = true
+ typographer = true
+ [markup.goldmark.renderer]
+ # whether to use HTML tags directly in the document
+ unsafe = true
+ # Table Of Contents settings
+ [markup.tableOfContents]
+ startLevel = 2
+ endLevel = 6
+
+# Sitemap config
+[sitemap]
+ changefreq = "weekly"
+ filename = "sitemap.xml"
+ priority = 0.5
+
+# {{< link "https://gohugo.io/content-management/urls#permalinks" "Permalinks config" >}}
+[Permalinks]
+ # posts = ":year/:month/:filename"
+ posts = ":filename"
+
+# {{< link "https://gohugo.io/about/hugo-and-gdpr/" "Privacy config" >}}
+[privacy]
+ # {{< version 0.2.0 deleted >}} privacy of the Google Analytics (replaced by params.analytics.google)
+ [privacy.googleAnalytics]
+ # ...
+ [privacy.twitter]
+ enableDNT = true
+ [privacy.youtube]
+ privacyEnhanced = true
+
+# Options to make output .md files
+[mediaTypes]
+ [mediaTypes."text/plain"]
+ suffixes = ["md"]
+
+# Options to make output .md files
+[outputFormats.MarkDown]
+ mediaType = "text/plain"
+ isPlainText = true
+ isHTML = false
+
+# Options to make hugo output files
+[outputs]
+ # {{< version 0.2.0 changed >}}
+ home = ["HTML", "RSS", "JSON"]
+ page = ["HTML", "MarkDown"]
+ section = ["HTML", "RSS"]
+ taxonomy = ["HTML", "RSS"]
+ taxonomyTerm = ["HTML"]
+```
+
+{{< admonition >}}
+Note that some of these parameters are explained in details in other sections of this documentation.
+{{< /admonition >}}
+
+{{< admonition note "Hugo environments" >}}
+Default environments are `development` with `hugo serve` and `production` with `hugo`.
+
+Due to limitations in the local `development` environment,
+the **comment system**, **CDN** and **fingerprint** will not be enabled in the `development` environment.
+
+You could enable these features with `hugo serve -e production`.
+{{< /admonition >}}
+
+{{< admonition tip "Tips about CDN Configuration" >}}
+{{< version 0.2.7 changed >}}
+
+```toml
+[params.cdn]
+ # CDN data file name, disabled by default
+ # ["jsdelivr.yml"]
+ data = ""
+````
+
+The default CDN data file is located in `themes/KeepIt/assets/data/cdn/` directory.
+You can store your own data file in the same path under your project: `assets/data/cdn/`.
+{{< /admonition >}}
+
+{{< admonition tip "Tips about social Configuration" >}}
+{{< version 0.2.0 >}}
+
+You can directly set your ID to get a default social link and its icon:
+
+```toml
+[params.social]
+ Mastodon = "@xxxx"
+```
+
+The social link generated is `https://mastodon.technology/@xxxx`.
+
+Or You can set more options through a dict:
+
+```toml
+[params.social]
+ [params.social.Mastodon]
+ # weight when arranging icons (the greater the weight, the later the icon is positioned)
+ weight = 0
+ # your social ID
+ id = "@xxxx"
+ # prefix of your social link
+ prefix = "https://mastodon.social/"
+ # content hovering on the icon
+ title = "Mastodon"
+```
+
+The default data of all supported social links is located in `themes/KeepIt/assets/data/social.yaml`,
+which is you can refer to.
+{{< /admonition >}}
+
+
+
+### 3.2 Favicons, Browserconfig, Manifest
+
+It is recommended to put your own favicons:
+
+* apple-touch-icon.png (180x180)
+* favicon-32x32.png (32x32)
+* favicon-16x16.png (16x16)
+* mstile-150x150.png (150x150)
+* android-chrome-192x192.png (192x192)
+* android-chrome-512x512.png (512x512)
+
+into `/static`. They’re easily created via [https://realfavicongenerator.net/](https://realfavicongenerator.net/).
+
+Customize `browserconfig.xml` and `site.webmanifest` to set theme-color and background-color.
+
+### 3.3 Style Customization
+
+{{< version 0.2.8 changed >}}
+
+{{< admonition >}}
+Hugo **extended** version is necessary for the style customization.
+{{< /admonition >}}
+
+**KeepIt** theme has been built to be as configurable as possible by defining custom `.scss` style files.
+
+The directory including the custom `.scss` style files is `assets/css` relative to **your project root directory**.
+
+In `assets/css/_override.scss`, you can override the variables in `themes/KeepIt/assets/css/_variables.scss` to customize the style.
+
+Here is a example:
+
+```scss
+@import url('https://fonts.googleapis.com/css?family=Fira+Mono:400,700&display=swap&subset=latin-ext');
+$code-font-family: Fira Mono, Source Code Pro, Menlo, Consolas, Monaco, monospace;
+```
+
+In `assets/css/_custom.scss`, you can add some css style code to customize the style.
+
+## 4 Multilingual and i18n
+
+**KeepIt** theme is fully compatible with Hugo multilingual mode, which provides in-browser language switching.
+
+
+
+### 4.1 Compatibility {#language-compatibility}
+
+{{< version 0.2.10 changed >}}
+
+| Language | Hugo Code | HTML `lang` Attribute | Theme Docs | Lunr.js Support |
+|:-------------------- |:---------:|:---------------------:|:-----------------------------:|:-----------------------------:|
+| English | `en` | `en` | :(far fa-check-square fa-fw): | :(far fa-check-square fa-fw): |
+| Simplified Chinese | `zh-cn` | `zh-CN` | :(far fa-check-square fa-fw): | :(far fa-check-square fa-fw): |
+| Traditional Chinese | `zh-tw` | `zh-TW` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+| French | `fr` | `fr` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+| Polish | `pl` | `pl` | :(far fa-square fa-fw): | :(far fa-square fa-fw): |
+| Brazilian Portuguese | `pt-br` | `pt-BR` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+| Italian | `it` | `it` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+| Spanish | `es` | `es` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+| German | `de` | `de` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+| German | `de` | `de` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+| Serbian | `sr` | `sr` | :(far fa-square fa-fw): | :(far fa-square fa-fw): |
+| Russian | `ru` | `ru` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+| Romanian | `ro` | `ro` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+| Vietnamese | `vi` | `vi` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): |
+
+### 4.2 Basic Configuration
+
+After learning [how Hugo handle multilingual websites](https://gohugo.io/content-management/multilingual), define your languages in your [site configuration](#site-configuration).
+
+For example with English, Chinese and French website:
+
+```toml
+# determines default content language ["en", "zh-cn", "fr", "pl", ...]
+defaultContentLanguage = "en"
+
+[languages]
+ [languages.en]
+ weight = 1
+ title = "My New Hugo Site"
+ languageCode = "en"
+ languageName = "English"
+ [[languages.en.menu.main]]
+ weight = 1
+ identifier = "posts"
+ pre = ""
+ post = ""
+ name = "Posts"
+ url = "/posts/"
+ title = ""
+ [[languages.en.menu.main]]
+ weight = 2
+ identifier = "tags"
+ pre = ""
+ post = ""
+ name = "Tags"
+ url = "/tags/"
+ title = ""
+ [[languages.en.menu.main]]
+ weight = 3
+ identifier = "categories"
+ pre = ""
+ post = ""
+ name = "Categories"
+ url = "/categories/"
+ title = ""
+
+ [languages.zh-cn]
+ weight = 2
+ title = "我的全新 Hugo 网站"
+ languageCode = "zh-CN"
+ languageName = "简体中文"
+ hasCJKLanguage = true
+ [[languages.zh-cn.menu.main]]
+ weight = 1
+ identifier = "posts"
+ pre = ""
+ post = ""
+ name = "文章"
+ url = "/posts/"
+ title = ""
+ [[languages.zh-cn.menu.main]]
+ weight = 2
+ identifier = "tags"
+ pre = ""
+ post = ""
+ name = "标签"
+ url = "/tags/"
+ title = ""
+ [[languages.zh-cn.menu.main]]
+ weight = 3
+ identifier = "categories"
+ pre = ""
+ post = ""
+ name = "分类"
+ url = "/categories/"
+ title = ""
+
+ [languages.fr]
+ weight = 3
+ title = "Mon nouveau site Hugo"
+ languageCode = "fr"
+ languageName = "Français"
+ [[languages.fr.menu.main]]
+ weight = 1
+ identifier = "posts"
+ pre = ""
+ post = ""
+ name = "Postes"
+ url = "/posts/"
+ title = ""
+ [[languages.fr.menu.main]]
+ weight = 2
+ identifier = "tags"
+ pre = ""
+ post = ""
+ name = "Balises"
+ url = "/tags/"
+ title = ""
+ [[languages.fr.menu.main]]
+ weight = 3
+ identifier = "categories"
+ name = "Catégories"
+ pre = ""
+ post = ""
+ url = "/categories/"
+ title = ""
+```
+
+Then, for each new page, append the language code to the file name.
+
+Single file `my-page.md` is split in three files:
+
+* in English: `my-page.en.md`
+* in Chinese: `my-page.zh-cn.md`
+* in French: `my-page.fr.md`
+
+{{< admonition >}}
+Be aware that only translated pages are displayed in menu. It’s not replaced with default language content.
+{{< /admonition >}}
+
+{{< admonition tip >}}
+Use [Front Matter parameter](https://gohugo.io/content-management/multilingual#translate-your-content) to translate urls too.
+{{< /admonition >}}
+
+### 4.3 Overwrite Translation Strings
+
+Translations strings are used for common default values used in the theme. Translations are available in [some languages](#language-compatibility), but you may use another language or want to override default values.
+
+To override these values, create a new file in your local i18n folder `i18n/.toml` and inspire yourself from `themes/KeepIt/i18n/en.toml`.
+
+By the way, as these translations could be used by other people, please take the time to propose a translation by [:(fas fa-code-branch fa-fw): making a PR](https://github.com/Fastbyte01/KeepIt/pulls) to the theme!
+
+## 5 Search
+
+{{< version 0.2.0 >}}
+
+Based on [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/), searching is supported in **KeepIt** theme.
+
+### 5.1 Output Configuration
+
+In order to generate `index.json` for searching, add `JSON` output file type to the `home` of the `outputs` part in your [site configuration](#site-configuration).
+
+```toml
+[outputs]
+ home = ["HTML", "RSS", "JSON"]
+```
+
+### 5.2 Search Configuration
+
+Based on `index.json` generated by Hugo, you could activate searching.
+
+Here is the search configuration in your [site configuration](#site-configuration):
+
+```toml
+[params.search]
+ enable = true
+ # type of search engine ["lunr", "algolia"]
+ type = "lunr"
+ # max index length of the chunked content
+ contentLength = 4000
+ # placeholder of the search bar
+ placeholder = ""
+ # {{< version 0.2.1 >}} max number of results length
+ maxResultLength = 10
+ # {{< version 0.2.3 >}} snippet length of the result
+ snippetLength = 30
+ # {{< version 0.2.1 >}} HTML tag name of the highlight part in results
+ highlightTag = "em"
+ # {{< version 0.2.4 >}} whether to use the absolute URL based on the baseURL in search index
+ absoluteURL = false
+ [params.search.algolia]
+ index = ""
+ appID = ""
+ searchKey = ""
+```
+
+{{< admonition note "How to choose search engine?" >}}
+The following is a comparison of two search engines:
+
+* `lunr`: simple, no need to synchronize `index.json`, no limit for `contentLength`,
+ but high bandwidth and low performance (Especially for Chinese which needs a large segmentit library)
+* `algolia`: high performance and low bandwidth, but need to synchronize `index.json` and limit for `contentLength`
+
+{{< version 0.2.3 >}} The content of the post is separated by `h2` and `h3` HTML tag to improve query performance and basically implement full-text search.
+`contentLength` is used to limit the max index length of the part starting with `h2` and `h3` HTML tag.
+{{< /admonition >}}
+
+{{< admonition tip "Tips about algolia" >}}
+You need to upload `index.json` files to algolia to activate searching.
+You could upload the `index.json` files by browsers but a CLI tool may be better.
+The official [Algolia CLI](https://github.com/algolia/algolia-cli) is a good choice.
+To be compatible with Hugo multilingual mode,
+you need to upload different `index.json` for each language to the different index of algolia, such as `zh-cn/index.json` or `fr/index.json`...
+{{< /admonition >}}
diff --git a/content/posts/theme-documentation-basics/language-switch.gif b/content/posts/theme-documentation-basics/language-switch.gif
new file mode 100644
index 00000000..37066df5
Binary files /dev/null and b/content/posts/theme-documentation-basics/language-switch.gif differ
diff --git a/content/posts/theme-documentation-bilibili-shortcode/featured-image.jpg b/content/posts/theme-documentation-bilibili-shortcode/featured-image.jpg
new file mode 100644
index 00000000..90dbcb0f
Binary files /dev/null and b/content/posts/theme-documentation-bilibili-shortcode/featured-image.jpg differ
diff --git a/content/posts/theme-documentation-bilibili-shortcode/index.en.md b/content/posts/theme-documentation-bilibili-shortcode/index.en.md
new file mode 100644
index 00000000..5668e09e
--- /dev/null
+++ b/content/posts/theme-documentation-bilibili-shortcode/index.en.md
@@ -0,0 +1,65 @@
+---
+weight: 9
+title: "Theme Documentation - bilibili Shortcode"
+date: 2020-03-03T11:29:41+08:00
+lastmod: 2020-03-03T12:29:41+08:00
+draft: false
+author: "Dillon"
+authorLink: "https://dillonzq.com"
+description: "The bilibili shortcode embeds a responsive video player for bilibili videos."
+images: []
+resources:
+- name: "featured-image"
+ src: "featured-image.jpg"
+
+tags: ["shortcodes"]
+categories: ["documentation"]
+
+hiddenFromHomePage: true
+
+toc:
+ enable: false
+---
+
+{{< version 0.2.0 changed >}}
+
+The `bilibili` shortcode embeds a responsive video player for bilibili videos.
+
+
+
+When the video only has one part, only the BV `id` of the video is required, e.g.:
+
+```code
+https://www.bilibili.com/video/BV1Sx411T7QQ
+```
+
+Example `bilibili` input:
+
+```markdown
+{{* bilibili BV1Sx411T7QQ */>}}
+Or
+{{* bilibili id=BV1Sx411T7QQ */>}}
+```
+
+The rendered output looks like this:
+
+{{< bilibili id=BV1Sx411T7QQ >}}
+
+When the video has multiple parts, in addition to the BV `id` of the video,
+`p` is also required, whose default value is `1`, e.g.:
+
+```code
+https://www.bilibili.com/video/BV1TJ411C7An?p=3
+```
+
+Example `bilibili` input with `p`:
+
+```markdown
+{{* bilibili BV1TJ411C7An 3 */>}}
+Or
+{{* bilibili id=BV1TJ411C7An p=3 */>}}
+```
+
+The rendered output looks like this:
+
+{{< bilibili id=BV1TJ411C7An p=3 >}}
diff --git a/content/posts/theme-documentation-built-in-shortcodes/featured-image.png b/content/posts/theme-documentation-built-in-shortcodes/featured-image.png
new file mode 100644
index 00000000..2824a7ff
Binary files /dev/null and b/content/posts/theme-documentation-built-in-shortcodes/featured-image.png differ
diff --git a/content/posts/theme-documentation-built-in-shortcodes/index.en.md b/content/posts/theme-documentation-built-in-shortcodes/index.en.md
new file mode 100644
index 00000000..a94d81e9
--- /dev/null
+++ b/content/posts/theme-documentation-built-in-shortcodes/index.en.md
@@ -0,0 +1,179 @@
+---
+weight: 3
+title: "Theme Documentation - Built-in Shortcodes"
+date: 2020-03-04T16:29:41+08:00
+lastmod: 2020-03-04T16:29:41+08:00
+draft: false
+author: "Dillon"
+authorLink: "https://dillonzq.com"
+description: "Hugo provides multiple built-in shortcodes for author convenience and to keep your markdown content clean."
+images: []
+resources:
+- name: "featured-image"
+ src: "featured-image.png"
+
+tags: ["shortcodes"]
+categories: ["documentation"]
+
+lightgallery: true
+---
+
+**Hugo** provides multiple built-in shortcodes for author convenience and to keep your markdown content clean.
+
+
+
+Hugo uses Markdown for its simple content format. However, there are a lot of things that Markdown doesn’t support well. You could use pure HTML to expand possibilities.
+
+But this happens to be a bad idea. Everyone uses Markdown because it’s pure and simple to read even non-rendered. You should avoid HTML to keep it as simple as possible.
+
+To avoid this limitations, Hugo created [shortcodes](https://gohugo.io/extras/shortcodes/).
+A shortcode is a simple snippet that can generate reasonable HTML code and conforms to Markdown's design philosophy.
+
+Hugo ships with a set of predefined shortcodes that represent very common usage. These shortcodes are provided for author convenience and to keep your markdown content clean.
+
+## 1 figure {#figure}
+
+[Documentation of `figure`](https://gohugo.io/content-management/shortcodes#figure)
+
+Example `figure` input:
+
+```markdown
+{{* figure src="/images/lighthouse.jpg" title="Lighthouse (figure)" */>}}
+```
+
+The rendered output looks like this:
+
+{{< figure src="/images/lighthouse.jpg" title="Lighthouse (figure)" >}}
+
+The HTML looks like this:
+
+```html
+
+
+
+