hexo-theme-unit-test's Introduction

Hexo Theme Unit Test

This is a dummy Hexo site for theme unit test. You should test your theme before release.

This test doesn't contain the default theme. You have to install the theme you want to test before starting.

Usage

Clone this repository

$ git clone https://github.com/hexojs/hexo-theme-unit-test.git

Install your own theme and modify theme setting in _config.yml.
Run server and start testing. Make sure all styles are displayed properly.
Once test is done, you can submit your theme!

Checklist

`<head>`

Use the proper DOCTYPE. If you don't know which doctype you should use, <!DOCTYPE html> is recommended.
UTF8 charset
```
<meta charset="utf-8">
```
Proper titles for different pages

Favicon support

<link rel="icon" href="path/of/favicon">

Index

Only display excerpts. (Better with a "Read More" link)
Pagination

Post

Display post categories and tags.
Disqus comment support.
Display the post date.
Support photos in front-matter.
Posts without title should be accessible.

Performance

Use fragment_cache It caches render result across post/pages, see #1769 for the impact

Optional

Responsive design
i18n
Post share
SEO
RSS Autodiscovery support
- Example:
```
<link rel="alternate" href="path/of/rss" type="application/atom+xml">
```
- Some RSS plugins (e.g. hexo-generator-feed 2.1+) insert autodiscovery by default. There is a slight performance benefit if a theme inserts it, instead of the plugin. To take advantage of that, autodiscovery needs to be disabled in the plugin.
```
feed:
  autodiscovery: false
```
- hexo-generator-feed plugin could generate more than one type of RSS (e.g. Atom & RSS2). Here is an example EJS snippet for multi-format support by utilizing feed_tag helper:
```
<%- feed_tag() %>
```
  - If you want to support other plugins, in addition to hexo-generator-feed:
```
<% if (config.feed) { %>
  <%- feed_tag() %>
<% } else if (theme.rss) { %>
  <%- feed_tag(theme.rss) %>
<% } %>
```
- If you decide to support autodiscovery, we recommend checking the updates of hexo-generator-feed (or any other RSS plugin that your theme prefers) from time to time. The configuration and functionality of an RSS plugin may change over time.

Resources

hexo-theme-unit-test's People

Contributors

Stargazers

Watchers

hexo-theme-unit-test's Issues

Setup dependabot on this repo

Hi @hexojs/core

Could you setup dependabot on this repo too ?

Thank you

本地开发时，有几张图片显示不出来

应该是没有把source 文件夹下的图片移到指定文件夹。。

lack some npm dependencies which lead to failed to render layout

When starting a new hexo blog using hexo init it will be created a package.json contains the following dependencies:

 "dependencies": {
    "hexo-renderer-ejs": "*",
    "hexo-renderer-stylus": "*",
    "hexo-renderer-marked": "*"
  }

but the package.json file of this unit test project contains no dependencies. When I run hexo server even using the landscape theme, I only get the plain ejs file.

Maybe this is ignored intentionally. for example, someone may create a theme using jade instead of ejs. but it is recommended to declare this in the readme file to avoid misconception.

Recommend Projects

hexojs / hexo-theme-unit-test Goto Github PK