chore(doc): update en CDN and donate button doc

pull/729/head
ppoffice 2020-05-04 17:08:25 -04:00
parent 9cb2d9be7e
commit c5c52bd0af
9 changed files with 57 additions and 20 deletions

View File

@ -295,7 +295,7 @@ plugins:
katex: false
# Enable the MathJax math typesetting support
# https://www.mathjax.org/
mathjax: true
mathjax: false
# Enable the Outdated Browser plugin
# http://outdatedbrowser.com/
outdated_browser: true

View File

@ -8,27 +8,30 @@ language: en
toc: true
---
<div class="notification is-success is-size-6">
This article is also available in: <a href="{% post_path zh-CN/CDN-Providers %}">简体中文</a>.
</div>
Choosing the right CDN providers can significantly reduce the page loading time of your viewers.
Icarus lets you pick among several built-in CDN provider options for serving third-party
libraries and asset files used by Icarus.
Choosing right CDN providers can significantly reduce page loading time of your viewers.
Icarus lets you to choose between several built-on CDN provider options to serve the third-party
frontend libraries and asset files used by the theme.
<article class="message message-immersive is-primary">
<div class="message-body">
<i class="fas fa-globe-asia mr-2"></i>This article is also available in
<a href="{% post_path zh-CN/CDN-Providers %}">简体中文</a>.
</div>
</article>
<!-- more -->
<div class="notification is-link is-size-6">
The CDN-related functionalities of Icarus are provided by
[ppoffice/hexo-component-inferno](https://github.com/ppoffice/hexo-component-inferno).
Please refer to it for a complete list of supported providers and their configurations.
<article class="message message-immersive is-primary">
<div class="message-body">
<i class="fas fa-info-circle mr-2"></i>The following CDN functionalities are provided by
<a href="https://github.com/ppoffice/hexo-component-inferno">ppoffice/hexo-component-inferno</a>.
Please refer to it for a complete list of supported providers and their configuration details.
</div>
</article>
## Built-in CDN providers
Currently, you can choose between these built-in providers:
Currently, Icarus offers the following built-in CDN providers:
- **CDNs for JavaScript Libraries**
- cdnjs.com (`cdnjs`)
@ -62,7 +65,7 @@ The template formats for each type of CDN provider are listed below:
https://some.cdn.domain.name/${package}/${version}/${filename}
{% endcodeblock %}
You need to replace the actual package name, version of the package and relative file path with `${package}`,
You need to replace the actual package name, version of the package, and relative file path with `${package}`,
`${version}`, and `${filename}` placeholders.
For example, a JavaScript library with the following URL
@ -76,8 +79,7 @@ can be generalized to this
https://unpkg.com/${package}@${version}/${filename}
{% endcodeblock %}
Some CDN providers may adopt different URL schemes where the package name and file path for a library
are not exactly the same.
Some CDN providers may adopt different URL schemes.
For example, the `moment.js` library has the URL like this on CDN.js:
{% codeblock "CDN.js CDN URL Example" %}
@ -120,7 +122,7 @@ The provided custom CDN should at lease have FontAwesome 5 icons as some of them
https://custom.fontawesome.mirror/some.stylesheet.css
{% endcodeblock %}
All of the above should be put in the `providers` section of theme configuration file:
All of the above should be put in the `providers` section of the theme configurations:
{% codeblock themes/icarus/_config.yml lang:yaml %}
providers:
@ -136,6 +138,10 @@ CDN support.
You can check them out at [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">
Something wrong with this article? Click <a href="https://github.com/ppoffice/hexo-theme-icarus/edit/site/source/_posts/en/CDN-Providers.md">here</a> to submit your revision.
<article class="message message-immersive is-warning">
<div class="message-body">
<i class="fas fa-question-circle mr-2"></i>Something wrong with this article?
Click <a href="https://github.com/ppoffice/hexo-theme-icarus/edit/site/source/_posts/en/CDN-Providers.md">here</a>
to submit your revision.
</div>
</article>

View File

@ -98,17 +98,30 @@ Please refer to it for a complete list of supported buttons and their configurat
2. Select "Country/Region" and "Language" in the "Choose button style" page and click "Continue" to
advance to the next page.
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/paypal-button-style.png 360 '"Choose Button Style - Paypal" "Choose Button Style - Paypal"' %}
<br>
3. Select "Use account ID" or "Use email address" as the unique identifier of your account in the "Add organization
details" page.
Then, click "Continue" to go to the next page.
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/paypal-organization-details.png 360 '"Add Organization Details - Paypal" "Add Organization Details - Paypal"' %}
<br>
4. Choose the "Currency you'll receive donations in" and set "Amount donors can give" to "Any amount" in the
"Set donation amounts" page.
We currently do not support the option of donating in "An exact amount".
Click "Finish and Get Code" to go to the next page.
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/paypal-donation-amount.png 360 '"Set Donation Amounts - Paypal" "Set Donation Amounts - Paypal"' %}
<br>
5. Copy `business` and `currency_code` from the "Button HTML" on the page.
Put them to the `business` and `currency_code` settings in your theme configurations.
{% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/paypal-get-code.png 360 '"Get Code - Paypal" "Get Code - Paypal"' %}
<br>
For example, the following Paypal donation button code
{% codeblock Paypal HTML code lang:html %}

View File

@ -7,6 +7,15 @@ tags:
- Icarus User Guide
language: en
toc: true
plugins:
animejs: true
back_to_top: true
gallery: true
google_analytics:
tracking_id: UA-72437521-5
mathjax: true
outdated_browser: true
progressbar: true
---
<div class="notification is-success is-size-6">

View File

@ -7,6 +7,15 @@ tags:
- Icarus用户指南
language: zh-CN
toc: true
plugins:
animejs: true
back_to_top: true
gallery: true
google_analytics:
tracking_id: UA-72437521-5
mathjax: true
outdated_browser: true
progressbar: true
providers:
cdn: loli
fontcdn: loli

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 113 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 65 KiB