Skip to content

lotabout/hexo-theme-noise

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Noise

Demo

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

A little preview:

noise-index

noise-hello

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.