title: Icarus用户指南 - CDN提供商
date: 2016-01-01
categories:
- Configuration
tags:
- Icarus用户指南
language: zh-CN
toc: true
providers:
    cdn: loli
    fontcdn: loli
    iconcdn: loli
---

<div class="notification is-success is-size-6">
本文同时提供以下语言的翻译：<a href="{% post_path en/CDN-Providers %}">English</a>。
</div>

选择合适的CDN提供商可以大幅度减少网站访客的网页加载时间。
Icarus为你提供了多种内置的CDN提供商来加快主题所用到的前端资源的加载。

<!-- more -->

<div class="notification is-link is-size-6">

Icarus的CDN相关功能由[ppoffice/hexo-component-inferno](https://github.com/ppoffice/hexo-component-inferno)
提供，具体提供的CDN提供商种类与配置以其为准。

</div>

## 内置CDN提供商

目前，Icarus提供如下几类内置的CDN服务提供商：

- **JavaScript库CDN**
    - cdnjs.com (`cdnjs`)
    - jsDelivr (`jsdelivr`)
    - UNPKG (`unpkg`)
    - loli.net (`loli`)
- **网络字体CDN**
    - Google Fonts (`google`)
    - loli.net (`loli`)
- **FontAwesome图标CDN**
    - FontAwesome 5 (`fontawesome`)
    - loli.net (`loli`)

默认的CDN服务提供商配置为：

{% codeblock themes/icarus/_config.yml lang:yaml %}
providers:
    cdn: jsdelivr
    fontcdn: google
    iconcdn: fontawesome
{% endcodeblock %}

## 自定义CDN提供商

除此之外，你还可以通过URL模板的方式使用自定义的CDN提供商。
每种类别提供商的模板格式如下文所示：

### JavaScript库CDN

{% codeblock "CDN URL模板" %}
https://some.cdn.domain.name/${package}/${version}/${filename}
{% endcodeblock %}

你需要将CDN URL中的包名称，版本号，和文件相对路径替换为`${package}`， `${version}`，和`${filename}`占位符来获取
CDN的URL模板。
例如，如下JavaScript的在UNPKG CDN上的URL地址

{% codeblock "UNPKG CDN URL示例" %}
https://unpkg.com/d3@5.7.0/dist/d3.min.js
{% endcodeblock %}

改写成的URL模板为

{% codeblock "UNPKG CDN URL模板" %}
https://unpkg.com/${package}@${version}/${filename}
{% endcodeblock %}

一些CDN提供商可能采用不同的URL形式，而在这些CDN上包名称或文件相对路径与其他CDN会有所不同。
例如，`moment.js`库在CDN.js上有着如下的URL形式：

{% codeblock "CDN.js CDN URL示例" %}
https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.22.2/moment.js
{% endcodeblock %}

但在UNPKG上有着这样的URL形式

{% codeblock "UNPKG CDN URL示例" %}
https://unpkg.com/moment@2.22.2/min/moment.min.js
{% endcodeblock %}

因此，你需要注意你的自定义CDN提供商的URL格式。
默认情况下，Icarus在URL模板中采用npm仓库的包名称和文件相对路径（例如`moment@2.22.2/min/moment.min.js`）。
jsDelivr和UNPKG就采用这种npm形式。
另外，如果你使用的CDN采用如CDN.js这样的URL形式，请在URL模板前加上`[cdnjs]`前缀。

{% codeblock "CDN.js-style URL模板" %}
[cdnjs]https://some.cdn.domain.name/${package}/${version}/${filename}
{% endcodeblock %}

### 网络字体CDN

你可以使用Google字体镜像CDN或是与其兼容的网络字体CDN。
Icarus依赖`Ubuntu`，`Oxanium`，和`Source Code Pro`这三种字体。
所以请确保你使用的CDN提供这些字体。
自定义的URL模板需包含字体类型`type`（图标`icon`或是字体`font`）和字体名称`fontname`两个占位符：

{% codeblock "Webfont CDN URL模板" %}
https://some.google.font.mirror/${type}?family=${fontname}
{% endcodeblock %}

### FontAwesome图标CDN

你可以使用自定义的FontAwesome CDN提供商。
URL模板中不需要包含占位符。
自定义提供商需要至少提供本主题所用到的所有FontAwesome 5图标。

{% codeblock "Icon Font CDN URL模板" %}
https://custom.fontawesome.mirror/some.stylesheet.css
{% endcodeblock %}

以上自定义配置可以放到主题配置文件中的`providers`部分：

{% codeblock themes/icarus/_config.yml lang:yaml %}
providers:
    cdn: 'https://some.cdn.domain.name/${package}/${version}/${filename}'
    fontcdn: 'https://some.google.font.mirror/${type}?family=${fontname}'
    iconcdn: 'https://custom.fontawesome.mirror/some.stylesheet.css'
{% endcodeblock %}

## CDN工具函数

本主题提供了三个工具函数来帮助主题开发者轻松引用第三方的前端资源。
详情请参见[ppoffice/hexo-component-inferno](https://github.com/ppoffice/hexo-component-inferno/blob/0.2.3/src/hexo/helper/cdn.js).


<div class="notification is-warning is-size-6">
文章内容有误？请点击<a href="https://github.com/ppoffice/hexo-theme-icarus/edit/site/source/_posts/zh-CN/CDN-Providers.md">此处</a>提交修改。
</div>