github
/
hexo-theme-icarus
mirror of https://github.com/ppoffice/hexo-theme-icarus
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

chore(doc): finish updating the rest zh-CN docs

pull/729/head
ppoffice 2020-05-15 23:50:35 -04:00
parent ea067fbf4c
commit d8fcdd8c55
4 changed files with 149 additions and 69 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
source/_posts/en/Web-Analytics-Plugins.md
View File

@ -144,7 +144,7 @@ Use them with caution.
3. Find the value of "Tracking ID", e.g., "UA-12345678-0", on the "Tracking Code" page.
Set it to the `plugins` >
`google_analytics` > `tracking_id` in the theme's configuration file to enable the Google Analytics plugin.
`google_analytics` > `tracking_id` in the theme configurations to enable the Google Analytics plugin.
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/google-analytics-get-code.png 360 '"Get Code - Google Analytics" "Get Code - Google Analytics"' %}
<br>

5
source/_posts/en/Widgets.md
View File

@ -266,7 +266,6 @@ To enable this widget, take the following steps:
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/feedburner-activate-email.png 360 '"Activate Email Subscription - Feedburner" "Activate Email Subscription - Feedburner"' %}
<br>
6. Find the following information in the HTML code on the "Email Subscription"
page:
@ -277,7 +276,7 @@ To enable this widget, take the following steps:
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/feedburner-get-code.png 360 '"Get Code - Feedburner" "Get Code - Feedburner"' %}
<br>
Copy the ID after `uri=` (e.g., `feedforall/ABCD`) to the `feedburner_id` setting of the widget configuration.
Copy the ID after `uri=` (e.g., `feedforall/ABCD`) to the `feedburner_id` setting of the widget configuration:
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -294,7 +293,7 @@ To enable this widget, take the following steps:
Create a new AD on [Google AdSense](https://www.google.com/adsense).
Then, copy the values of `data-ad-client` and `data-ad-slot` from the AD HTML code to
the `client_id` and `slot_id` setting of the widget, respectively.
the `client_id` and `slot_id` setting of the widget configuration, respectively.
Here is an example:
{% codeblock themes/icarus/_config.yml lang:yaml %}

113
source/_posts/zh-CN/Web-Analytics-Plugins.md
View File

@ -13,34 +13,46 @@ providers:
iconcdn: loli
---
<div class="notification is-success is-size-6">
本文同时提供以下语言的翻译：<a href="{% post_path en/Web-Analytics-Plugins %}">English</a>。
</div>
本文介绍Icarus 3支持的网站统计与分析插件的安装配置。
本文介绍Icarus 3支持的一些网站统计与分析插件的安装配置。
<article class="message message-immersive is-primary">
<div class="message-body">
<i class="fas fa-globe-americas mr-2"></i>本文同时提供以下语言的翻译：<a href="{% post_path en/Web-Analytics-Plugins %}">English</a>。
</div>
</article>
<!-- more -->
<div class="notification is-link is-size-6">
Icarus的网站统计与分析插件由[ppoffice/hexo-component-inferno](https://github.com/ppoffice/hexo-component-inferno)
提供，具体提供的插件种类与配置以其为准。
<article class="message message-immersive is-primary">
<div class="message-body">
<i class="fas fa-info-circle mr-2"></i>下面的网站统计与分析插件由<a href="https://github.com/ppoffice/hexo-component-inferno">ppoffice/hexo-component-inferno</a>提供，完整的支持插件列表和配置详情以其为准。
</div>
</article>
<div class="notification is-warning is-size-6">
本文中涉及的所有插件均可能被部分广告拦截浏览器扩展拦截，请酌情使用。
<article class="message message-immersive is-danger">
<div class="message-body">
<i class="fas fa-exclamation-triangle mr-2"></i>本文中涉及的所有插件均可能被部分广告拦截浏览器扩展拦截，请酌情使用。
</div>
</article>
## 百度统计
**安装指南**
1. 登录[百度统计](https://tongji.baidu.com)。在“网站列表”页面上点击“新增网站”按钮并填写你的Hexo站点的“网站域名”，“网站首页”
等信息，点击“确定”。
1. 登录[百度统计](https://tongji.baidu.com)。
在“管理 > 网站列表”页面上点击“新增网站”按钮并填写“网站域名”，“网站首页”等站点信息。
点击“确定”完成站点创建。
2. 在跳转到的“代码获取”页面中找到`hm.baidu.com/hm.js?`后引号内的一串ID并填写到主题配置的`plugins` > `baidu_analytics` >
`tracking_id`。例如如下的统计代码
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/baidu-analytics-add-site.png 360 '"新增站点 - Baidu Analytics" "新增站点 - Baidu Analytics"' %}
<br>
2. 在下一页面上找到`hm.baidu.com/hm.js?`后的ID并填写到主题配置的`plugins` > `baidu_analytics` >
`tracking_id`值中。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/baidu-analytics-get-code.png 360 '"获取代码 - Baidu Analytics" "获取代码 - Baidu Analytics"' %}
<br>
例如，如下的统计代码：
{% codeblock "百度统计代码" lang:html %}
<script>
@ -54,7 +66,7 @@ Icarus的网站统计与分析插件由[ppoffice/hexo-component-inferno](https:/
</script>
{% endcodeblock %}
对应的主题配置为
对应的主题配置为：
{% codeblock themes/icarus/_config.yml lang:yaml %}
plugins:
@ -67,7 +79,7 @@ Icarus的网站统计与分析插件由[ppoffice/hexo-component-inferno](https:/
**安装指南**
1. 将主题配置中的`plugins`部分下的`busuanzi`设置为`true`即可开启不蒜子访客计数器，在网站页面的尾部和每篇博文的头部展示访问次数。
1. 将`plugins` > `busuanzi`设置为`true`来开启不蒜子访客计数器并在网页尾部和每篇博文的头部展示访问次数。
{% codeblock themes/icarus/_config.yml lang:yaml %}
plugins:
@ -79,17 +91,27 @@ Icarus的网站统计与分析插件由[ppoffice/hexo-component-inferno](https:/
**安装指南**
1. 登录[友盟+](https://www.umeng.com/)，在友盟+工作台首页点击“创建新应用” > “Web应用”。然后输入“网站名称”，“网站域名”，
“网站首页”等信息，并点击“确认添加站点”。
1. 登录[友盟+](https://www.umeng.com/)。
在友盟+工作台首页点击“创建新应用” > “Web应用”。
然后输入“网站名称”，“网站域名”，“网站首页”等站点信息信息。
完成后点击“确认添加站点”。
2. 在跳转到的“统计代码“获取界面上找到”文字形式“的统计代码，并将其中`id`与`web_id`的值填写到主题配置的`plugins` > `cnzz` >
`id`和`web_id`。例如如下的统计代码
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/cnzz-add-site.png 360 '"添加站点 - CNZZ" "添加站点 - CNZZ"' %}
<br>
2. 在获取统计代码界面找到“文字样式”一栏下的HTML代码。
分别将其中`id`与`web_id`的值复制到主题配置的`plugins` > `cnzz` > `id`和`web_id`中。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/cnzz-get-code.png 360 '"获取代码 - CNZZ" "获取代码 - CNZZ"' %}
<br>
例如，如下的统计安装代码：
{% codeblock "CNZZ统计代码" lang:html %}
<script type="text/javascript" src="https://s9.cnzz.com/z_stat.php?id=123456789000&web_id=123456789000"></script>
{% endcodeblock %}
对应的主题配置为
对应的主题配置为：
{% codeblock themes/icarus/_config.yml lang:yaml %}
plugins:
@ -103,14 +125,26 @@ Icarus的网站统计与分析插件由[ppoffice/hexo-component-inferno](https:/
**安装指南**
1. 登录[Google Analytics](https://analytics.google.com/)。在进入用户主页后点击左侧导航栏下方的”管理“(Admin)进入管理界面。
1. 登录[Google Analytics](https://analytics.google.com/)并点击左侧的”管理“(Admin)进入管理界面。
2. 在管理界面上点击”创建资产“(Create Property)按钮，选择测量的应用类型(What do you want to measure?)为Web并点击”继续“。
然后填写网站的名称(Website Name)，URL地址(Website URL)，分类(Industry Category)，以及报告时区(Reporting Time Zone)等信息。
点击”创建“(Create)。
2. 在管理界面上点击”创建资产“(Create Property)按钮，选择“测量的应用类型”(What do you want to measure?)为Web。
然后点击”继续“(Continue)按钮。
3. 在之后的”追踪代码“(Tracking Code)界面上找到"Tracking ID"的值，例如"UA-12345678-0"，填写到主题配置的`plugins` >
`google_analytics` > `tracking_id`即可完成配置。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/google-analytics-create-property.png 360 '"创建资产 - Google Analytics" "创建资产 - Google Analytics"' %}
<br>
3. 然后，填写“网站名称”(Website Name)，“URL地址”(Website URL)，“行业分类”(Industry Category)，以及“报告时区”
(Reporting Time Zone)等信息。
点击”创建“(Create)按钮完成资产创建。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/google-analytics-property-setup.png 360 '"资产设置 - Google Analytics" "资产设置 - Google Analytics"' %}
<br>
4. 在”追踪代码“(Tracking Code)界面上找到"Tracking ID"的值，例如"UA-12345678-0".
将其填写到主题配置的`plugins` > `google_analytics` > `tracking_id`即可开启Google Analytics插件。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/google-analytics-get-code.png 360 '"获取代码 - Google Analytics" "获取代码 - Google Analytics"' %}
<br>
{% codeblock themes/icarus/_config.yml lang:yaml %}
plugins:
@ -123,12 +157,23 @@ Icarus的网站统计与分析插件由[ppoffice/hexo-component-inferno](https:/
**安装指南**
1. 登录[Hotjar](https://www.hotjar.com/)，点击页面左上角的➕(加号)菜单中的”添加新站点“(Add new site)链接。
1. 登录[Hotjar](https://www.hotjar.com/)，点击页面左上角的➕(加号) > ”添加新站点“(Add new site)链接。
2. 填写”网站地址“(WEBSITE)，”站点类型“(SITE TYPE)，和”站点所有者“(SITE OWNER)，然后点击”添加站点“(Add Site)按钮。
3. 在跳转到的”站点&组织“(Sites & Organizations)页面找到新建的站点项，点击其右侧的”追踪代码“(Tracking Code)按钮并在弹出的
对话框中找到"Site ID"的值，例如"1234567"，填写到主题配置的`plugins` > `hotjar` > `site_id`即可完成配置。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/hotjar-new-site.png 360 '"新建站点 - Hotjar" "新建站点 - Hotjar"' %}
<br>
3. 在重定向到的”站点&组织“(Sites & Organizations)页面找到新建的站点。
点击右侧的”追踪代码“(Tracking Code)按钮。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/hotjar-site-list.png 360 '"站点列表 - Hotjar" "站点列表 - Hotjar"' %}
<br>
4. 复制弹出对话框中"Site ID"的值(如"1234567")到主题配置的`plugins` > `hotjar` > `site_id`来启用Hotjar插件。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/hotjar-get-code.png 360 '"获取代码 - Hotjar" "获取代码 - Hotjar"' %}
<br>
{% codeblock themes/icarus/_config.yml lang:yaml %}
plugins:
@ -137,6 +182,8 @@ Icarus的网站统计与分析插件由[ppoffice/hexo-component-inferno](https:/
{% endcodeblock %}
<div class="notification is-warning is-size-6">
文章内容有误？请点击<a href="https://github.com/ppoffice/hexo-theme-icarus/edit/site/source/_posts/zh-CN/Web-Analytics-Plugins.md">此处</a>提交修改。
<article class="message message-immersive is-warning">
<div class="message-body">
<i class="fas fa-question-circle mr-2"></i>文章内容有误？请点击<a href="https://github.com/ppoffice/hexo-theme-icarus/edit/site/source/_posts/zh-CN/Web-Analytics-Plugins.md">此处</a>提交修改。
</div>
</article>

98
source/_posts/zh-CN/Widgets.md
View File

@ -59,11 +59,11 @@ providers:
iconcdn: loli
---
<div class="notification is-success is-size-6">
本文同时提供以下语言的翻译：<a href="{% post_path en/Widgets %}">English</a>。
</div>
本文介绍Icarus 3支持的一些页面挂件的安装配置。若需同时展示多个挂件，只需在主题配置的`widgets`数组中添加多个挂件配置，而他们的展示顺序以配置的定义顺序为准。而每项挂件均包含必填项`type`(挂件类型)与`position`(挂件展示位置：左边/右边)。例如
本文介绍Icarus 3支持的页面挂件的安装配置。
若要同时展示多个挂件，只需在主题配置的`widgets`数组中添加多个挂件配置。
它们会按照定义的顺序出现。
每个挂件必须包含`type`(挂件类型)与`position`(挂件展示位置)设置项。
示例如下：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -77,20 +77,25 @@ widgets:
...
{% endcodeblock %}
<article class="message message-immersive is-primary">
<div class="message-body">
<i class="fas fa-globe-americas mr-2"></i>本文同时提供以下语言的翻译：<a href="{% post_path en/Widgets %}">English</a>。
</div>
</article>
<!-- more -->
<div class="notification is-link is-size-6">
Icarus的绝大部分挂件由[ppoffice/hexo-component-inferno](https://github.com/ppoffice/hexo-component-inferno)
提供，具体提供的挂件种类与配置以其为准。
<article class="message message-immersive is-primary">
<div class="message-body">
<i class="fas fa-info-circle mr-2"></i>下面的挂件由<a href="https://github.com/ppoffice/hexo-component-inferno">ppoffice/hexo-component-inferno</a>提供，完整的支持挂件列表和配置详情以其为准。
</div>
</article>
## 作者资料卡
你可以启用作者资料卡挂件来展示文章作者/网站站长的信息。资料卡的示例配置如下所示：
你可以启用作者资料卡挂件来展示文章作者/网站站长的信息。
资料卡的配置如下所示：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -121,15 +126,16 @@ widgets:
需要注意的是：
- 如果你希望使用[Gravatar](https://en.gravatar.com/)提供头像图片，请在`gravatar`项填入
你的Gravatar邮箱地址，而`avatar`一项请留空；
- 如果你希望使用[Gravatar](https://en.gravatar.com/)而不是`avatar`配置项作为头像图片，请在`gravatar`项填入
你的Gravatar邮箱地址并在`avatar`一项中留空；
- `social_links`可以采用如下两种格式：
**图标形式**：
{% codeblock social_links lang:yaml %}
<链接名称>:
icon: <FontAwesome5图标的HTML class名称>
icon: <FontAwesome5_图标的_HTML_class名称>
url: <链接的URL地址>
{% endcodeblock %}
@ -142,7 +148,7 @@ widgets:
## 文章目录
若要展示文章目录，请首先在主题配置文件中添加如下挂件配置：
若要展示文章目录，请在主题配置中添加如下挂件配置：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -163,7 +169,8 @@ toc: true
## 友站链接
你可以展示友站链接挂件展示相关网站以及它们的链接。友站链接挂件的配置如下所示：
你可以使用友站链接挂件来展示外部网站的列表。
示例配置如下所示：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -179,7 +186,7 @@ widgets:
## 最新文章
请通过如下挂件配置开启最新文章挂件：
使用如下挂件配置来开启最新文章挂件：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -191,7 +198,7 @@ widgets:
## 文章归档
请通过如下挂件配置开启文章归档挂件：
使用如下挂件配置来开启文章归档挂件：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -203,7 +210,7 @@ widgets:
## 文章分类
请通过如下挂件配置开启文章分类挂件：
使用如下挂件配置来开启文章分类挂件：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -215,7 +222,7 @@ widgets:
## 文章标签
请通过如下挂件配置开启文章标签挂件：
使用如下挂件配置来开启文章标签挂件：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -228,21 +235,45 @@ widgets:
## 邮件订阅
Icarus的邮件订阅功能由Google Feedburner提供。
按照如下步骤即可启用此插件：
1. 若要开启邮件订阅挂件，请首先使用诸如[hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed)
的Hexo插件生成网站的RSS源。
1. 首先，使用诸如[hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed)此类的Hexo插件生成
你的Hexo网站的RSS源。
2. 然后登录[Google Feedburner](https://feedburner.google.com)并添加你的RSS源。完成配置后，请点击网页顶部的”我的源“
(My Feeds)查看源列表，并点击新添加的源进入源的配置界面。
2. 然后登录[Google Feedburner](https://feedburner.google.com)，在输入框内输入你的RSS地址并点击“下一步”(Next)
来添加你的RSS源。
3. 点击”宣传“(Publicize)标签页，然后点击页面左侧的”邮件订阅“(Email Subscription)，然后在页面右侧找到并点击”激活“(Activate)
按钮。在打开的”邮件订阅“(Email Subscription)页面的HTML代码中找到
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/feedburner-homepage.png 360 '"主页 - Feedburner" "主页 - Feedburner"' %}
<br>
3. 然后，在下一页中填写“源标题”。
点击“下一步”(Next)来继续自定义你的源，或者点击“直接跳到源管理”(Skip directly to feed management)来完成配置。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/feedburner-add-feed.png 360 '"添加源 - Feedburner" "添加源 - Feedburner"' %}
<br>
4. 完成添加源后，点击网页顶部的”我的源“(My Feeds)链接。
点击“我的源”(My Feeds)页面上新添加的源。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/feedburner-feed-list.png 360 '"源列表 - Feedburner" "源列表 - Feedburner"' %}
<br>
5. 切换到”宣传“(Publicize)标签页并点击页面左侧的”邮件订阅“(Email Subscription)链接。
点击“激活”(Activate)按钮来开启“邮件订阅”(Email Subscription)功能。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/feedburner-activate-email.png 360 '"激活邮件订阅 - Feedburner" "激活邮件订阅 - Feedburner"' %}
<br>
6. 在”邮件订阅“(Email Subscription)页面上从HTML代码中找到如下信息：
{% codeblock Google Feedburner URL %}
https://feedburner.google.com/fb/a/mailverify?uri=******
{% endcodeblock %}
复制`uri=`后的ID，例如`feedforall/ABCD`并填入挂件配置的`feedburner_id`中。
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/feedburner-get-code.png 360 '"获取代码 - Feedburner" "获取代码 - Feedburner"' %}
<br>
复制`uri=`后的ID(如`feedforall/ABCD`)到挂件配置的`feedburner_id`设置中：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -257,8 +288,9 @@ Icarus的邮件订阅功能由Google Feedburner提供。
## Google AdSense
请登录[Google AdSense](https://www.google.com/adsense)并新建广告，复制广告代码中的`data-ad-client`和`data-ad-slot`
分别填入到挂件配置的`client_id`和`slot_id`项中。示例如下：
在[Google AdSense](https://www.google.com/adsense)上新建广告。
然后，复制广告HTML代码中的`data-ad-client`和`data-ad-slot`值分别填入到挂件配置的`client_id`和`slot_id`项中。
示例如下：
{% codeblock themes/icarus/_config.yml lang:yaml %}
widgets:
@ -270,6 +302,8 @@ widgets:
{% endcodeblock %}
<div class="notification is-warning is-size-6">
文章内容有误？请点击<a href="https://github.com/ppoffice/hexo-theme-icarus/edit/site/source/_posts/zh-CN/Widgets.md">此处</a>提交修改。
<article class="message message-immersive is-warning">
<div class="message-body">
<i class="fas fa-question-circle mr-2"></i>文章内容有误？请点击<a href="https://github.com/ppoffice/hexo-theme-icarus/edit/site/source/_posts/zh-CN/Widgets.md">此处</a>提交修改。
</div>
</article>