klugjo / hexo-theme-clean-blog

Hexo implementation of Clean Blog http://blackrockdigital.github.io/startbootstrap-clean-blog/index.html

Clean Blog Hexo

Hexo implementation of Clean Blog

Clean blog is a full featured, responsive Hexo theme. Demo here.

Features

• Disqus and Facebook comments
• Google Analytics
• Addthis
• Cover image for posts and pages
• Tags and Categories Support
• Responsive Images
• Image Gallery
• Code syntax highlighting

External libraries used

• Bootstrap
• FeatherLight.js (Gallery)
• jQuery

Installation

$ git clone https://github.com/klugjo/hexo-theme-clean-blog.git themes/clean-blog

Then update your blog's main _config.yml to set the theme to clean-blog:

# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: clean-blog

Configuration

Menu

The menu is configured in the theme's _config.yml.

# Header
menu:
  Home: /
  Archives: /archives
  Github:
    url: https://github.com/klugjo/hexo-theme-clean-blog
    icon: github

The object key is the label and the value is the path, or you can use a icon (font awesome) like menu item.

Top Left Label

The top left label is configured in the theme's _config.yml. When clicked it will lead to the Home Page.

# Title on top left of menu. Leave empty to use main blog title
menu_title: Configurable Title

Home Page cover image

The Home Page cover is configured in the theme's _config.yml. It will be the same for all index type pages.

# URL of the Home page image
index_cover: /img/home-bg.jpg

Default post title

The default post title (used when no title is specified) is configured in the theme's _config.yml.

# Default post title
default_post_title: Untitled

Comments

The comments provider is specified in the theme's _config.yml. If you specify both a disqus_shortname and a facebook.appid there will be 2 sets of comment per post. So choose one.

# Comments. Choose one by filling up the information
comments:
  # Disqus comments
  disqus_shortname: klugjotest
  # Facebook comments
  facebook:
    appid: 123456789012345
    comment_count: 5
    comment_colorscheme: light

You can too hide the comment in the posts front-matter:

comment: false
---

Google Analytics

The Google Analytics Tracking ID is configured in the theme's _config.yml.

# Google Analytics Tracking ID
google_analytics:

Addthis

The Addthis ID is configured in the theme's _config.yml.

# Addthis ID
addthis:

Social Account

Setup the links to your social pages in the theme's _config.yml. Links are in the footer.

# Social Accounts
twitter_url:
facebook_url:
github_url: https://github.com/klugjo/hexo-theme-clean-blog
linkedin_url:
mailto:

Author

The post's author is specified in the posts front-matter:

author: Klug Jo
---

Post's Cover Image

By default, posts will use the home page cover image. You can specify a custom cover in the front-matter:

title: Excerpts
date: 2013-12-25 00:23:23
tags: ["Excertps"]
cover: /assets/contact-bg.jpg
---

Post's Share Cover Image

You can specify a custom cover to share yours posts in social medias:

share_cover: /assets/contact-bg.jpg
---

Post's Excerpt

This theme does not support traditional excerpts. To show excerpts on the index page, use subtitle in the front-matter:

title: Excerpts
date: 2013-12-25 00:23:23
tags: ["Excertps"]
subtitle: Standard Excerpts are not supported in Clean Blog but you can use subtitles in the front matter to display text in the index.
---

Tags page.

Follow these steps to add a tags page that contains all the tags in your site.

• Create a page named tags

$ hexo new page "tags"

• Edit the newly created page and set page type to tags in the front matter.

title: All tags
type: "tags"

• Add tags to the menu in the theme _config.yml:

# Header
menu:
  Home: /
  Archives: /archives
  Tags: /tags

Categories page.

Follow these steps to add a categories page that contains all the categories in your site.

• Create a page named categories

$ hexo new page "categories"

• Edit the newly created page and set page type to categories in the front matter.

title: All categories
type: "categories"

• Add Categories to the menu in the theme _config.yml:

# Header
menu:
  Home: /
  Archives: /archives
  Categories: /categories

Creator

This theme was created by Blackrock Digital and adapted for Hexo by Jonathan Klughertz.

License

MIT

hexo-theme-clean-blog's Issues

can't generate tags page properly.

this theme seems can't generate tags page properly.
you can visit my site haichao.me to verify.

and I set tags index.md like this:

title: tags
date: 2016-06-08 16:19:38
type: tags

comments: false

and i also checked the public/tags/index.html, there is no tag information.

hello, could you help plz

I like your theme so much!

Tag page

I followed the steps in README and created the tags page
But how can I access the code of the layout of the tag page?
I mean this page ,not this page (I already know how to access the latter)
I can't find anything I want in themes/clean-blog/layout
I don't understand how those files are generated under the folder tags (for example, tags/Tag-1) by reading your code
Is it possible to change the layout? Or is it something done by Hexo?

By the way, thank you for creating this great theme

这个主题是不是部署有点问题

本地适用，远程同步之后就显示有问题。
其他的主题没这个问题。

The Archives page's title just display "Archiv"

Why?

show categories hierarchical

Hi, thank you for making this theme.
It's so cool, but I have two question for this.

First question

I already configured categories, but it seems like that doesn't support sub directories.
I have sub directory(category) for my post, like

linux/about-linux.md
linux/ubuntu/about-ubuntu.md
linux/centos/about-centos.md

I even have 3-depth category as well.
It's not supported?
If it's not supported, I wanna watch some code about this feature.
Could you tell me where code it is?

Second question

After configure categories, I can see that _draft directory also in categories pages.
I don't wanna expose this directroy. Is there any way to do this?
If it's not support, I'm gonna appreciate you to tell me where code is.

Thank you.

in pagination.ejs this file, Previous and next pages are reversed

This is what I modified

Can I add a music box on my blog?

I want to add one on it.

How to do Facebook's commnets ? Disqus' site can't access

How to do Facebook's commnets ? Disqus' site can't access.

facebook's appid,how to apply it?And just apply appid?

top-right corner icon not perfectly aligned

For the github icon at the top-right corner, it's not vertical aligned in Chrome, IE and Firefox. I tried to set

.fa-stack-2x {
  bottom: 0;
}

and it's perfectly aligned now.

About article display width

How can I enlarge the article display width ratio of browser width?

Layout is same for Post and Page

Looking into the layout/ folder of clean-blog theme, I found that creating a new page and a post resulted into same layout. This is because post.ejs and page.ejs has same content.

Due to this, I wasn't unable to make a new Page of About Me for my blog.

How to enable Latex in this theme

Since I need to post some articles with latex equations, and install the Hexo Math plugin. But when the site deployed, the latex part still cannot display properly.
Should I add some configurations in the theme's _config.yml or something else ?

Where should the favicon file be located?

I've a local fav icon. I've put it in the source/img folder but it doesn't work this way. Where should it be?

Thanks,

Fails to generate

hexo generate

With

theme: clean-blog

ERROR Asset render failed: css/base.css
Error: ./themes/clean-blog/source/css/base.styl:2:12
   1| body
   2|   @extend .serif
-----------------^
   3|   font-size 20px
   4|   color gray-dark
   5|

Failed to @extend ".serif"

    at ./node_modules/stylus/lib/visitor/normalizer.js:406:17
    at Array.forEach (native)

I cannot add comment in your blog

Hello! I cannot login with github to leave comment in your blog.

http://www.codeblocq.com/2016/01/Untrack-files-already-added-to-git-repository-based-on-gitignore/

1. I pushed button "Login with github"
2. After that I get popup with message "[object ProgressEvent]". And comments block loading forever.

By the way you have no contact data, so github here is only way to write something to you.

How to start

some problem i met about the config

firstly i like the theme very much because it's really clean and fresh.But i met some problem can you help me to solve it?
1、the “menu_title” i have set in the config.yml, but the text on the top left is still "Configurable Title
", the setting is not work.
2、the github logo on the foot and the right top ,is link to your github,i want to link to my own github url.I write the "Github"-"url" in "menu" but it not work.
3、I don't know much about the category item,how do i use it?

problem

hi,when i use this theme ,i find this problem when i use this theme on github pages.
" You are attempting to use a Jekyll theme, "clean-blog", which is not supported by GitHub Pages"
I don't know how to solve it,could you tell me how to solve it ,thanks

Ghost Tag

I set the tag for something, then changed the tag but it still shows the tag as existing

How can I make a excerpt for the article in the home page?

Hi
This theme is really beautiful.

I am a beginner of web design
I have spent a whole day but I can't make the excerpt shows in my index

< !--more-- > is useless

Waiting for your reply
Thank you.

Categories Page

I have created a categories page, but I don't know how to add my categroies on blogs.Could u please give me some solution? Waiting for your apply.Thanks a lot.

How can I hide some posts at home page

Hi, for some reason, I don't want to show some posts at home page, how can I do it?

I cannot show table in markdown

Something is wrong with resolving tables in markdown into html...
I wrote:

|bucket 0  |  bucket 1 |
|:---------: | :---------: |
|E F G H I | A B C D   |

It just did not show what I expected to become like a table

How do I assign a favicon in clean blog?

Sorry if this is a stupid question. Please let me know where the best place would have been for me to find the answer to this question. Thanks so much for an amazing theme!

How can I change the background image in the about page or contact page?

Why did my Boostrap is fail

My blog can run on the local level but the deployment in GitHub cannot load Boostrap

How to show/display Google adsense ads on the blog?

Multilanguage support

Hey,

Thanks for your theme!

Currently my main problem is that posts all duplicated in the archives list when I use 2 languages.
Also, there is no language switch button by default.

Reference: hexojs/hexo#474

Is there possibility to make this theme able to support multiple languages?

Cheers

About the tags

Excuse me, can somebody tell me how to generate an index for the tags?
I want to have a page that contains all the tags.

Ignores Date in Front-matter

Beautiful theme, love the way it looks. Slick and simple.

One thing that frustrates me is the inability to set a date for a post. I'm trying to write posts about articles published in academic journals and I want the date to reflect when the article was published, not the day I'm writing about it. I've tried specifying a date in the front-matter in several formats to no avail.

No category and tags.

No category and tags in home menu.

The archives page's title was "Archiv".Is it "Archives"?

Tags doesn't show

I add the Tags: /tags in menu. The directory is correct. But it return 404 error when I click at the tags.

About Tags and Categories

Why this theme can‘t generate the Tags or Category index page? Can you that funtion?

Missing featured images and descriptions when I post my URL or blog posts on social media.

I've tried these three with no luck:

• https://github.com/leviwheatcroft/hexo-thumbnails
• https://www.npmjs.com/package/hexo-featured-image
• https://github.com/roybein/hexo-url-image

Question about categories

Hi, thank you for making this theme.
It's so cool, but I have two question for this.

First question

I already configured categories, but it seems like that doesn't support sub directories.
I have sub directory(category) for my post, like

linux/about-linux.md
linux/ubuntu/about-ubuntu.md
linux/centos/about-centos.md

I even have 3-depth category as well.
It's not supported?
If it's not supported, I wanna watch some code about this feature.
Could you tell me where code it is?

Second question

After configure categories, I can see that _draft directory also in categories pages.
I don't wanna expose this directroy. Is there any way to do this?
If it's not support, I'm gonna appreciate you to tell me where code is.

Thank you.

Unable to create a dropdown menu on home page

I am trying to create a dropdown menu on the home page at the top right bar on my blog (vrnchndk.in).

I am trying to create a new page and adding it in _config.yaml file as follows:

hexo new page snippets
hexo new page abcd

Entry in _config.yaml file:

menu:
  Home: /
  Blog: /archives
  Snippets:
   abcd: /abcd
  About Me: /About-Me
  test: /test

But this is throwing up errors. Any help on this ?

I can't show my markdown table in my blog

As the title ,I write a graph in markdown but it can't show right in my blog.

This graph can show right in another markdown editor ,can you tell me why?

How can I change the syntax highlighting theme?

implement search box for this theme.

Any tutorial to help implement search box in this would be helpful.

config should reference local image

index_cover: /img/home-bg.jpg

instead of

index_cover: http://www.codeblocq.com/assets/projects/hexo-theme-clean-blog/img/home-bg.jpg

can i have tags and categories in the blog?

I'm tring to create a tags for my blog ,but it's not work...
This is my blog

white nav text on white background for wide media

You can see what I mean if you zoom out on the demo, once the left and right edge of the cover image can be seen, the nav text expands over the white background on the left and right.

If you use a wide enough cover image you'd probably never notice this.. but I don't think a 1280 or 1024 wide image is such an uncommon use case?

Invite cooperation

I like the style of your blog very much. Can you develop a set of (free / paid) themes for cabloy-cms, and publish them in the cabloy store?

CabloyJS: is the Ultimate NodeJS Full-stack Business Development Platform, based on KoaJS + EggJS + VueJS + Framework7
Cabloy-CMS: is a CMS with the feature of static-dynamic combination based on the CabloyJS, which can quickly build web applications such as corporate websites, blogs, communities, and malls, etc.
Cabloy-Store: includes a wide range of modules to meet the development needs of different scenarios

CabloyJS Introduce: https://cabloy.com/articles/introduce.html
Cabloy-CMS Introduce: https://cabloy.com/articles/cms-introduce.html

Cabloy-Store Introduce: https://cabloy.com/articles/store.html

Document typo

Hi!
On the Readme, I think the installation command should be

git clone https://github.com/klugjo/hexo-theme-clean-blog.git themes/clean-blog

miss a "s" in themes folder