Icarus用户指南 - 其他插件

本文介绍Icarus 3支持的其他插件的安装配置。

本文同时提供以下语言的翻译:English

画廊

安装指南

Icarus的画廊插件同时包含了lightGalleryJustified Gallery两种插件。 若要启用画廊插件,请将主题配置中plugins > gallery的值设置为true

_config.icarus.yml
1
2
plugins:
gallery: true

此外,若要使用Justified Gallery,请将你的图片包裹在<div class="justified-gallery"></div>的HTML标签对中。 并且如果你使用的是Markdown语法来引用图片的话,请在HTML标签和Markdown之间添加空行。 例如,下方画廊预览的Markdown代码为:

Justified-Gallery-Markdown.md >folded
1
2
3
4
5
6
7
8
9
10
<div class="justified-gallery">

![Elephant](/hexo-theme-icarus/gallery/animals/elephant.jpeg)
![Dog](/hexo-theme-icarus/gallery/animals/dog.jpeg)
![Birds](/hexo-theme-icarus/gallery/animals/birds.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)

</div>

同样,我们也可使用纯HTML来创建Justified Gallery。 这种情况下HTML标签之间就不需要添加空行了:

Justified-Gallery-HTML.md >folded
1
2
3
4
5
6
7
8
<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>

效果预览

下面是Justified Gallery实现的图片网格。 你也可以点击其中的任意图片查看lightGallery的全图展示效果。

KaTeX

安装指南

你可以使用KaTeX插件来渲染\(\TeX\)数学公式。 若要启用KaTeX插件,请将主题配置中plugins > katex的值设置为true

_config.icarus.yml
1
2
plugins:
katex: true

请使用\\(\\)包裹你的行内公式,使用$$\\[\\]标签对包裹块状公式。 例如:

Some-Post.md >folded
1
2
3
4
5
6
7
8
9
这是一个行内公式:\\(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\\]

有时你的\(\TeX\)语法会被错认为Markdown语法而导致公式渲染异常。 例如,下面的公式不会渲染成功,因为其中包含多个_(下划线)而被Markdown渲染器错误的认成Markdown的斜体字语法:

Some-Post.md
1
2
3
$$
\hat{x}_{k}=\hat{x}_{k}^{-}+K_{t}\left(y_{k}\right)
$$

在这种情况下,你可以选择转义每个可能导致歧义的字符:

Some-Post.md
1
2
3
$$
\hat{x}\_{k}=\hat{x}\_{k}^{-}+K\_{t}\left(y\_{k}\right)
$$

或是简单地将整个公式用一个额外的HTML标签对包裹起来:

Some-Post.md
1
2
3
4
5
<div>
$$
\hat{x}_{k}=\hat{x}_{k}^{-}+K_{t}\left(y_{k}\right)
$$
</div>

MathJax

安装指南

你可以使用MathJax插件来渲染\(\TeX\),MathML,或AsciiMath数学公式。 若要启用MathJax插件,请将主题配置中plugins > mathjax的值设置为true

_config.icarus.yml
1
2
plugins:
mathjax: true

当使用\(\TeX\)语法时,请使用$\\(\\)包裹行内公式,$$\\[\\]标签对包裹块状公式。 或者使用\(\LaTeX\)环境。例如:

Tex-Example.md >folded
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
这是一个行内公式:\\(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语法。例如:

MathML-Example.md >folded
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

<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>

同样地,你也可以使用MathJax支持的AsciiMath。 公式需包裹在\`内。

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

有时你的\(\TeX\)语法会被错认为Markdown语法而导致公式渲染异常。 请参照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)

a 0 , 方程 a x 2 + b x + c = 0 有两个解,它们是 x = - b ± b 2 - 4 a c 2 a .

效果预览(AsciiMath)

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

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

Cookie同意提示

安装指南

你可以通过启用Cookie同意提示插件来向你的访客展示Cookie同意对话框。 请参考下载Cookie ConsentCookie Consent插件文档来了解每个配置项的细节。 你也可以通过注释掉配置的方式来禁用Cookie同意对话框。

_config.icarus.yml
1
2
3
4
5
6
7
8
9
10
11
12
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/'

浏览器升级提醒 (Outdated Browser)

安装指南

你可以使用浏览器升级提醒(Outdated Browser)插件来检测你的网站访客使用的老旧浏览器,并提醒他们升级浏览器。 若要启用此插件,请将主题配置中plugins > outdated_browser的值设置为true。 点击此处即可预览插件开启效果。

_config.icarus.yml
1
2
plugins:
outdated_browser: true

网页载入动画

安装指南

Icarus默认启用网页载入动画。 若需禁止载入动画,请在你的主题配置中将plugins > animejs设置为false

_config.icarus.yml
1
2
plugins:
animejs: false

另外,若需禁用网页载入进度条,请在你的主题配置中将plugins > progressbar设置为false

_config.icarus.yml
1
2
plugins:
progressbar: false
文章内容有误?请点击此处提交修改。
作者

PPOffice

发布于

2016-01-01

许可协议

CC BY-NC-SA 4.0

Your browser is out-of-date!

Update your browser to view this website correctly.&npsb;Update my browser now

×