subspace/packages/docs/themes/landscape/README.md

2.1 KiB

Landscape

A brand new default theme for Hexo.

Installation

Install

$ git clone https://github.com/hexojs/hexo-theme-landscape.git themes/landscape

Landscape requires Hexo 2.4 and above. If you would like to enable the RSS, the hexo-generate-feed plugin is also required.

Enable

Modify theme setting in _config.yml to landscape.

Update

cd themes/landscape
git pull

Configuration

# Header
menu:
  Home: /
  Archives: /archives
rss: /atom.xml

# Content
excerpt_link: Read More
fancybox: true

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

# Miscellaneous
favicon: /favicon.png
twitter:
google_plus:
  • 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
  • favicon - Favicon path
  • twitter - Twiiter ID
  • google_plus - Google+ ID

Features

Fancybox

Landscape 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.

Landscape 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.

Development

Requirements

Grunt tasks