hexojs / hexo-theme-landscape

A brand new default theme for Hexo.
https://hexojs.github.io/hexo-theme-landscape/
MIT License
321 stars 377 forks source link
hexo hexo-theme

Landscape

NPM version

A brand new default theme for Hexo.

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, the hexo-generator-feed plugin is also required.

Enable

Modify theme setting in _config.yml to landscape.

_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:

cd themes/landscape
git pull

Configuration

The configuration file for the theme is _config.yml in the repository. As the default theme for Hexo, hexo-theme-landscape is installed via npm during the hexo init site creation process, so it is generally located in the node_modules/hexo-theme-landscape directory. If you install it via git clone or other methods, it might be located in the themes/landscape directory.

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.yml to your blog's root directory as _config.landscape.yml and configure it according to the documentation of configuration options therein (see Alternate Theme Config).

The following will also detail the usage of some options.

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:

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

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