a beautiful read
A simple, text focused theme for Hexo. Bringing your readers attention to what is most import: your posts.
Check out the Demo
❗ Make sure your Node version is 6.x or above as the theme uses some ES6 syntax. ❗
- Get the latest release, simply download the file meilidu.zip. (see below for cloning)
- Unpack it into your themes folder. (You should now have a folder in your themes folder named "meilidu" which should not contain a folder named "meilidu")
- Change your _config.yml:
theme: meilidu
You can also manage the theme as a subproject of your website. Simply run the following in the root directory of your project. After that change the theme property in your projects _config.yml
.
git clone https://github.com/HoverBaum/meilidu-hexo.git themes/meilidu
Below is a documentation of all features and how to use them as well as some good to know points. If you have any further questions or suggestions please open an issue.
The issues are open to anyone looking for help or wishing to make a suggestion to improve the theme.
We have a few features you can configure and some that need to be enabled first. Check out the Demo to see them all in action.
Add an array of all widgets you want to display in the footer in MeiliDus _config.yml
. These should be the names of files in the layout/_widgets
folder. A widget should always be wrapped in an footer__element, like such:
<div class="footer__element">
<p>Hi there, <br />welcome to my Blog glad you found it. Have a look around, will you?</p>
</div>
You can change the text of "read more" links by setting the readMore
option in MeiliDus _config.yml
.
readMore: ...read more
You can set the link to you RSS feed in MeiliDus _config.yml
.
rss: /atom.xml
You also need to install the feed generator for this to work.
npm install hexo-generator-feed --save
Make sure to use the --save
option and run this in the root folder of your repository as it won't work otherwise.
To activate the tags page create a source/tags/index.md
with the following content.
title: "Tags"
layout: "tags"
---
Activating the categories page is similar to tags, create a source/categories/index.md
with the following content.
title: "Categories"
layout: "categories"
---
Like any other page create a folder with the name of the page and an index.md
file in it to have an about page. The most basic about page in source/about/index.md
might look like this.
title: About
layout: page
---
This is a page about pages. It is the mother of all pages and pageception.
If you archive is only showing the current years posts try adding the following yml to your sites _config.yml
(not the one in meilidus folder).
archive_generator:
per_page: 0
It can have any size really. It will always fill half of the screens height when the user first arrives on the page. Simply replace meilidu/source/img/header.jpg
with your own file.
The default header is from unspalsh, a picture by Alberto Restifo.
To customize the menu at the top of the page simply change MeiliDus _config.yml
and add your links to the menu
object. Remove everything from it to hide the top menu.
Hexo itself and the MeiliDu theme use a lot of absolute URLs (those starting with /something
). Due to this you can only run your blog on a domain or subdomain but not as something like domain.com/blog/
. To run a blog on GitHub check out User pages in the GitHub documentation.
You can host websites for free on GitHub. The Demo for MeiliDu is a great example of this. I use Travis to automate the generation of static files whenever we push to the master branch. Check out this travis config file, it comes with explanation on how to use it. Personally I found it easiest to have a repo that contains the blog (this one) and one that is only there to get the page going. Travis then gets the current version, generates all files and pushes to the website repo.
Because two minutes of googleing found this PSD showcase so that is what I went with.
You are using MeiliDu for your blog? That is awesome! Let us know about it with a pull request and be featured here as an example for people to see how MeiliDu looks in the wild.