doc-en.md

hexo theme apollo

Install

npm i hexo-theme-apollo

Enable

Go to _config.yml and change the theme property to apollo value:

theme: apollo

# Show all posts in archive page using hexo-generator-archive
archive_generator:
    per_page: 0
    yearly: false
    monthly: false
    daily: false

Update

npm i hexo-theme-apollo@latest

Meta Description

If you want to set meta description information, please set desc property and value to each post — the better method is setting default desc property to your scaffolds files, just like:

title: Lorem ipsum dolor
date: 2015-12-31 14:49:13
desc: Lorem ipsum dolor sit amet, consectetur.
---

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Totam, non numquam saepe ex ut. Deleniti culpa inventore consectetur nam saepe!

result:

<meta name="description" content="Lorem ipsum dolor sit amet, consectetur.">

If there is no desc property or value, hexo-theme-apollo will use page.title and page.author instead of it.

H1~H6 Title

In fact, Hexo-theme-apollo only supoort two kinds of titles: h1h3 belongs to what i called big title, and h4h6 belongs to small title, this means that # and ### have the same styles。

Why i do this? I support that an article should be short and clean, dont let visitors spend much time to recognise the blog post structure.

Another reason is that: i don't have met a great styles to distinguish between different kinds of headers.If you have gread idea about it, please let me know.

post excerpt

If you want to show excerpt(core content of article) to your visitors, do add HTML comment tag <!--more--> before else content，and finally the tag will be parsed to be a variable which represents post excerpt by Hexo:

Comment Plugin

Hexo-theme-apollo supports comment plugins for Disqus and Gitalk. please set like this in your ``_config.apollo.yml`:

disqus: disqus_shortname

gitalk:
  on: true
  owner: your github username
  repo: your repository
  admin: ['your github username']
  clientID: your clientId
  clientSecret: your clientSecret

Last but not Least

Focus on blog posts, not blog's styles. Have fun :) !