chore(posts): ready for v2 pre-release

pull/701/head
ppoffice 2018-10-26 00:43:25 -04:00
parent 8b06126278
commit 22bdab6411
7 changed files with 238 additions and 3 deletions

147
_config.theme.yml Normal file
View File

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

View File

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

View File

@ -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&amp;utm_campaign=photographer-credit&amp;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>

View File

@ -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&amp;utm_campaign=photographer-credit&amp;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>

View File

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

View File

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

BIN
source/gallery/flower.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 256 KiB