Hiker Guide

Hiker

An attractive, exquisite theme for Hexo. named “Hiker”, short for “HikerNews”.

☞ Live Preview | Hiker 中文版使用文档

Installation

1. Get it from GitHub

   $ git clone https://github.com/iTimeTraveler/hexo-theme-hiker.git themes/hiker

2. Enable

   Modify theme setting in _config.yml to hiker.

   # Extensions
   ## Plugins: http://hexo.io/plugins/
   ## Themes: http://hexo.io/themes/
   theme: hiker

3. Update

   $ cd themes/Hiker
   $ git pull

Configuration

Theme configuration example

# ---------------------------------------------------------------
# Site Information Settings
# ---------------------------------------------------------------

# Header Menu
menu:
  Home: /
  Archives: archives
  Categories: categories
  Tags: tags
  About: about
rss: /atom.xml

since: 2013

# Set default keywords (Use a comma to separate)
keywords: ""

# Put your favicon.ico into `hexo-site/themes/hiker/source/` directory.
avatar: css/images/mylogo.jpg


# Homepage
# eg. home_background_image: css/images/home-bg.jpg
home_background_image: css/images/home-bg.jpg
home_logo_image:
  enable: false
  border: false
  url: css/images/homelogo.jpg


# AboutPage background
about_big_image: css/images/pose.jpg


# Content
excerpt_link: Read More
fancybox: true


# Sidebar
sidebar: right
widgets:
- category
- tag
- tagcloud
- archive
- recent_posts


# comment ShortName, you can choose only ONE to display.
duoshuo_shortname: iTimeTraveler
disqus_shortname:


# Code Highlight theme
# Available value:
#    default | normal | night | night eighties | night blue | night bright
# https://github.com/chriskempson/tomorrow-theme
highlight_theme: default


# Article theme color
# Available value:
#    random | orange | blue | red | green | black
theme_color: random


# display widgets at the bottom of index pages (pagination == 2)
index_widgets:
# - category
# - tagcloud
# - archive


# widget behavior
archive_type: 'monthly'
show_count: true

# Google Webmaster tools verification setting
# See: https://www.google.com/webmasters/
google_site_verification:
baidu_site_verification:
qihu_site_verification:

# Miscellaneous
google_analytics:
gauges_analytics:
twitter:
google_plus:
fb_admins:
fb_app_id:

• menu - Navigation menu
• rss - RSS link
• excerpt_link - “Read More” link at the bottom of excerpted articles. false to hide the link.
• fancybox - Enable Fancybox
• sidebar - Sidebar style. You can choose left, right, bottom or false.
• widgets - Widgets displaying in sidebar
• google_analytics - Google Analytics ID
• favicon - Favicon path
• twitter - Twiiter ID
• google_plus - Google+ ID

Features

Homepage background

You could place the image file in YOUR_HEXO_SITE\themes\hiker\source\css\images directory. and modify home_background_image in hiker/_config.yml.

# Homepage
# eg. home_background_image: css/images/home-bg.jpg
home_background_image: css/images/home-bg.jpg

If you DON’T want any image as your homepage background, just set home_background_image empty in hiker/_config.yml, then you have an default homepage with random decorative pattern.

Code Highlight Theme

Hiker use Tomorrow Theme for your code block. We have six options in total: default, normal, night, night blue, night bright, night eighties

Above preview picture is default theme. the image below show other five Highlight themes.

Modify highlight_theme in hiker/_config.yml.

# Code Highlight theme
# Available value:
#    default | normal | night | night eighties | night blue | night bright
# https://github.com/chriskempson/tomorrow-theme
highlight_theme: default

Blog Theme Color

Hiker provide five color themes for your blog.

• orange
• blue
• red
• green
• black

You can modify theme_color in hiker/_config.yml.

# Article theme color
# Available value:
#    random | orange | blue | red | green | black
theme_color: random

Night mode

Just for article reading. In article page, you can click the logo image of header to switch to Night mode.

Fancybox

Hiker uses Fancybox to showcase your photos. You can use Markdown syntax or fancybox tag plugin to add your photos.

![img caption](img url)

{% fancybox img_url [img_thumbnail] [img_caption] %}

Sidebar

You can put your sidebar in left side, right side or bottom of your site by editing sidebar setting.
Hiker provides 5 built-in widgets:

• category
• tag
• tagcloud
• archives
• recent_posts

All of them are enabled by default. You can edit them in widget setting.

Comment support

Hiker has native support for DuoShuo & Disqus comment systems. Modify the following snippets to hiker hiker/_config.yml:

# comment ShortName, you can choose only ONE to display.
duoshuo_shortname: iTimeTraveler
disqus_shortname:

Browser support

Contributing

All kinds of contributions (enhancements, new features, documentation & code improvements, issues & bugs reporting) are welcome.

Looking forward to your pull request.