Noise

Demo

Noise theme is based on very-simple, creatd by lotabout.

A little preview:

Installation

Install theme and renderers:

git clone https://github.com/lotabout/hexo-theme-noise themes/noise
npm install hexo-renderer-less --save
npm install hexo-renderer-pug --save

Edit _config.yml in hexo root, change theme to noise.

Configuration

Default config:

# noise/_config.yml
menu:
  Home: /
  Archives: archives
social:
  email:
  twitter:
  github:
  googleplus:
  rss: /atom.xml
fancybox: true
infinite_scroll: false
show_toc: true
toc_words: "Table of Contents"
compact_index: false
disqus: #disqus _shortname
google_analytics: #Google Analytics 4 Tracking Code
google_analytics_legacy: #Google Analytics Tracking Code(Old version)
google_adsense_page_level_ads: #Google Adsense Page Level Ads Code
extend_backtick_code: true
fold_max_height: 300 #px # besides code tag, supports

• menu - The navigation links on the header
• social - Social icons such as email/github/twitter etc. to show on the footer
  • email - Email address
  • twitter - twitter account
  • github - github account
  • googleplus - Google Plus account
  • rss - RSS subscription link, learn more in hexo-generator-feed
• fancybox - Enable Fancybox
• infinite_scroll - Enable infinite scroll on index page
• show_toc - To show ToC if no toc: is specified in post
• toc_words - The words to show in the TOC line
• compact_index - Use "archive" style index page
• disqus - Disqus shortname
• google_analytics - Google Analytics 4 Tracking Code
• google_analytics_legacy - Google Analytics Tracking Code (old)
• google_adsense_page_level_ads - Google Adsense Page Level Ads Code
• extend_backtick_cod: extend backtick code block to support code tag args
• fold_max_height: besides code tags's args, we support fold:true to fold long code blocks

If you want to contain this theme only as a submodule, then you may be unwilling to keep all configuration inside theme folder(noise/_config.yml). In this case, you can keep the configurations in root configuration file /_config.yml by:

# /_config.yml
noise:
  menu:
    Home: /
    Archives: archives
  social:
    email:
    twitter:
    github:
    googleplus:
    rss: /atom.xml
  fancybox: true
  infinite_scroll: false
  show_toc: true
  toc_words: "Table of Contents"
  compact_index: false
  disqus: #disqus _shortname
  google_analytics: #Google Analytics 4 Tracking Code
  google_analytics_legacy: #Google Analytics Tracking Code(Old version)
  google_adsense_page_level_ads: #Google Adsense Page Level Ads Code

Features

Logo

You can set a favicon.ico for your website, please put it into source folder of hexo directory, recommended size: 32px*32px.

Pages

To customize pages, such as traditional 'About' page, follow the following steps:

1. create a directory about/ under /source

2. create a corresponding index page index.md under directory about/.

3. add link to the page to menu configuration:

   menu: About: about

Note that you don't need to add directory and create about.md under /source. But the configuration should changed to:

    menu:
      About: about.html

Comments

You can control whether to show comment system(default to enabled) in pages. Just add comments: true or comments: false in front-matter section of page. i.e.

title: About
date: 2013-12-26 22:52:56
layout: page
comments: true
---

Excerpt

You can control the abstract of a post shown at index, by:

1. Filling a description: item in front-matter of the post.md
2. Just inserting a <!--more--> before your hidden content.
3. Otherwise it will fetch the first paragraph as excerpt.