413 lines
12 KiB
Markdown
413 lines
12 KiB
Markdown
title: Icarus用户指南 - 其他插件
|
||
date: 2016-01-01
|
||
categories:
|
||
- Plugins
|
||
- Other
|
||
tags:
|
||
- Icarus用户指南
|
||
language: zh-CN
|
||
toc: true
|
||
plugins:
|
||
animejs: true
|
||
back_to_top: true
|
||
cookie_consent:
|
||
type: info
|
||
theme: classic
|
||
static: false
|
||
position: bottom
|
||
policyLink: 'https://www.cookiesandyou.com/'
|
||
gallery: true
|
||
google_analytics:
|
||
tracking_id: UA-72437521-5
|
||
mathjax: true
|
||
outdated_browser: true
|
||
progressbar: true
|
||
providers:
|
||
cdn: loli
|
||
fontcdn: loli
|
||
iconcdn: loli
|
||
---
|
||
|
||
本文介绍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/Other-Plugins %}">English</a>。
|
||
</div>
|
||
</article>
|
||
|
||
<!-- more -->
|
||
|
||
<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>
|
||
|
||
## 画廊
|
||
|
||
**安装指南**
|
||
|
||
Icarus的画廊插件同时包含了[lightGallery](https://sachinchoolur.github.io/lightGallery/)与
|
||
[Justified Gallery](https://miromannino.github.io/Justified-Gallery/)两种插件。
|
||
若要启用画廊插件，请将主题配置中`plugins` > `gallery`的值设置为`true`。
|
||
|
||
{% codeblock _config.icarus.yml lang:yaml %}
|
||
plugins:
|
||
gallery: true
|
||
{% endcodeblock %}
|
||
|
||
此外，若要使用Justified Gallery，请将你的图片包裹在`<div class="justified-gallery">`与`</div>`的HTML标签对中。
|
||
并且如果你使用的是Markdown语法来引用图片的话，请在HTML标签和Markdown之间添加空行。
|
||
例如，下方画廊预览的Markdown代码为：
|
||
|
||
{% codeblock "Justified-Gallery-Markdown.md" lang:markdown >folded %}
|
||
<div class="justified-gallery">
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
{% endcodeblock %}
|
||
|
||
同样，我们也可使用纯HTML来创建Justified Gallery。
|
||
这种情况下HTML标签之间就不需要添加空行了：
|
||
|
||
{% codeblock "Justified-Gallery-HTML.md" lang:html >folded %}
|
||
<div class="justified-gallery">
|
||
<img src="/hexo-theme-icarus/gallery/animals/elephant.jpeg" alt="Elephant" />
|
||
<img src="/hexo-theme-icarus/gallery/animals/dog.jpeg" alt="Dog" />
|
||
<img src="/hexo-theme-icarus/gallery/animals/birds.jpeg" alt="Birds" />
|
||
<img src="/hexo-theme-icarus/gallery/animals/fox.jpeg" alt="Fox" />
|
||
<img src="/hexo-theme-icarus/gallery/animals/horse.jpeg" alt="Horse" />
|
||
<img src="/hexo-theme-icarus/gallery/animals/leopard.jpeg" alt="Leopard" />
|
||
</div>
|
||
{% endcodeblock %}
|
||
|
||
|
||
**效果预览**
|
||
|
||
下面是Justified Gallery实现的图片网格。
|
||
你也可以点击其中的任意图片查看lightGallery的全图展示效果。
|
||
|
||
<article class="message message-immersive is-primary">
|
||
<div class="message-body">
|
||
<i class="fas fa-info-circle mr-2"></i>下面的图片来源于<a href="https://www.pexels.com">pexel.com</a>
|
||
</div>
|
||
</article>
|
||
|
||
<div class="justified-gallery">
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
|
||
## KaTeX
|
||
|
||
**安装指南**
|
||
|
||
你可以使用KaTeX插件来渲染\\(\TeX\\)数学公式。
|
||
若要启用KaTeX插件，请将主题配置中`plugins` > `katex`的值设置为`true`。
|
||
|
||
{% codeblock _config.icarus.yml lang:yaml %}
|
||
plugins:
|
||
katex: true
|
||
{% endcodeblock %}
|
||
|
||
请使用`\\(`和`\\)`包裹你的行内公式，使用`$$`或`\\[`与`\\]`标签对包裹块状公式。
|
||
例如：
|
||
|
||
{% codeblock Some-Post.md lang:markdown >folded %}
|
||
这是一个行内公式：\\(ax^2+bx+c=0\\)。
|
||
|
||
这是一个块状公式：
|
||
$$\displaystyle \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
|
||
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
|
||
{1+\frac{e^{-8\pi}} {1+\cdots} } } }$$
|
||
|
||
这是另一个块状公式：
|
||
\\[f(x) = \int_{-\infty}^\infty\hat f(\xi)e^{2 \pi i \xi x}d\xi\\]
|
||
{% endcodeblock %}
|
||
|
||
有时你的\\(\TeX\\)语法会被错认为Markdown语法而导致公式渲染异常。
|
||
例如，下面的公式不会渲染成功，因为其中包含多个`_`(下划线)而被Markdown渲染器错误的认成Markdown的斜体字语法：
|
||
|
||
{% codeblock Some-Post.md lang:tex %}
|
||
$$
|
||
\hat{x}_{k}=\hat{x}_{k}^{-}+K_{t}\left(y_{k}\right)
|
||
$$
|
||
{% endcodeblock %}
|
||
|
||
在这种情况下，你可以选择转义每个可能导致歧义的字符：
|
||
|
||
{% codeblock Some-Post.md lang:tex %}
|
||
$$
|
||
\hat{x}\_{k}=\hat{x}\_{k}^{-}+K\_{t}\left(y\_{k}\right)
|
||
$$
|
||
{% endcodeblock %}
|
||
|
||
或是简单地将整个公式用一个额外的HTML标签对包裹起来：
|
||
|
||
{% codeblock Some-Post.md lang:tex %}
|
||
<div>
|
||
$$
|
||
\hat{x}_{k}=\hat{x}_{k}^{-}+K_{t}\left(y_{k}\right)
|
||
$$
|
||
</div>
|
||
{% endcodeblock %}
|
||
|
||
|
||
## MathJax
|
||
|
||
**安装指南**
|
||
|
||
你可以使用MathJax插件来渲染\\(\TeX\\)，MathML，或AsciiMath数学公式。
|
||
若要启用MathJax插件，请将主题配置中`plugins` > `mathjax`的值设置为`true`。
|
||
|
||
{% codeblock _config.icarus.yml lang:yaml %}
|
||
plugins:
|
||
mathjax: true
|
||
{% endcodeblock %}
|
||
|
||
当使用\\(\TeX\\)语法时，请使用`$`或`\\(`与`\\)`包裹行内公式，`$$`或`\\[`与`\\]`标签对包裹块状公式。
|
||
或者使用\\(\LaTeX\\)环境。例如：
|
||
|
||
{% codeblock Tex-Example.md lang:markdown >folded %}
|
||
这是一个行内公式：\\(ax^2+bx+c=0\\)。这是另一个行内公式：$ax^2+bx+c>0$。
|
||
|
||
这是一个块状公式：
|
||
$$\displaystyle \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
|
||
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
|
||
{1+\frac{e^{-8\pi}} {1+\cdots} } } }$$
|
||
|
||
这是另一个块状公式：
|
||
\\[f(x) = \int_{-\infty}^\infty\hat f(\xi)e^{2 \pi i \xi x}d\xi\\]
|
||
|
||
或者使用\\(\LaTeX\\)环境：
|
||
\\begin{equation}
|
||
A =
|
||
\\begin{bmatrix}
|
||
a & b \\\\
|
||
c & c
|
||
\\end{bmatrix}
|
||
\\end{equation}
|
||
{% endcodeblock %}
|
||
|
||
或者直接使用MathML语法。例如：
|
||
|
||
{% codeblock MathML-Example.md lang:html >folded %}
|
||
当
|
||
<math xmlns="http://www.w3.org/1998/Math/MathML">
|
||
<mi>a</mi>
|
||
<mo>≠</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>-</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>
|
||
{% endcodeblock %}
|
||
|
||
同样地，你也可以使用MathJax支持的AsciiMath。
|
||
公式需包裹在<code>\\`</code>内。
|
||
|
||
{% codeblock AsciiMath-Example.md lang:markdown >folded %}
|
||
当\`a != 0\`，方程\`ax^2 + bx + c = 0\`有两个解，它们是<p style="text-align:center">\`x = (-b +- sqrt(b^2-4ac))/(2a)\`.</p>
|
||
{% endcodeblock %}
|
||
|
||
有时你的\\(\TeX\\)语法会被错认为Markdown语法而导致公式渲染异常。
|
||
请参照[KaTeX](#KaTeX)一节来查看解决方案。
|
||
|
||
**效果预览(\\(\TeX\\) & \\(\LaTeX\\))**
|
||
|
||
这是一个行内公式：\\(ax^2+bx+c=0\\)。这是另一个行内公式：$ax^2+bx+c>0$。
|
||
|
||
这是一个块状公式：
|
||
$$\displaystyle \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
|
||
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
|
||
{1+\frac{e^{-8\pi}} {1+\cdots} } } }$$
|
||
|
||
这是另一个块状公式：
|
||
\\[f(x) = \int_{-\infty}^\infty\hat f(\xi)e^{2 \pi i \xi x}d\xi\\]
|
||
|
||
或者使用\\(\LaTeX\\)环境：
|
||
\\begin{equation}
|
||
A =
|
||
\\begin{bmatrix}
|
||
a & b \\\\
|
||
c & c
|
||
\\end{bmatrix}
|
||
\\end{equation}
|
||
|
||
**效果预览(MathML)**
|
||
|
||
当
|
||
<math xmlns="http://www.w3.org/1998/Math/MathML">
|
||
<mi>a</mi>
|
||
<mo>≠</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>-</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)**
|
||
|
||
当\`a != 0\`，方程\`ax^2 + bx + c = 0\`有两个解，它们是<p style="text-align:center">\`x = (-b +- sqrt(b^2-4ac))/(2a)\`.</p>
|
||
|
||
|
||
## Cookie同意提示
|
||
|
||
**安装指南**
|
||
|
||
你可以通过启用Cookie同意提示插件来向你的访客展示Cookie同意对话框。
|
||
请参考[下载Cookie Consent](https://www.osano.com/cookieconsent/download/)和[Cookie Consent插件文档](https://www.osano.com/cookieconsent/documentation/about-cookie-consent/)来了解每个配置项的细节。
|
||
你也可以通过注释掉配置的方式来禁用Cookie同意对话框。
|
||
|
||
{% codeblock _config.icarus.yml lang:yaml %}
|
||
plugins:
|
||
cookie_consent:
|
||
# 同意对话框类型。可以为"info"，"opt-in"，或"opt-out"
|
||
type: info
|
||
# 弹出框主题。可以为"block"，"edgeless"，或"classic"
|
||
theme: edgeless
|
||
# 是否使弹出框固定，不随页面滚动而滚动
|
||
static: false
|
||
# 弹出框在屏幕上的位置
|
||
position: bottom-left
|
||
# 你网站的Cookie协议的URL
|
||
policyLink: 'https://www.cookiesandyou.com/'
|
||
{% endcodeblock %}
|
||
|
||
|
||
## 浏览器升级提醒 (Outdated Browser)
|
||
|
||
**安装指南**
|
||
|
||
你可以使用浏览器升级提醒(Outdated Browser)插件来检测你的网站访客使用的老旧浏览器，并提醒他们升级浏览器。
|
||
若要启用此插件，请将主题配置中`plugins` > `outdated_browser`的值设置为`true`。
|
||
点击[此处](https://bestvpn.org/outdatedbrowser/en)即可预览插件开启效果。
|
||
|
||
{% codeblock _config.icarus.yml lang:yaml %}
|
||
plugins:
|
||
outdated_browser: true
|
||
{% endcodeblock %}
|
||
|
||
|
||
## 网页载入动画
|
||
|
||
**安装指南**
|
||
|
||
Icarus默认启用网页载入动画。
|
||
若需禁止载入动画，请在你的主题配置中将`plugins` > `animejs`设置为`false`。
|
||
|
||
{% codeblock _config.icarus.yml lang:yaml %}
|
||
plugins:
|
||
animejs: false
|
||
{% endcodeblock %}
|
||
|
||
另外，若需禁用网页载入进度条，请在你的主题配置中将`plugins` > `progressbar`设置为`false`。
|
||
|
||
{% codeblock _config.icarus.yml lang:yaml %}
|
||
plugins:
|
||
progressbar: false
|
||
{% endcodeblock %}
|
||
|
||
|
||
<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/Other-Plugins.md">此处</a>提交修改。
|
||
</div>
|
||
</article>
|