very-simple

Demo

A theme that aimed to be very simple, created by lotabout

Fork

• This fork adds additional layouts for /categories/ and /tags/ pages listing all of the tags and categories.

To use them, create folders tags and categories in your sources folder. In those folders create the following files -

cat>source/categories/index.md << EOF
title: "Categories"
layout: "categories"
---
EOF

cat>source/tags/index.md << EOF
title: "Tags"
layout: "tags"
---
EOF

• This fork doesn't depend on bootcss cdn, which is a Chinese CDN that can be rather slow at times if you're not from China yourself. Instead all dependencies are served locally.

I might change some other things if I feel like it.

Installation

Install the theme and the renderers:

git clone https://github.com/lotabout/very-simple themes/very-simple
npm install hexo-renderer-sass --save
npm install hexo-renderer-jade --save

Edit _config.yml in hexo root changing theme to very-simple.

Configuration

Default config:

# very-simple/_config.yml
menu:
  Home: /
  Archives: archives
social:
  email:
  twitter:
  github:
  googleplus:
  rss: /atom.xml
fancybox: true
duoshuo: #duoshuo_shortname
disqus: #disqus _shortname
google_analytics: #Google Analytics Tracking Code
google_adsense_page_level_ads: #Google Adsense Page Level Ads Code

• menu - The navigation links on the header
• social - Social icons such as email/github/twitter etc. to show on the footer
  • email - Email address
  • twitter - twitter account
  • github - github account
  • googleplus - Google Plus account
  • rss - RSS subscription link, learn more in hexo-generator-feed
• fancybox - Enable Fancybox
• duoshuo - Duoshuo shortname
• disqus - Disqus shortname
• google_analytics - Google Analytics Tracking Code
• google_adsense_page_level_ads: - Google Adsense Page Level Ads Code

If you want to contain this theme only as a submodule, then you may be unwilling to keep all configuration inside theme folder(very-simple/_config.yml). In this case, you can keep the configurations in root configuration file /_config.yml by:

# /_config.yml
very_simple:
  menu:
    Home: /
    Archives: archives
  social:
    email:
    twitter:
    github:
    googleplus:
    rss: /atom.xml
  fancybox: true
  duoshuo: #duoshuo_shortname
  disqus: #disqus _shortname
  google_analytics: #Google Analytics Tracking Code
  google_adsense_page_level_ads: #Google Adsense Page Level Ads Code

Features

Logo

You can set a favicon.ico for your website, please put it into source folder of hexo directory, recommended size: 32px*32px.

Pages

To customize pages, such as traditional 'About' page, follow the following steps:

1. create a directory about/ under /source

2. create a corresponding index page index.md under directory about/.

3. add link to the page to menu configuration:

   menu: About: about

Note that you don't need to add directory and create about.md under /source. But the configuration should changed to:

    menu:
      About: about.html

Comments

You can control whether to show comment system(default to enabled) in pages. Just add comments: true or comments: false in front-matter section of page. i.e.

title: About
date: 2013-12-26 22:52:56
layout: page
comments: true
---

Excerpt

You can control the abstract of a post shown at index, by:

1. Filling a description: item in front-matter of the post.md
2. Just inserting a <!--more--> before your hidden content.
3. Otherwise it will fetch the first paragraph as excerpt.