hikaru-coffee

hikaru

A static site generator that generates routes based on directories naturally.

• "This world won't need one more static site generator!"

• "But I need."

Install

# npm i -g hikaru-coffee

TODO List

• Dir based router.
• Marked Markdown renderer.
• Stylus CSS renderer.
• Nunjucks template renderer.
• Highlight.js code highlight.
• Async loading, rendering and saving file.
• Pagination for index, archives, categories (different category pages) and tags (different tag pages).
• Archives info for templating.
• Categories info for templating.
• Tags info for templating.
• Cheerio-based toc generating.
• Cheerio-based path converting (relative to absolute).
• Date operations in templates.
• sprintf-js based multi-languages support.
• Local search JSON gengrating.
• RSS feed generating.
• Porting theme ARIA.
• Live reloading server.

Example Dir Structure

hikura-site/
    |- srcs/ # source dir for user files
    |   |- images/
    |   |- css/
    |   |- js/
    |   |- index.md
    |   |- about/
    |   |   |- index.md
    |   |- tags/
    |   |   |- index.md
    |- docs/ # source will be render to here
    |   |- images/
    |   |   |- logo.png
    |   |- css/
    |   |   |- index.css
    |   |- js/
    |   |   |- index.js
    |   |- index.html
    |   |- index-2.html # page 2 of index
    |   |- index-3.html # page 3 of index
    |   |- about/
    |   |   |- index.html
    |   |- tags/
    |   |   |- index.html # layout: tags
    |   |   |- tag-1/
    |   |   |   |- index.html # automatically generated, layout: tag
    |   |   |   |- index-2.html # page 2 of tag-1
    |- themes/
    |   |- aria/
    |   |   |- srcs/ # this will be render to docs/
    |   |   |   |- layout.njk # templates
    |   |   |   |- index.njk
    |   |   |   |- tags.njk
    |   |   |   |- tag.njk
    |   |   |   |- page.njk # if no layout specific, fallback to this
    |   |   |   |- css/
    |   |   |   |   |- index.styl
    |   |   |   |- js/
    |   |   |   |   |- index.js
    |   |   |   |- images/
    |   |   |   |   |- logo.png
    |   |- README.md