You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
108 lines
2.4 KiB
108 lines
2.4 KiB
2 years ago
|
# Landscape
|
||
|
|
||
|
A brand new default theme for [Hexo].
|
||
|
|
||
|
- [Preview](https://hexojs.github.io/hexo-theme-landscape/)
|
||
|
|
||
|
## Installation
|
||
|
|
||
|
### Install
|
||
|
|
||
|
``` bash
|
||
|
$ git clone --depth 1 https://github.com/hexojs/hexo-theme-landscape themes/landscape
|
||
|
```
|
||
|
|
||
|
**Landscape requires Hexo 2.4 and above.** If you would like to enable the RSS, the [hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed) plugin is also required.
|
||
|
|
||
|
### Enable
|
||
|
|
||
|
Modify `theme` setting in `_config.yml` to `landscape`.
|
||
|
|
||
|
``` diff
|
||
|
_config.yml
|
||
|
- theme: some-theme
|
||
|
+ theme: landscape
|
||
|
```
|
||
|
|
||
|
### Update
|
||
|
|
||
|
``` bash
|
||
|
cd themes/landscape
|
||
|
git pull
|
||
|
```
|
||
|
|
||
|
## Configuration
|
||
|
|
||
|
``` yml
|
||
|
# Header
|
||
|
menu:
|
||
|
Home: /
|
||
|
Archives: /archives
|
||
|
rss: /atom.xml
|
||
|
banner: images/banner.jpg
|
||
|
subtitle: This a subtitle
|
||
|
|
||
|
# Content
|
||
|
excerpt_link: Read More
|
||
|
fancybox: true
|
||
|
recent_posts_limits: 5
|
||
|
# Footer
|
||
|
copyright: |-
|
||
|
<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-nd/4.0/88x31.png" /></a></br>
|
||
|
All website licensed under <a href="https://creativecommons.org/licenses/by-nc-nd/4.0/" target="_blank">CC BY-NC-ND 4.0</a></br>
|
||
|
|
||
|
# Sidebar
|
||
|
sidebar: right
|
||
|
widgets:
|
||
|
- category
|
||
|
- tag
|
||
|
- tagcloud
|
||
|
- archives
|
||
|
- recent_posts
|
||
|
|
||
|
# Miscellaneous
|
||
|
google_analytics:
|
||
|
favicon: /favicon.png
|
||
|
twitter:
|
||
|
```
|
||
|
|
||
|
- **menu** - Navigation menu
|
||
|
- **rss** - RSS link
|
||
|
- **banner** - Path of title banner image of page top
|
||
|
- **excerpt_link** - "Read More" link at the bottom of excerpted articles. `false` to hide the link.
|
||
|
- **fancybox** - Enable [Fancybox]
|
||
|
- **recent_posts_limits** - How many posts display in Home page.
|
||
|
- **sidebar** - Sidebar style. You can choose `left`, `right`, `bottom` or `false`.
|
||
|
- **widgets** - Widgets displaying in sidebar
|
||
|
- **google_analytics** - Google Analytics ID
|
||
|
- **favicon** - Favicon path
|
||
|
- **twitter** - Twitter 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.
|
||
|
|
||
|
[Fancybox]: https://github.com/fancyapps/fancyBox
|