Landscape
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:
- category
- tag
- tagcloud
- archives
- recent_posts
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