ICARUS主题中文文档 · 插件与部件

原文来自PPOfficeICARUS主题文档,由猫梨(nek0ri)进行英译中的翻译,本文档翻译遵循MIT协议。

译者水平有限,另时间较为仓促,若其中存在错误,期待您的指正!

我的个人网页:nek0ri.de

个人邮箱:nek0ri@outlook.com

ICARUS主题文档(插件与部件篇)

图 / 不详(侵删)

注:带“*”为进阶操作,主题配置文件themes目录下Icarus文件夹内的_config.yml文件。


插件

1. 评论

官方文档已经列出了内置的所有评论插件,你可点击这里前往官方文档,选中想要使用的评论插件后点击相应的Installation instructions,即可前往相应评论插件的官方教程处。


2. 捐赠

想要开启在文章内容下方的捐赠按钮,你需找到主题配置文件(即_config.yml)。目前Icarus支持以下捐赠入口,你可始终在你的博客使用一个或多个捐赠入口。

支付宝

donate:
    -
        type: alipay
        qrcode: # 指向你二维码图片的路径或链接

微信

donate:
    -
        type: wechat
        qrcode: # 指向你二维码图片的路径或链接

Paypal

你需要首先开启Paypal Donate Button。当你完成操作后请留意businesscurrency_code并将他们填入_config.yml

donate:
    -
        type: paypal
        business: # 你Paypal的邮箱地址或者生成的business ID
        currency_code: # currency code

Patreon

donate:
    -
        type: patreon
        url: # 指向你Patreon页面的URL

3. 常规

3.1 站点分析插件

官方文档已经列出了内置的所有分析插件,你可点击这里前往官方文档,选中想要使用的分析插件后点击相应的Installation instructions,即可前往相应分析插件的官方教程处。


3.2 MathJax插件

f(a)=12πiγf(z)zadz

配置

要开启MathJax支持,你只需在主题配置文件中设置plugins.mathjax = true

# Plugins
plugins:
    ...
    mathjax: true # options: true, false

需要更多MathJax配置,请编辑/layout/plugin/mathjax.ejs

document.addEventListener('DOMContentLoaded', function () {
    MathJax.Hub.Config({
        // Edit here
    });
});

TeX和LaTeX输入

注意:请留意,当你在markdown文件中写TeX或LaTeX时,你需要用转义字符来防止某个符号被markdown解释程序处理。

输入

$a \ne 0$,\\(ax^2 + bx + c = 0\\) 有两个解,他们是
$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$

结果

当 $a \ne 0$,\(ax^2 + bx + c = 0\) 有两个解,他们是
$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$

MathML输入

注意:请留意,换行符可能会被markdown解释程序转化为标签,这回干涉MathML的注释,因此请在一行内写完MathML。

输入

<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mo>&#x2260;</mo><mn>0</mn></math><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><msup><mi>x</mi><mn>2</mn></msup><mo>+</mo> <mi>b</mi><mi>x</mi><mo>+</mo> <mi>c</mi> <mo>=</mo> <mn>0</mn></math> 有两个解,他们是
<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>x</mi> <mo>=</mo><mrow><mfrac><mrow><mo>&#x2212;</mo><mi>b</mi><mo>&#x00B1;</mo><msqrt><msup><mi>b</mi><mn>2</mn></msup><mo>&#x2212;</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>

结果

a0ax2+ bx+ c = 0 有两个解,他们是
x =b±b24ac 2a .

AsciiMath输入

注意:请留意,当你在markdown文件中写AsciiMath的时候,你需要用转义字符来防止某个符号被markdown解释程序处理。

输入

当 \`a != 0\`,\`ax^2 + bx + c = 0\`有两个解,他们是<p style="text-align:center">\`x = (-b +- sqrt(b^2-4ac))/(2a) .\`</p>

结果

当 `a != 0`,`ax^2 + bx + c = 0`有两个解,他们是

`x = (-b +- sqrt(b^2-4ac))/(2a) .`


3.2 图库(Gallery)插件

主题配置文件(即_config.yml)中开启图库插件后,你只需在文章中添加一些图片即可创建图库:

plugins:
    gallery: true

此外,你还可以用齐行的图库(Justified Gallery)来展示网格化的照片集:

&lt;div class="justified-gallery"&gt;
&lt;!-- 在这里需要一行空行来使得以下的markdown被显示 -->
![Elephant](/hexo-theme-icarus/gallery/animals/elephant.jpeg)
![Dog](/hexo-theme-icarus/gallery/animals/dog.jpeg)
![Birds](/hexo-theme-icarus/gallery/animals/birds.jpeg)
![Cat](/hexo-theme-icarus/gallery/animals/cat.jpeg)
![Fox](/hexo-theme-icarus/gallery/animals/fox.jpeg)
![Horse](/hexo-theme-icarus/gallery/animals/horse.jpeg)
![Leopard](/hexo-theme-icarus/gallery/animals/leopard.jpeg)
&lt;/div&gt;

由于本站(nek0ri.de)所有图片都使用图床,因此不便显示效果。效果请点击这里前往主题官方文档查看。


4. 搜索

官方文档已经列出了内置的所有搜索插件,你可点击这里前往官方文档,选中想要使用的搜索插件后点击相应的Installation instructions,即可前往相应搜索插件的官方教程处。


5. 分享

官方文档已经列出了内置的所有分享插件,你可点击这里前往官方文档,选中想要使用的分享插件后点击相应的Installation instructions,即可前往相应分享插件的官方教程处。



部件

个人档案侧边栏部件

Icarus以个人档案侧边栏部件的方式为你提供了一种展示你自己的方式。若要使用这一部件,请在你主题配置文件下部件的区域添加以下几行:

-
    type: profile
    position: # 在左边或右边展示
    author: # 你的名字
    author_title: # 你的主题(描述)
    location: # 你在哪里
    avatar: # 你头像的路径或者URL
    gravatar: # 你gravatar的邮箱地址
    follow_link: # 任何你想前往的路径或URL
    social_links: # 在此处添加你社交网站的链接

你需要注意两件事情:

  • 如果你想使用Gravatar,那就在gravatar区域填上你注册时的邮箱地址。否则,就让它空着,以防和你头像的设置起冲突。
  • social_links区域可以有大量的文字链接或者图标链接,你可以前往ICARUS主题中文文档 · 配置多样的链接设置查看详情。

侧边栏部件一览

由于这一全新的部件配置体系,你可以在页面任意一边轻易的设置部件。Icarus在部件已经定义的情况下,会读取在主题配置文件下已经启用的部件的列表,并将他们有序的显示出来。在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) #目录表

启用的部件会被定为一个队列,每个部件通常都有两个规定的区域:type(类型)和position(位置)。type(类型)区域明确被启用的部件,并且是以上内容的某个名称。一个部件的位置可以在left(左侧)或者right(右侧)。

widgets:
    -
        type: category
        position: left
    -
        type: tagcloud
        position: left
    -
        type: recent_posts
        position: right
    -
        type: archive
        position: right
    -
        type: tag
        position: right

这些部件大多都没有额外的配置。然而当你需要额外的配置,请参考之前的内容。


链接(Links)侧边栏部件

你可以在开启这一部件之后,在侧边栏展示前往其他网站的链接。你只需添加以下的内容在主题配置文件widgets区域中即可启用:

-
    type: links
    position: left
    links:
        '网站名称': 'http://website/url'
        Hexo: 'https://hexo.io'
        PPOffice: 'https://github.com/ppoffice'

需要留意一点,链接部件只为网站名称URL建立列表,而URL显示在这一部件的右边。