diff --git a/_config.theme.yml b/_config.theme.yml new file mode 100644 index 0000000..88a59ff --- /dev/null +++ b/_config.theme.yml @@ -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 diff --git a/source/_posts/Getting-Started.md b/source/_posts/Getting-Started.md index ec0f526..298a665 100644 --- a/source/_posts/Getting-Started.md +++ b/source/_posts/Getting-Started.md @@ -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. diff --git a/source/_posts/theme/Configuring-Icarus.md b/source/_posts/theme/Configuring-Icarus.md new file mode 100644 index 0000000..87cba8f --- /dev/null +++ b/source/_posts/theme/Configuring-Icarus.md @@ -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. + + + +## 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. + +unsplash-logoAlex Holt \ No newline at end of file diff --git a/source/_posts/theme/Polymorphic-Link-Settings.md b/source/_posts/theme/Polymorphic-Link-Settings.md new file mode 100644 index 0000000..a6f56fb --- /dev/null +++ b/source/_posts/theme/Polymorphic-Link-Settings.md @@ -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: + + + +```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/' +``` + +unsplash-logoEvie Shaffer diff --git a/source/_posts/widget/Profile.md b/source/_posts/widget/Profile.md index 480ef47..8fc9070 100644 --- a/source/_posts/widget/Profile.md +++ b/source/_posts/widget/Profile.md @@ -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 %} 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 diff --git a/source/about/index.md b/source/about/index.md index d6e05ae..6cb285d 100644 --- a/source/about/index.md +++ b/source/about/index.md @@ -1,8 +1,9 @@ title: +toc: true ---

-
A modern, simple, and delicate theme for the static site generator Hexo. +
A simple, delicate, and modern theme for the static site generator Hexo.

Preview | diff --git a/source/gallery/flower.jpg b/source/gallery/flower.jpg new file mode 100644 index 0000000..64b7134 Binary files /dev/null and b/source/gallery/flower.jpg differ