Skip to content

hexojs/hexo-theme-landscape

Repository files navigation

Landscape

NPM version

A brand new default theme forHexo.

Installation

Install

If you're using Hexo 5.0 or later, the simplest way to install is through npm:

npm i hexo-theme-landscape

Install via git:

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

If you would like to enable the RSS, thehexo-generator-feedplugin is also required.

Enable

Modifythemesetting in_config.ymltolandscape.

_config.yml
-theme: some-theme
+theme: landscape

Update

Install the latest version through npm:

npm install hexo-theme-landscape@latest

Or update to the latest master branch via git:

cdthemes/landscape
git pull

Configuration

The configuration file for the theme is_config.ymlin the repository. As the default theme for Hexo, hexo-theme-landscape is installed via npm during thehexo initsite creation process, so it is generally located in thenode_modules/hexo-theme-landscapedirectory. If you install it viagit cloneor other methods, it might be located in thethemes/landscapedirectory.

It is important to note that to prevent your modifications to the theme configuration file from being lost or overwritten during theme upgrades,we do not recommend directly modifying this default configuration file.You can copy the theme's_config.ymlto your blog's root directory as_config.landscape.ymland configure it according to the documentation of configuration options therein (seeAlternate Theme Config).

The following will also detail the usage of some options.

Features

FancyBox

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

Landscape provides 5 built-in widgets:

  • category
  • tag
  • tagcloud
  • archives
  • recent_posts

All of them are enabled by default. You can edit them inwidgetsetting.

Header links

You can add links to the header area with icons.

links:
github:https://github.com/your_github_account
twitter:https://twitter.com/your_twitter_account
telegram:https://t.me/your_telegram_account