Landscape


A brand new default theme for [Hexo].

- Preview

Installation

$3

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:

`bash
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.

$3

Modify theme setting in _config.yml to landscape.

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

$3

Install the latest version through npm:

`sh
npm install hexo-theme-landscape@latest
`

Or update to the latest master branch via git:

`bash
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

$3

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

`
!img caption

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

$3

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.

$3

You can add links to the header area with icons.

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

[Hexo]: https://hexo.io/
[Fancybox]: https://github.com/fancyapps/fancyBox