hexo-theme-minidyne
v4.0.3
Published
Hexo theme minidyne
Downloads
221
Readme
[!WARNING] V4 is a work in progress. Don't install / use until ready :)
Welcome to Minidyne, a minimalist hexo theme
Live Demo on Netlify (Source for the demo on Github)
This is V4. For V3 of this theme, head over to V3. For V2 of this theme, head over to V2. For V1 of this theme, head over to V1.
Features Overview
- Responsive
- Tags Support
- Accessible colors (at least the default one)
- Responsive Images
- Social Accounts configuration
- Pages
- ejs HTML templates
- Raw CSS. Use PostCss to build a single CSS
- Standalone (single css file, no external file) 🥊
- Static (no js, one single css) 🍊
- Emoji Icons for blog posts ✨
- SVG for social icons (Twitter, StackOverflow, LinkedIn, Mastodon, Github, Flickr 📰)
- Rss Icon (can be disabled)
External libraries used
- tachyons for Css Framework
- SimpleIcons for brand icons
Installation
Install the theme
Install the theme by using:
npm i hexo-theme-mindyne --save
Then update your blog's main _config.yml
to set the theme to minidyne
:
i.e:
theme: minidyne
You'll also need the following hexo plugins for this theme to work. Add them in the package.json (they should already be there, but just in case):
"dependencies": {
"hexo-generator-feed": "^3.0.0",
"hexo-generator-index": "^3.0.0",
"hexo-generator-tag": "^2.0.0",
"hexo-renderer-ejs": "^2.0.0",
"hexo-renderer-postcss": "^X.X.0",
"postcss-imports": "^X.X.0"
}
Limitations
This theme does not handle:
- Categories (so you can drop the default dependency to "hexo-generator-category" )
- Archives (so you can drop the default dependency to "hexo-generator-archive". If you want archives, head over to V1)
- Images gallery
- Pagination (if you want pagination, head over to V1 branch)
Post Configuration
Each post supports the standard title
, date
, tags
.
Post Icon
On top of that, you can specify an icon (ascii/unicode emoji):
Example:
title: Welcome to Minidyne
tags: ["ThisIsATag", "Intro", "Welcome", "Minidyne"]
icon: 🤝
---
Pick one from https://emojipedia.org/
Theme Configuration
The theme's global configuration is done in the main _config.yml
under the config key theme_config
:
theme_config:
default_post_title: "Untitled"
# Header
menu:
Home: /
About: /about.html
# Index banner text
index_banner_text: Welcome to Minidyne
# Logo
index_icon: ❤️
default_post_title: "Untitled"
default_post_icon: 🧙
# Social Media Platforms, also used for comments
social_platforms:
- url: https://stackoverflow.com/users/12345/johndoe
icon: stackoverflow
name: Stack Overflow
- url: https://github.com/johndoe/
icon: github
type: github
name: GitHub
repository: johndoe.blog
- url: https://linkedin.com/in/johndoe
icon: linkedin
type: linkedin
name: LinkedIn
- url: https://twitter.com/johndoe
icon: twitter
type: twitter
name: Twitter
account: johndoe
- url: https://www.flickr.com/photos/johndoe/
icon: flickr
type: flickr
name: Flickr
- url: https://mastodon.social/@johndoe
icon: mastodon
type: mastodon
name: Mastodon
- url: /rss2.xml
icon: rss
type: rss
name: Rss
menu
: The object key is the label and the value is the path.index_banner_text
The title appears on the home page.index_icon
The icon should be an emoji. Pick one from https://emojipedia.org/default_post_title
The default post title (used when no title is specified).default_post_icon
The default post icon (used when no icon is specified) is configured in the main_config.yml
.social_platforms
Social Account: Setup the links to your social pages in the theme's_config.yml
as an array of objects. Links are in the footer. They are used for sharing comments on your posts. Some need more properties than others
Note
The devDependency in package.json is just here to know when there is an update for Tachyons
Creator
This theme was created by Thomas Piart initially based upon (Anodyne Theme)(https://github.com/klugjo/hexo-theme-anodyne) by Jonathan Klughertz and also influenced by other minimalist approaches like mnmlist.
Bugs
If you have a question, feature request or a bug you need me to fix, please file an issue.
License
MIT