chore(posts): ready for v2 pre-release
parent
8b06126278
commit
22bdab6411
|
@ -0,0 +1,147 @@
|
|||
# Version of the Icarus theme that is currently used
|
||||
version: 2.0.0
|
||||
# Path or URL to the website's icon
|
||||
favicon: /images/favicon.svg
|
||||
# Path or URL to RSS atom.xml
|
||||
rss:
|
||||
# Path or URL to the website's logo to be shown on the left of the navigation bar or footer
|
||||
logo: /images/logo.svg
|
||||
# Open Graph metadata (https://hexo.io/docs/helpers.html#open-graph)
|
||||
open_graph:
|
||||
# Facebook App ID
|
||||
fb_app_id:
|
||||
# Facebook Admin ID
|
||||
fb_admins:
|
||||
# Twitter ID
|
||||
twitter_id:
|
||||
# Twitter site
|
||||
twitter_site:
|
||||
# Google+ profile link
|
||||
google_plus:
|
||||
# Navigation bar link settings
|
||||
navbar:
|
||||
# Navigation bar menu links
|
||||
menu:
|
||||
Home: /
|
||||
Archives: /archives
|
||||
Categories: /categories
|
||||
Tags: /tags
|
||||
About: /about
|
||||
# Navigation bar links to be shown on the right
|
||||
links:
|
||||
Download on GitHub:
|
||||
icon: fab fa-github
|
||||
url: 'http://github.com/ppoffice/hexo-theme-icarus'
|
||||
# Footer section link settings
|
||||
footer:
|
||||
# Links to be shown on the right of the footer section
|
||||
links:
|
||||
Creative Commons:
|
||||
icon: fab fa-creative-commons
|
||||
url: 'https://creativecommons.org/'
|
||||
Attribution 4.0 International:
|
||||
icon: fab fa-creative-commons-by
|
||||
url: 'https://creativecommons.org/licenses/by/4.0/'
|
||||
Download on GitHub:
|
||||
icon: fab fa-github
|
||||
url: 'http://github.com/ppoffice/hexo-theme-icarus'
|
||||
# Article display settings
|
||||
article:
|
||||
# Code highlight theme (https://github.com/highlightjs/highlight.js/tree/master/src/styles)
|
||||
highlight: atom-one-light
|
||||
# Whether to show article thumbnail images
|
||||
thumbnail: true
|
||||
# Whether to show estimate article reading time
|
||||
readtime: true
|
||||
# Search plugin settings (http://ppoffice.github.io/hexo-theme-icarus/categories/Configuration/Search-Plugins)
|
||||
search:
|
||||
# Name of the search plugin
|
||||
type: insight
|
||||
# Comment plugin settings (http://ppoffice.github.io/hexo-theme-icarus/categories/Configuration/Comment-Plugins)
|
||||
comment:
|
||||
# Name of the comment plugin
|
||||
type: disqus
|
||||
shortname: hexo-theme-icarus
|
||||
# Share plugin settings (http://ppoffice.github.io/hexo-theme-icarus/categories/Configuration/Share-Plugins)
|
||||
share:
|
||||
# Share plugin name
|
||||
type: sharethis
|
||||
install_url: //platform-api.sharethis.com/js/sharethis.js#property=5ab6f60ace89f00013641890&product=inline-share-buttons
|
||||
# Sidebar widget settings
|
||||
widgets:
|
||||
-
|
||||
type: profile
|
||||
position: left
|
||||
author: PPOffice
|
||||
author_title: Web Developer
|
||||
location: Earth, Solar System
|
||||
avatar:
|
||||
gravatar:
|
||||
follow_link: 'http://github.com/ppoffice'
|
||||
social_links:
|
||||
Github:
|
||||
icon: fab fa-github
|
||||
url: 'http://github.com/ppoffice'
|
||||
Facebook:
|
||||
icon: fab fa-facebook
|
||||
url: 'http://facebook.com'
|
||||
Twitter:
|
||||
icon: fab fa-twitter
|
||||
url: 'http://twitter.com'
|
||||
Dribbble:
|
||||
icon: fab fa-dribbble
|
||||
url: 'http://dribbble.com'
|
||||
RSS:
|
||||
icon: fas fa-rss
|
||||
url: /
|
||||
-
|
||||
type: toc
|
||||
position: left
|
||||
-
|
||||
type: links
|
||||
position: left
|
||||
links:
|
||||
Hexo: 'https://hexo.io'
|
||||
Bulma: 'https://bulma.io'
|
||||
-
|
||||
type: category
|
||||
position: left
|
||||
-
|
||||
type: tagcloud
|
||||
position: left
|
||||
-
|
||||
type: recent_posts
|
||||
position: right
|
||||
-
|
||||
type: archive
|
||||
position: right
|
||||
-
|
||||
type: tag
|
||||
position: right
|
||||
# Other plugin settings
|
||||
plugins:
|
||||
# Enable the lightGallery and Justified Gallery plugins
|
||||
gallery: true
|
||||
# Enable the Outdated Browser plugin
|
||||
outdated-browser: true
|
||||
# Enable page animations
|
||||
animejs: true
|
||||
# Enable the MathJax plugin
|
||||
mathjax: true
|
||||
back-to-top: true
|
||||
# Google Analytics plugin settings (http://ppoffice.github.io/hexo-theme-icarus/2018/01/01/plugin/Analytics/#Google-Analytics)
|
||||
google-analytics:
|
||||
# Google Analytics tracking id
|
||||
tracking_id: UA-72437521-5
|
||||
# Baidu Analytics plugin settings (http://ppoffice.github.io/hexo-theme-icarus/2018/01/01/plugin/Analytics/#Baidu-Analytics)
|
||||
baidu-analytics:
|
||||
# Baidu Analytics tracking id
|
||||
tracking_id:
|
||||
# CDN provider settings
|
||||
providers:
|
||||
# Name or URL of the JavaScript and/or stylesheet CDN provider
|
||||
cdn: cdnjs
|
||||
# Name or URL of the webfont CDN provider
|
||||
fontcdn: google
|
||||
# Name or URL of the webfont Icon CDN provider
|
||||
iconcdn: fontawesome
|
|
@ -4,7 +4,7 @@ thumbnail: /gallery/desert.jpg
|
|||
tags:
|
||||
- Getting Started
|
||||
---
|
||||
Icarus is a modern, simple, and delicate theme for the static site generator Hexo. Its versatile layout configuration allows you to set up a single or multiple-column (up to three column) blog easily. Additionally, it offers plentiful [plugins](/hexo-theme-icarus/categories/Plugins/) and pluggable [widgets](/hexo-theme-icarus/categories/Widgets/) so that you can enable the features you want in no time. And with the all-new API designing, Icarus makes the development of this theme painless for developers and users.
|
||||
A simple, delicate, and modern theme for the static site generator Hexo. Its versatile layout configuration allows you to set up a single or multiple-column (up to three column) blog easily. Additionally, it offers plentiful [plugins](/hexo-theme-icarus/categories/Plugins/) and pluggable [widgets](/hexo-theme-icarus/categories/Widgets/) so that you can enable the features you want in no time. And with the all-new API designing, Icarus makes the development of this theme painless for developers and users.
|
||||
|
||||
<!-- more -->
|
||||
|
||||
|
|
|
@ -0,0 +1,45 @@
|
|||
title: Configuring Icarus
|
||||
date: 2018-10-22 19:23:58
|
||||
thumbnail: /gallery/plant.jpg
|
||||
categories:
|
||||
- Configuration
|
||||
- Theme
|
||||
tags:
|
||||
- Getting Started
|
||||
---
|
||||
|
||||
The configuration of Icarus consists of two parts: theme configuration and post configuration.
|
||||
|
||||
<!-- more -->
|
||||
|
||||
## Theme Configuration
|
||||
|
||||
Icarus uses the `_config.yml` file under your theme directory for global page layout, plugins and widgets settings that are effective across the whole blog. On startup, Icarus will check the existence of this configuration file and creates it for you automatically if file is not found. It will also validate this file against the specifications if it is already there. You can check the specifications at anytime from the `*.spec.js` files inside the `themes/icarus/includes/specs` folder.
|
||||
|
||||
A default theme configuration consists of the following parts:
|
||||
|
||||
- Site preference and page meta data
|
||||
- Top navigation bar links
|
||||
- Page footer links
|
||||
- Article display settings
|
||||
- [Comment](/hexo-theme-icarus/categories/Plugins/Comment/), [share](/hexo-theme-icarus/categories/Plugins/Share/), and [search](/hexo-theme-icarus/categories/Plugins/Search/) plugin settings
|
||||
- [Sidebar widget](/hexo-theme-icarus/categories/Widgets/) settings
|
||||
- Other display and analytics [plugins](/hexo-theme-icarus/categories/Plugins/General/)
|
||||
- CDN settings
|
||||
|
||||
Most of the settings are documented in the `_config.yml` file. And for more details, you can refer to the [online documentation](/hexo-theme-icarus/categories/).
|
||||
|
||||
## Post Configuration
|
||||
|
||||
Apart from the global theme configuration, you can also customize any settings in a specific post. That is, you can override the theme settings from a post. Let's say you want to show different navigation bar menus in a post, we can simply put the `navbar` settings in the post's front-matter:
|
||||
|
||||
```yaml
|
||||
navbar:
|
||||
menu:
|
||||
Home: /
|
||||
Special!: /special
|
||||
```
|
||||
|
||||
This will replace your default navbar menu settings only in this post. This feature can be useful if you want to tune your page for a specific type of audience, such as enabling faster CDN and comment service based on the country and language of the viewer.
|
||||
|
||||
<a style="background-color:black;color:white;text-decoration:none;padding:4px 6px;font-size:12px;line-height:1.2;display:inline-block;border-radius:3px" href="https://unsplash.com/@alexholtdesign?utm_medium=referral&utm_campaign=photographer-credit&utm_content=creditBadge" target="_blank" rel="noopener noreferrer" title="Download free do whatever you want high-resolution photos from Alex Holt"><span style="display:inline-block;padding:2px 3px"><svg xmlns="http://www.w3.org/2000/svg" style="height:12px;width:auto;position:relative;vertical-align:middle;top:-1px;fill:white" viewBox="0 0 32 32"><title>unsplash-logo</title><path d="M20.8 18.1c0 2.7-2.2 4.8-4.8 4.8s-4.8-2.1-4.8-4.8c0-2.7 2.2-4.8 4.8-4.8 2.7.1 4.8 2.2 4.8 4.8zm11.2-7.4v14.9c0 2.3-1.9 4.3-4.3 4.3h-23.4c-2.4 0-4.3-1.9-4.3-4.3v-15c0-2.3 1.9-4.3 4.3-4.3h3.7l.8-2.3c.4-1.1 1.7-2 2.9-2h8.6c1.2 0 2.5.9 2.9 2l.8 2.4h3.7c2.4 0 4.3 1.9 4.3 4.3zm-8.6 7.5c0-4.1-3.3-7.5-7.5-7.5-4.1 0-7.5 3.4-7.5 7.5s3.3 7.5 7.5 7.5c4.2-.1 7.5-3.4 7.5-7.5z"></path></svg></span><span style="display:inline-block;padding:2px 3px">Alex Holt</span></a>
|
|
@ -0,0 +1,40 @@
|
|||
title: Polymorphic Link Settings
|
||||
date: 2018-10-22 19:23:57
|
||||
thumbnail: /gallery/flower.jpg
|
||||
categories:
|
||||
- Configuration
|
||||
- Theme
|
||||
footer:
|
||||
links:
|
||||
Creative Commons: 'https://creativecommons.org/'
|
||||
Attribution 4.0 International: 'https://creativecommons.org/licenses/by/4.0/'
|
||||
Download on GitHub:
|
||||
icon: fab fa-github
|
||||
url: 'http://github.com/ppoffice/hexo-theme-icarus'
|
||||
---
|
||||
|
||||
You may already noticed that Icarus allows you to put icon links on the right of navigation bar, the bottom of the profile widget, and the right side of the footer with the following format:
|
||||
|
||||
<!-- more -->
|
||||
|
||||
```yml
|
||||
footer:
|
||||
links:
|
||||
'Creative Commons':
|
||||
icon: fab fa-creative-commons
|
||||
url: 'https://creativecommons.org/'
|
||||
'Attribution 4.0 International':
|
||||
icon: fab fa-creative-commons-by
|
||||
url: 'https://creativecommons.org/licenses/by/4.0/'
|
||||
```
|
||||
|
||||
In the above link format, you need to specify the name of the link (e.g., Creative Commons), as well as the icon class name (e.g., Font Awesome class name) and link URL. However, Icarus also accept pure text links with link name and URL in the format below:
|
||||
|
||||
```yml
|
||||
footer:
|
||||
links:
|
||||
'Creative Commons: 'https://creativecommons.org/''
|
||||
'Attribution 4.0 International': 'https://creativecommons.org/licenses/by/4.0/'
|
||||
```
|
||||
|
||||
<a style="background-color:black;color:white;text-decoration:none;padding:4px 6px;font-size:12px;line-height:1.2;display:inline-block;border-radius:3px" href="https://unsplash.com/@evieshaffer?utm_medium=referral&utm_campaign=photographer-credit&utm_content=creditBadge" target="_blank" rel="noopener noreferrer" title="Download free do whatever you want high-resolution photos from Evie Shaffer"><span style="display:inline-block;padding:2px 3px"><svg xmlns="http://www.w3.org/2000/svg" style="height:12px;width:auto;position:relative;vertical-align:middle;top:-1px;fill:white" viewBox="0 0 32 32"><title>unsplash-logo</title><path d="M20.8 18.1c0 2.7-2.2 4.8-4.8 4.8s-4.8-2.1-4.8-4.8c0-2.7 2.2-4.8 4.8-4.8 2.7.1 4.8 2.2 4.8 4.8zm11.2-7.4v14.9c0 2.3-1.9 4.3-4.3 4.3h-23.4c-2.4 0-4.3-1.9-4.3-4.3v-15c0-2.3 1.9-4.3 4.3-4.3h3.7l.8-2.3c.4-1.1 1.7-2 2.9-2h8.6c1.2 0 2.5.9 2.9 2l.8 2.4h3.7c2.4 0 4.3 1.9 4.3 4.3zm-8.6 7.5c0-4.1-3.3-7.5-7.5-7.5-4.1 0-7.5 3.4-7.5 7.5s3.3 7.5 7.5 7.5c4.2-.1 7.5-3.4 7.5-7.5z"></path></svg></span><span style="display:inline-block;padding:2px 3px">Evie Shaffer</span></a>
|
|
@ -36,10 +36,12 @@ Icarus offers a way to showcase yourself using the profile sidebar widget. To us
|
|||
gravatar: # your gravatar email
|
||||
follow_link: # path or url to any page you want
|
||||
social_links: # add links to your social network here
|
||||
{% endcodeblock%}
|
||||
{% endcodeblock %}
|
||||
<!-- more -->
|
||||
There are two things that you should note:
|
||||
|
||||
- If you want to [Gravatar](https://en.gravatar.com/), fill in your email in the `gravatar` field. Otherwise, leave it blank or it will override the avatar setting.
|
||||
|
||||
- The `social_links` field accepts an array of links which are either shown as text link or icon link:
|
||||
- Text link
|
||||
```yml
|
||||
|
|
|
@ -1,8 +1,9 @@
|
|||
title:
|
||||
toc: true
|
||||
---
|
||||
<p align="center" class="has-mb-6">
|
||||
<img class="not-gallery-item" style="height:48px" src="/hexo-theme-icarus/images/logo.svg">
|
||||
<br> A modern, simple, and delicate theme for the static site generator Hexo.
|
||||
<br> A simple, delicate, and modern theme for the static site generator Hexo.
|
||||
</p>
|
||||
<p class="is-size-6 has-text-centered">
|
||||
<a href="http://ppoffice.github.io/hexo-theme-icarus/">Preview</a> |
|
||||
|
|
Binary file not shown.
After Width: | Height: | Size: 256 KiB |
Loading…
Reference in New Issue