Skip to content

Navigation Menu

Sign in
Sign up

Repository files navigation

Introduce

InkPaper is an static blog generator developed by Golang, No dependencies, Cross platform, Easy use, Fast build, Elegant theme.

release apm

InkPaper - An Elegant Static Blog Generator

Quick Start

  • Download & Extract Ink,Run ink preview

    Tips:Linux/macOS, use ./ink preview

  • Open http://localhost:8000 in browser to preview

Website Configuration

Edit config.yml, use format:

site:
 title: Website Title
 subtitle: Website Subtitle
 limit: Max Article Count Per Page
 theme: Website Theme Directory
 comment: Comment Plugin Variable (Default is disqus username)
 root: Website Root Path #Optional
 lang: Website Language #Support en, zh, ru, ja, Configurable in theme/lang.yml
 url: Website URL #For RSS Generating
 link: Article Link Scheme #Default Is {title}.html,Support {year},{month},{day},{title} Variables
authors:
 AuthorID:
 name: Author Name
 intro: Author Motto
 avatar: Author Avatar Path
build:
 output: Build Output Directory #Optional, Default is "public"
 port: Preview Port
 copy:
 - Copied Files When Build
 publish: |
 Excuted command when use 'ink publish'

Writing

Create any .md file in source directory (Support subdirectory), use format:

title: Article Title
date: Year-Month-Day Hour:Minute:Second #Created Time,Support TimeZone, such as " +0800"
update: Year-Month-Day Hour:Minute:Second #Updated Time,Optional,Support TimeZone, such as " +0800"
author: AuthorID
cover: Article Cover Path #Optional
draft: false #If Draft,Optional
top: false #Place article to top, Optional
preview: Article Preview,Also use <!--more--> to split in body #Optional
tags: #Optional
 - Tag1
 - Tag2
type: post #Specify type is post or page, Optional
hide: false #Hide article,can be accessed via URL, Optional
---
Markdown Format's Body

Publish

  • Run ink publish in blog directory to automatically build and publish
  • Or run ink build to manually deploy generated public directory

Tips: When source directory changed,ink preview will automatically rebuild blog,refresh browser to update

Customization

Modify Theme

Default theme placed in theme folder, run npm install and webpack to rebuild in this folder.

page page.html (article list) and article.html (article), use variable with Golang Template syntax.

New Page

Created any .html file will be copied to source directory, could use all variables on site field in config.yml.

Blog Migrate (Beta)

Support simple Jeklly/Hexo post convert, use:

ink convert /path/_posts

Build from source

Local Build

  1. Install Golang environment
  2. Run go get github.com/InkProject/ink, compile and get ink
  3. Run ink preview $GOPATH/src/github.com/InkProject/ink/template, preview blog

Docker Build (Example)

  1. Clone code git clone git@github.com:InkProject/ink.git
  2. Build image docker build -t ink . in source directory
  3. Run container docker run -p 8888:80 ink

Theme

License

CC Attribution-NonCommercial License 4.0

Issue Report

https://github.com/InkProject/ink/issues

Change Log

  • [2017年02月25日] Fix bugs and merge some PRs
  • [2016年07月11日] Fix bugs and merge many PRs
  • [2015年08月15日] Bug fix, support RSS feed, improve theme
  • [2015年07月04日] Bug fix, improve theme, support top, i18n, subtemplate
  • [2015年06月04日] Build more platform, add archive and tag page
  • [2015年03月01日] Release first beta version

Develop Plan

  • Improve Theme
  • InkPaper Editor

They are using

About

An elegant static blog generator

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages

AltStyle によって変換されたページ (->オリジナル) /