chore(*): update articles
ppoffice
parent
32525c5ecb
commit
ebd50c11a6
|
|
@ -137,6 +137,8 @@ plugins:
|
|||
baidu-analytics:
|
||||
# Baidu Analytics tracking id
|
||||
tracking_id:
|
||||
hotjar:
|
||||
site_id: 1067642
|
||||
# CDN provider settings
|
||||
providers:
|
||||
# Name or URL of the JavaScript and/or stylesheet CDN provider
|
||||
|
|
|
|||
|
|
@ -0,0 +1,17 @@
|
|||
const cheerio = require('cheerio');
|
||||
|
||||
function fixStyle(content) {
|
||||
const $ = cheerio.load(content, { decodeEntities: false });
|
||||
$('body').append(`
|
||||
<style>
|
||||
#_hj_feedback_container *:after {
|
||||
box-shadow: none !important;
|
||||
}
|
||||
</style>
|
||||
`);
|
||||
return $.html();
|
||||
}
|
||||
|
||||
hexo.extend.filter.register('after_render:html', function (content, data) {
|
||||
return fixStyle(content);
|
||||
});
|
||||
|
|
@ -0,0 +1,54 @@
|
|||
title: FAQ
|
||||
date: 2018-02-01 23:59:59
|
||||
thumbnail: /gallery/sculpture.jpg
|
||||
---
|
||||
|
||||
### How do I put text instead of an image as my site's logo?
|
||||
|
||||
If you consider using a piece of text instead of an image as the logo of your site, you can do something like this:
|
||||
|
||||
{% codeblock lang:yaml _config.yml %}
|
||||
logo:
|
||||
text: My Beautiful Site
|
||||
{% endcodeblock %}
|
||||
<!-- more -->
|
||||
### How do I change the site's language?
|
||||
Edit your blog's `_config.yml`(not your theme's), change the following field:
|
||||
|
||||
```diff
|
||||
- language: en
|
||||
+ language: zh-CN
|
||||
```
|
||||
|
||||
You can find available translation under `icarus/languages` folder.
|
||||
|
||||
### How to add an excerpt for a post? How to display the "Read more" button?
|
||||
Add `<!-- more -->` tag in your post. Post content before this tag will be marked as an excerpt and content after this tag will not show on the index page.
|
||||
|
||||
### Why aren't my changes deployed to the Github Pages?
|
||||
Please run these commands before `hexo deploy`:
|
||||
|
||||
```bash
|
||||
$ hexo clean
|
||||
$ rm -r .deploy_git
|
||||
```
|
||||
|
||||
### How to add meta tags for a specified post/page?
|
||||
|
||||
You can add meta tags for each post/page through front-matter:
|
||||
|
||||
```diff
|
||||
title: test post
|
||||
date: 2015-01-26 21:55:37
|
||||
tags:
|
||||
comments: false
|
||||
+ meta:
|
||||
+ - name="robots";content="noindex, follow"
|
||||
+ - name="another-meta";value="hello world";enabled=false
|
||||
```
|
||||
|
||||
### Does this theme support RTL(Right-to-Left) language?
|
||||
|
||||
Partially yes. Please refer to [Issues#234](https://github.com/ppoffice/hexo-theme-icarus/issues/234)
|
||||
|
||||
<a style="background-color:black;color:white;text-decoration:none;padding:4px 6px;font-size:12px;line-height:1.2;display:inline-block;border-radius:3px" href="https://unsplash.com/@czermak_photography?utm_medium=referral&utm_campaign=photographer-credit&utm_content=creditBadge" target="_blank" rel="noopener noreferrer" title="Download free do whatever you want high-resolution photos from Christopher Czermak"><span style="display:inline-block;padding:2px 3px"><svg xmlns="http://www.w3.org/2000/svg" style="height:12px;width:auto;position:relative;vertical-align:middle;top:-1px;fill:white" viewBox="0 0 32 32"><title>unsplash-logo</title><path d="M20.8 18.1c0 2.7-2.2 4.8-4.8 4.8s-4.8-2.1-4.8-4.8c0-2.7 2.2-4.8 4.8-4.8 2.7.1 4.8 2.2 4.8 4.8zm11.2-7.4v14.9c0 2.3-1.9 4.3-4.3 4.3h-23.4c-2.4 0-4.3-1.9-4.3-4.3v-15c0-2.3 1.9-4.3 4.3-4.3h3.7l.8-2.3c.4-1.1 1.7-2 2.9-2h8.6c1.2 0 2.5.9 2.9 2l.8 2.4h3.7c2.4 0 4.3 1.9 4.3 4.3zm-8.6 7.5c0-4.1-3.3-7.5-7.5-7.5-4.1 0-7.5 3.4-7.5 7.5s3.3 7.5 7.5 7.5c4.2-.1 7.5-3.4 7.5-7.5z"></path></svg></span><span style="display:inline-block;padding:2px 3px">Christopher Czermak</span></a>
|
||||
|
|
@ -4,23 +4,16 @@ thumbnail: /gallery/desert.jpg
|
|||
tags:
|
||||
- Getting Started
|
||||
---
|
||||
A simple, delicate, and modern theme for the static site generator Hexo. Its versatile layout configuration allows you to set up a single or multiple-column (up to three column) blog easily. Additionally, it offers plentiful [plugins](/hexo-theme-icarus/categories/Plugins/) and pluggable [widgets](/hexo-theme-icarus/categories/Widgets/) so that you can enable the features you want in no time. And with the all-new API designing, Icarus makes the development of this theme painless for developers and users.
|
||||
A simple, delicate, and modern theme for the static site generator Hexo. It allows you to set up a single or multiple-column (up to three column) blog with its versatile layout configuration. Additionally, it offers plentiful plugins and pluggable widgets so that you can enable the features you want in no time. And with the all-new API designing, Icarus makes the development of this theme painless for developers and users.
|
||||
|
||||
<!-- more -->
|
||||
|
||||
To get started with Icarus, download and unzip the GitHub repository to your Hexo blog's theme directory or run the following command from your blog's root directory:
|
||||
To set up Icarus in your blog, please download the tarball from the GitHub and extract it to your Hexo blog's theme directory. Alternatively, you can run the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus
|
||||
git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus -b <version number>
|
||||
```
|
||||
|
||||
You can also specify a version for Icarus after downloading the theme through `git`. Replace the version code in the following command and execute:
|
||||
|
||||
```bash
|
||||
git checkout 2.0.0
|
||||
```
|
||||
|
||||
Furthermore, you can install Icarus as a git submodule by calling the following command:
|
||||
You may omit the ` -b <version number>` to get the latest development version of Icarus. Furthermore, you can install Icarus as a git submodule by executing the following command:
|
||||
|
||||
```bash
|
||||
git submodule add https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus
|
||||
|
|
@ -37,7 +30,4 @@ Finally, use the following command to start the Hexo local server and begin comp
|
|||
```yaml
|
||||
hexo s
|
||||
```
|
||||
|
||||
> Don't forget to check out the [Getting Started](/hexo-theme-icarus/tags/Getting-Started/) series to help you master the Icarus quickly! Also, you can switch the [`site` branch](https://github.com/ppoffice/hexo-theme-icarus/tree/site) in the Icarus repository if you need further examples about installation and configuration.
|
||||
|
||||
<a style="background-color:black;color:white;text-decoration:none;padding:4px 6px;font-size:12px;line-height:1.2;display:inline-block;border-radius:3px" href="https://unsplash.com/@yazi0413?utm_medium=referral&utm_campaign=photographer-credit&utm_content=creditBadge" target="_blank" rel="noopener noreferrer" title="Download free do whatever you want high-resolution photos from Chandler Chen"><span style="display:inline-block;padding:2px 3px"><svg xmlns="http://www.w3.org/2000/svg" style="height:12px;width:auto;position:relative;vertical-align:middle;top:-1px;fill:white" viewBox="0 0 32 32"><title>unsplash-logo</title><path d="M20.8 18.1c0 2.7-2.2 4.8-4.8 4.8s-4.8-2.1-4.8-4.8c0-2.7 2.2-4.8 4.8-4.8 2.7.1 4.8 2.2 4.8 4.8zm11.2-7.4v14.9c0 2.3-1.9 4.3-4.3 4.3h-23.4c-2.4 0-4.3-1.9-4.3-4.3v-15c0-2.3 1.9-4.3 4.3-4.3h3.7l.8-2.3c.4-1.1 1.7-2 2.9-2h8.6c1.2 0 2.5.9 2.9 2l.8 2.4h3.7c2.4 0 4.3 1.9 4.3 4.3zm-8.6 7.5c0-4.1-3.3-7.5-7.5-7.5-4.1 0-7.5 3.4-7.5 7.5s3.3 7.5 7.5 7.5c4.2-.1 7.5-3.4 7.5-7.5z"></path></svg></span><span style="display:inline-block;padding:2px 3px">Chandler Chen</span></a>
|
||||
> Don't forget to check out the [Getting Started](/hexo-theme-icarus/tags/Getting-Started/) series to help you master Icarus quickly! Also, you can fetch the [`site` branch](https://github.com/ppoffice/hexo-theme-icarus/tree/site) from the GitHub repository if you need more configuration examples.
|
||||
|
|
|
|||
|
|
@ -24,3 +24,13 @@ plugins:
|
|||
baidu-analytics:
|
||||
tracking_id: XXXXXX (required)
|
||||
{% endcodeblock %}
|
||||
|
||||
### Hotjar
|
||||
|
||||
[Installation instructions](https://help.hotjar.com/hc/en-us/sections/115002608787-Installation-Guides)
|
||||
|
||||
{% codeblock lang:yaml _config.yml %}
|
||||
plugins:
|
||||
hotjar:
|
||||
site_id: XXXXXX (required)
|
||||
{% endcodeblock %}
|
||||
|
|
|
|||
|
|
@ -5,31 +5,16 @@ categories:
|
|||
- General
|
||||
---
|
||||
|
||||
{% quote %}
|
||||
The following photos come from <a href="https://www.pexels.com">pexel.com</a>
|
||||
{% endquote %}
|
||||
|
||||
You can add photos between text to create a gallery like this:
|
||||
|
||||
|
||||
You can create a gallery by just adding photos in the post, and enable the gallery plugin in the `_config.yml`:
|
||||
|
||||
```yml
|
||||
plugins:
|
||||
gallery: true
|
||||
```
|
||||
<!-- more -->
|
||||
or this:
|
||||
|
||||
|
||||
|
||||
Furthermore, you can also use Justified Gallery to display you photos in a grid:
|
||||
|
||||
<div class="justified-gallery">
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
{% codeblock lang:html HTML + Markdown %}
|
||||
<div class="justified-gallery">
|
||||
|
||||
|
|
@ -40,4 +25,18 @@ Furthermore, you can also use Justified Gallery to display you photos in a grid:
|
|||
|
||||
|
||||
</div>
|
||||
{% endcodeblock %}
|
||||
{% endcodeblock %}
|
||||
|
||||
{% quote %}
|
||||
The following photos come from <a href="https://www.pexels.com">pexel.com</a>
|
||||
{% endquote %}
|
||||
|
||||
<div class="justified-gallery">
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
</div>
|
||||
|
|
@ -32,7 +32,7 @@ For further MathJax configurations, please edit `<theme folder>/layout/plugin/sc
|
|||
```
|
||||
|
||||
### TeX and LaTeX input
|
||||
> Please be noted that when you write Tex/LaTeX in Markdown files, you need to use escape characters to prevent certain signs from being processed by Markdown interpreter.
|
||||
> **Attention**: Please be noted that when you write Tex/LaTeX in Markdown files, you need to use escape characters to prevent certain signs from being processed by Markdown interpreter.
|
||||
|
||||
##### Input
|
||||
```
|
||||
|
|
@ -45,7 +45,7 @@ When $a \ne 0$, there are two solutions to \\(ax^2 + bx + c = 0\\) and they are
|
|||
$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$
|
||||
|
||||
### MathML input
|
||||
> Attention: please be noted that newline characters will be transformed to `<br>` tag by Markdown interpreter and this will interfere with MathML notation. Please write all MathML inline.
|
||||
> **Attention**: please be noted that newline characters may be transformed to `<br>` tag by Markdown interpreter and this will interfere with MathML notation. Please write all MathML inline.
|
||||
|
||||
##### Input
|
||||
```
|
||||
|
|
@ -58,7 +58,7 @@ When<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mo>≠</mo>
|
|||
<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>x</mi> <mo>=</mo><mrow><mfrac><mrow><mo>−</mo><mi>b</mi><mo>±</mo><msqrt><msup><mi>b</mi><mn>2</mn></msup><mo>−</mo><mn>4</mn><mi>a</mi><mi>c</mi></msqrt></mrow><mrow> <mn>2</mn><mi>a</mi> </mrow></mfrac></mrow><mtext>.</mtext></math>
|
||||
|
||||
### AsciiMath input
|
||||
> Attention: please be noted that when you write AsciiMath in Markdown files, you need to use escape characters to prevent certain signs from being processed by Markdown interpreter.
|
||||
> **Attention**: please be noted that when you write AsciiMath in Markdown files, you need to use escape characters to prevent certain signs from being processed by Markdown interpreter.
|
||||
|
||||
##### Input
|
||||
```
|
||||
|
|
|
|||
|
|
@ -0,0 +1,39 @@
|
|||
title: Adding a Thumbnail to Your Article
|
||||
date: 2016-07-08 20:07:55
|
||||
categories:
|
||||
- Configuration
|
||||
- Posts
|
||||
tags:
|
||||
- Getting Started
|
||||
---
|
||||
You can add thumbnail images to your posts in two steps. First, make sure the thumbnail is enabled in the theme's configuration file:
|
||||
|
||||
{% codeblock _config.yml lang:yaml %}
|
||||
article:
|
||||
thumbnail: true
|
||||
{% endcodeblock %}
|
||||
|
||||
Then, provide an URL or path to the image file in the front-matter of your post:
|
||||
|
||||
{% codeblock post.md lang:yaml %}
|
||||
title: Getting Started with Icarus
|
||||
thumbnail: /gallery/desert.jpg
|
||||
---
|
||||
Post content...
|
||||
{% endcodeblock %}
|
||||
|
||||
### About thumbnail image path
|
||||
|
||||
The image path you put in the front-matter needs to be the relative path to the source directory of your website. For example, if you want to use the following image as a thumbnail:
|
||||
|
||||
```
|
||||
<your blog>/source/gallery/image.jpg
|
||||
```
|
||||
|
||||
You need to use the following as the image path:
|
||||
|
||||
```
|
||||
/gallery/image.jpg
|
||||
```
|
||||
|
||||
Also, it is recommended that you put all the images under a dedicated asset folder that is separated from the `_posts` folder.
|
||||
|
|
@ -10,7 +10,7 @@ search:
|
|||
---
|
||||
|
||||
{% quote %}
|
||||
From Icarus 2, you no longer need to install <code>hexo-generator-json-content</code> to be able to use the insight search.
|
||||
From Icarus 2.0.0, you no longer need to install <code>hexo-generator-json-content</code> to use the insight search plugin.
|
||||
{% endquote %}
|
||||
|
||||
{% codeblock lang:yaml _config.yml %}
|
||||
|
|
|
|||
|
|
@ -14,7 +14,7 @@ The configuration of Icarus consists of two parts: theme configuration and post
|
|||
|
||||
## Theme Configuration
|
||||
|
||||
Icarus uses the `_config.yml` file under your theme directory for global page layout, plugins and widgets settings that are effective across the whole blog. On startup, Icarus will check the existence of this configuration file and creates it for you automatically if file is not found. It will also validate this file against the specifications if it is already there. You can check the specifications at anytime from the `*.spec.js` files inside the `themes/icarus/includes/specs` folder.
|
||||
Icarus uses the _config.yml file for global page layout, plugins and widgets settings. It will check and validate the configuration file, points out any misconfigurations, and generates one for you if none exists. You can check the specifications at any time from the `*.spec.js` files inside the `themes/icarus/includes/specs` folder.
|
||||
|
||||
A default theme configuration consists of the following parts:
|
||||
|
||||
|
|
@ -22,16 +22,16 @@ A default theme configuration consists of the following parts:
|
|||
- Top navigation bar links
|
||||
- Page footer links
|
||||
- Article display settings
|
||||
- [Comment](/hexo-theme-icarus/categories/Plugins/Comment/), [share](/hexo-theme-icarus/categories/Plugins/Share/), and [search](/hexo-theme-icarus/categories/Plugins/Search/) plugin settings
|
||||
- [Comment](/hexo-theme-icarus/categories/Plugins/Comment/), [share](/hexo-theme-icarus/categories/Plugins/Share/) and [search](/hexo-theme-icarus/categories/Plugins/Search/) plugin settings
|
||||
- [Sidebar widget](/hexo-theme-icarus/categories/Widgets/) settings
|
||||
- Other display and analytics [plugins](/hexo-theme-icarus/categories/Plugins/General/)
|
||||
- CDN settings
|
||||
|
||||
Most of the settings are documented in the `_config.yml` file. And for more details, you can refer to the [online documentation](/hexo-theme-icarus/categories/).
|
||||
Most of the settings are documented in the `_config.yml` file. For more details on configuring plugins, you can refer to the [online documentation](/hexo-theme-icarus/categories/).
|
||||
|
||||
## Post Configuration
|
||||
|
||||
Apart from the global theme configuration, you can also customize any settings in a specific post. That is, you can override the theme settings from a post. Let's say you want to show different navigation bar menus in a post, we can simply put the `navbar` settings in the post's front-matter:
|
||||
Apart from the global theme configuration, you can also make customizations in any post. That is, you can override the theme configurations from a post. Let's say you want to show different navigation bar menus in a post. To do this, you only need to put the `navbar` settings in the post's front-matter:
|
||||
|
||||
```yaml
|
||||
navbar:
|
||||
|
|
@ -40,6 +40,6 @@ navbar:
|
|||
Special!: /special
|
||||
```
|
||||
|
||||
This will replace your default navbar menu settings only in this post. This feature can be useful if you want to tune your page for a specific type of audience, such as enabling faster CDN and comment service based on the country and language of the viewer.
|
||||
The configurations you set here will be applied only to this post. This feature can be very useful for displaying customized/optimized pages to a specific audience. For example, you can enable faster CDNs or a localized comment service based on the country and language of the page viewers.
|
||||
|
||||
<a style="background-color:black;color:white;text-decoration:none;padding:4px 6px;font-size:12px;line-height:1.2;display:inline-block;border-radius:3px" href="https://unsplash.com/@alexholtdesign?utm_medium=referral&utm_campaign=photographer-credit&utm_content=creditBadge" target="_blank" rel="noopener noreferrer" title="Download free do whatever you want high-resolution photos from Alex Holt"><span style="display:inline-block;padding:2px 3px"><svg xmlns="http://www.w3.org/2000/svg" style="height:12px;width:auto;position:relative;vertical-align:middle;top:-1px;fill:white" viewBox="0 0 32 32"><title>unsplash-logo</title><path d="M20.8 18.1c0 2.7-2.2 4.8-4.8 4.8s-4.8-2.1-4.8-4.8c0-2.7 2.2-4.8 4.8-4.8 2.7.1 4.8 2.2 4.8 4.8zm11.2-7.4v14.9c0 2.3-1.9 4.3-4.3 4.3h-23.4c-2.4 0-4.3-1.9-4.3-4.3v-15c0-2.3 1.9-4.3 4.3-4.3h3.7l.8-2.3c.4-1.1 1.7-2 2.9-2h8.6c1.2 0 2.5.9 2.9 2l.8 2.4h3.7c2.4 0 4.3 1.9 4.3 4.3zm-8.6 7.5c0-4.1-3.3-7.5-7.5-7.5-4.1 0-7.5 3.4-7.5 7.5s3.3 7.5 7.5 7.5c4.2-.1 7.5-3.4 7.5-7.5z"></path></svg></span><span style="display:inline-block;padding:2px 3px">Alex Holt</span></a>
|
||||
|
|
@ -1,4 +1,5 @@
|
|||
title: Polymorphic Link Settings
|
||||
slug: Polymorphic-Link-Settings
|
||||
date: 2018-10-22 19:23:57
|
||||
thumbnail: /gallery/flower.jpg
|
||||
categories:
|
||||
|
|
@ -13,7 +14,7 @@ footer:
|
|||
url: 'http://github.com/ppoffice/hexo-theme-icarus'
|
||||
---
|
||||
|
||||
You may already noticed that Icarus allows you to put icon links on the right of navigation bar, the bottom of the profile widget, and the right side of the footer with the following format:
|
||||
You may already notice that Icarus allows you to put icon links on the right of the navigation bar, the bottom of the profile widget, and the right side of the footer with the following format:
|
||||
|
||||
<!-- more -->
|
||||
|
||||
|
|
@ -28,12 +29,12 @@ footer:
|
|||
url: 'https://creativecommons.org/licenses/by/4.0/'
|
||||
```
|
||||
|
||||
In the above link format, you need to specify the name of the link (e.g., Creative Commons), as well as the icon class name (e.g., Font Awesome class name) and link URL. However, Icarus also accept pure text links with link name and URL in the format below:
|
||||
In the above link format, you need to specify the name of the link (e.g., Creative Commons), as well as the icon class name (e.g., Font Awesome class name) and link URL. However, Icarus also accept pure text links with a link name and URL in the format below:
|
||||
|
||||
```yml
|
||||
footer:
|
||||
links:
|
||||
'Creative Commons: 'https://creativecommons.org/''
|
||||
'Creative Commons: 'https://creativecommons.org/'
|
||||
'Attribution 4.0 International': 'https://creativecommons.org/licenses/by/4.0/'
|
||||
```
|
||||
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ categories:
|
|||
- Widgets
|
||||
---
|
||||
|
||||
You can show a list of links to other websites in the sidebar by enabling the links widget. Add the following configuration to the `widgets` section in your `_config.yml` file and you are good to go:
|
||||
You can show a list of links to other websites in the sidebar by enabling the links widget. Add the following configuration to the `widgets` section in your `_config.yml` file, and you are good to go:
|
||||
|
||||
```yaml
|
||||
-
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@ widgets:
|
|||
url: 'http://github.com/ppoffice/hexo-theme-icarus'
|
||||
---
|
||||
|
||||
Icarus offers a way to showcase yourself using the profile sidebar widget. To use this widget, simply add the following lines to the widgets section of your `_config.yml`:
|
||||
Icarus offers a way to showcase yourself using the profile sidebar widget. To use this widget, add the following lines to the widgets section of your `_config.yml`:
|
||||
|
||||
{% codeblock lang:yaml _config.yml %}
|
||||
-
|
||||
|
|
@ -41,25 +41,8 @@ Icarus offers a way to showcase yourself using the profile sidebar widget. To us
|
|||
<!-- more -->
|
||||
There are two things that you should note:
|
||||
|
||||
- If you want to [Gravatar](https://en.gravatar.com/), fill in your email in the `gravatar` field. Otherwise, leave it blank or it will override the avatar setting.
|
||||
- If you want to [Gravatar](https://en.gravatar.com/), fill in your email in the `gravatar` field. Otherwise, leave it blank in case it overrides the avatar setting.
|
||||
|
||||
- The `social_links` field accepts an array of links which are either shown as text link or icon link:
|
||||
- Text link
|
||||
```yml
|
||||
social_links:
|
||||
Facebook: http://facebook.com
|
||||
Twitter: http://twitter.com
|
||||
```
|
||||
- Icon link
|
||||
```yml
|
||||
social_links:
|
||||
Facebook:
|
||||
icon: fab fa-facebook
|
||||
url: http://facebook.com
|
||||
Twitter:
|
||||
icon: fab fa-twitter
|
||||
url: http://twitter.com
|
||||
```
|
||||
The `icon` here refers to the [Font Awesome](https://fontawesome.com/) icon class name by default, which you can find in the Font Awesome icon details page.
|
||||
- The `social_links` field accepts an array of links which are either shown as a text link or icon link. The details are described in {% post_link theme/Polymorphic-Link-Settings %}.
|
||||
|
||||
<a style="background-color:black;color:white;text-decoration:none;padding:4px 6px;font-size:12px;line-height:1.2;display:inline-block;border-radius:3px" href="https://unsplash.com/@joeypilgrim?utm_medium=referral&utm_campaign=photographer-credit&utm_content=creditBadge" target="_blank" rel="noopener noreferrer" title="Download free do whatever you want high-resolution photos from Joey Pilgrim"><span style="display:inline-block;padding:2px 3px"><svg xmlns="http://www.w3.org/2000/svg" style="height:12px;width:auto;position:relative;vertical-align:middle;top:-1px;fill:white" viewBox="0 0 32 32"><title>unsplash-logo</title><path d="M20.8 18.1c0 2.7-2.2 4.8-4.8 4.8s-4.8-2.1-4.8-4.8c0-2.7 2.2-4.8 4.8-4.8 2.7.1 4.8 2.2 4.8 4.8zm11.2-7.4v14.9c0 2.3-1.9 4.3-4.3 4.3h-23.4c-2.4 0-4.3-1.9-4.3-4.3v-15c0-2.3 1.9-4.3 4.3-4.3h3.7l.8-2.3c.4-1.1 1.7-2 2.9-2h8.6c1.2 0 2.5.9 2.9 2l.8 2.4h3.7c2.4 0 4.3 1.9 4.3 4.3zm-8.6 7.5c0-4.1-3.3-7.5-7.5-7.5-4.1 0-7.5 3.4-7.5 7.5s3.3 7.5 7.5 7.5c4.2-.1 7.5-3.4 7.5-7.5z"></path></svg></span><span style="display:inline-block;padding:2px 3px">Joey Pilgrim</span></a>
|
||||
|
|
@ -0,0 +1,40 @@
|
|||
title: Sidebar Widgets Overview
|
||||
date: 2018-01-31
|
||||
categories:
|
||||
- Widgets
|
||||
---
|
||||
|
||||
With the brand-new widget configuration scheme, you can place any widgets on either side of the page and set up them fair easily. Icarus reads the list of widgets that are enabled from `_config.yml` and displays them in the order they are defined. The following widgets are supported in Icarus 2.0.0:
|
||||
|
||||
- Archives (archive)
|
||||
- Categories (category)
|
||||
- Links (links)
|
||||
- Profiles (profile)
|
||||
- Recent Posts (recent_posts)
|
||||
- Tags (tag)
|
||||
- Tag Cloud (tagcloud)
|
||||
- Table of Content / Catalogue (toc)
|
||||
<!-- more -->
|
||||
|
||||
The enabled widgets are defined as an array. Each widget has two mandatory fields in common: `type` and `position`. The `type` field specific what widget is enabled and can be one of the `(name)` above. The position can be either `left` or `right`, which tells on which side will the widget be placed.
|
||||
|
||||
```yml
|
||||
widgets:
|
||||
-
|
||||
type: category
|
||||
position: left
|
||||
-
|
||||
type: tagcloud
|
||||
position: left
|
||||
-
|
||||
type: recent_posts
|
||||
position: right
|
||||
-
|
||||
type: archive
|
||||
position: right
|
||||
-
|
||||
type: tag
|
||||
position: right
|
||||
```
|
||||
|
||||
Most of these widgets do not take any extra configurations. However, for those who do, please refer to the [documentation](/hexo-theme-icarus/categories/Widgets/).
|
||||
|
|
@ -120,7 +120,10 @@ Please refer to the documentation for Icarus implementation details.
|
|||
|
||||
### :tada: Contribute
|
||||
|
||||
If you feel like to help us build a better Icarus, you can
|
||||
|
||||
- :electric_plug: Write a plugin
|
||||
- :black_nib: <a href="https://github.com/ppoffice/hexo-theme-icarus/new/site/source/_posts">Submit a tutorial</a>
|
||||
- :triangular_flag_on_post: <a href="https://github.com/ppoffice/hexo-theme-icarus/issues/new">Report a bug</a>
|
||||
- :earth_asia: <a href="https://github.com/ppoffice/hexo-theme-icarus/tree/master/languages">Add a translation</a>
|
||||
|
||||
|
|
|
|||
Binary file not shown.
|
After Width: | Height: | Size: 500 KiB |
|
|
@ -1 +1 @@
|
|||
Subproject commit 41f06e3d1435c741274fcda93a238ca4072533b2
|
||||
Subproject commit 17fa6f339fb60344e17a23f8b890ca56047bcf0b
|
||||
Loading…
Reference in New Issue