
<h1>Material Theme</h1>

<i>A pure Material Design theme for Hexo</i>

<p>
<img alt="Version" src="https://img.shields.io/badge/version-1.5.6-757575.svg?style=flat-square"/>
<a href="https://blh.im"><img alt="Author" src="https://img.shields.io/badge/author-bollnh-red.svg?style=flat-square"/></a>
<a href="https://hexo.io"><img alt="Hexo" src="https://img.shields.io/badge/hexo-3.0+-0e83cd.svg?style=flat-square"/></a>
<a href="https://nodejs.org/"><img alt="node.js" src="https://img.shields.io/badge/node.js-6.0%2B-43853d.svg?style=flat-square"/></a>
<a href="https://www.npmjs.com/package/hexo-material"><img alt="npm" src="https://img.shields.io/npm/dt/hexo-material.svg?style=flat-square"/></a>
</p>

<p align="center">
<img src="https://i.loli.net/2017/09/07/59b1367f76fdb.png" alt="Material Render Phone">
</p>

English | [简体中文](./README.zh.md)

## Table of Contents

- [Demo](#demo)
- [Docs](#docs)
- [Download](#download)
- [Contributing](#contributing)
- [License](#license)
- [Changelog](#changelog)
- [Support](#support)
- [Render](#render)


## Demo

- [Material Demo](https://bollnh.github.io/material-demo/)


## Docs

[Material Docs](https://neko-dev.github.io/material-theme-docs/#/)

> [Docs Source Code](https://github.com/neko-dev/material-theme-docs)


## Download

#### [Download latest release version](https://github.com/bollnh/hexo-theme-material/releases/latest)

> Recommended for most users.

#### [Download latest canary branch](https://github.com/bollnh/hexo-theme-material/archive/canary.zip)

> Latest features. Recommended for developers.

#### [Download other version](https://github.com/bollnh/hexo-theme-material/releases)

> You can decide which version to use. May no longer provide support.

#### [Download using git](https://github.com/bollnh/hexo-theme-material/releases)

> You can using git to choose which branch you want. For developer only.

```bash
cd themes
git clone https://github.com/bollnh/hexo-theme-material.git material
cd material
git checkout {branch/tags name}
```

----

> ATTENTION! As the theme is developing, the theme config template will changes. To avoid conflict for users who are using `git pull` to upgrade the theme, we save the theme config template as `_config.template.yml`. You should make a copy of it and rename to `_config.yml`, then configure `_config.yml` when using the theme.


## Contributing

All kinds of contributions (enhancements, new features, documentation & code improvements, issues & bugs reporting) are welcome.

Before you start your contributing, please read the [Contributing Rules Wiki](https://github.com/bollnh/hexo-theme-material/wiki) first.

## Changelog

[View our release notes](https://github.com/bollnh/hexo-theme-material/releases)


## License

[![license](https://img.shields.io/github/license/bollnh/hexo-theme-material.svg?style=flat-square)](https://github.com/bollnh/hexo-theme-material/blob/master/LICENSE)

Open sourced under the GPL v3.0 license.

## Support

### BroswerStack

![BrowserStack Status](https://www.browserstack.com/automate/badge.svg?badge_key=V1VkWmJMRjJqcHBjN1BIVFRlNzExM05XUk5hemcydEpZTHRBdGd5V244ST0tLTlvNklDT1NuVXFDaTh0RDBnQ3RCdXc9PQ==--c986c45d7c10a3264f46b414944d6393ba74ea22%)

Proudly using BrowserStack.

[![](https://i.loli.net/2017/09/27/59cbc16b0f8b4.png)](https://www.browserstack.com/)

> **BrowserStack** is a cloud-based cross-browser testing tool that enables developers to test their websites across various browsers on different operating systems and mobile devices, without requiring users to install virtual machines, devices or emulators.

### jsDelivr

Thanks jsDelivr for providing MaterialCDN service.

> **jsDelivr** – Open Source CDN. free, fast, and reliable. You can using the files from GitHub or NPM and serve them using jsDelivr.

[![](https://data.jsdelivr.com/v1/package/npm/hexo-material/badge)](https://www.jsdelivr.com/package/npm/hexo-material)

[`http://cdn.jsdelivr.net/npm/hexo-material/source/`](http://cdn.jsdelivr.net/npm/hexo-material/source/)

[![](https://data.jsdelivr.com/v1/package/gh/bollnh/hexo-theme-material/badge)](https://www.jsdelivr.com/package/gh/bollnh/hexo-theme-material)

[`https://cdn.jsdelivr.net/gh/bollnh/hexo-theme-material/source/`](https://cdn.jsdelivr.net/gh/bollnh/hexo-theme-material/source/)

## Render

![Materia-overview-tiny.png](https://i.loli.net/2017/09/28/59cccb0b25520.png)
