InkPaper is a static blog generator developed in Golang. No dependencies, cross platform, easy to use, fast building times and an elegant theme.
$$ \int_{-\infty}^\infty g(x) dx = \frac{1}{2\pi i} \oint_{\gamma} \frac{f(z)}{z-g(x)} dz $$
Download & Extract Ink and run ink preview
Tip:Linux/macOS, use
./ink preview
Open http://localhost:8000
in your browser to preview
Edit config.yml
, use this 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, de, pt-br, configurable in theme/lang.yml url: Website URL # For RSS generating link: Article Link Scheme # Default is {title}.html, Support {year}, {month}, {day}, {hour}, {minute}, {second}, {title} variables authors: AuthorID: # Your author ID, used in article's author field 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 'ink publish' is used
Create a .md
file in the source
directory (Supports subdirectories). Use this 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 # Is draft or not, optional top: false # Place article to top or not, 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 or not. Hidden atricles still can be accessed via URL, optional toc: false # Show table of contents or not, optional --- Markdown Format's Body
ink publish
in the blog directory to automatically build and publishink build
to manually deploy generated public
directoryTips: When files changed,
ink preview
will automatically rebuild the blog. Refresh browser to update.
The default theme is placed in the theme
folder, run npm install
and npm run build
to rebuild in this folder.
page page.html
(article list) and article.html
(article), use variable with Golang Template syntax.
Created any .html
file will be copied to source
directory, could use all variables on site
field in config.yml
.
InkPaper supports defining custom variables in pages, which must be placed under site.config
in config.yaml
, such as:
site: config: MyVar: "Hello World"
The variable can be referenced in the page by {{.Site.Config.MyVar}}
.
Use Functions (Experimental)Note
Although the field names in other parts of
config.yaml
are all lowercase, the name of the custom variable must be used correctly. Otherwises, such a variable:site: config: MYVAR_aAa: "Hello World"must be referenced in the page as
{{.Site.Config.MYVAR_aAa}}
.
InkPaper defines a minimal set of functions that can be used in HTML pages (except for .md
source files), such as
{{ readFile "path/to/file" }}
This will read the content of the file path/to/file
and include it in the page without any processing.
For file-related functions, when executed in the source
directory, the file path is relative to the source
directory; when executed in other directories, the file path is relative to the theme (such as theme
).
See the source file funcs.go
for a list of all functions.
Supports simple Jeklly/Hexo post convertions. Usage:
Local Build
git clone https://github.com/InkProject/ink && cd ink && go install
to compile and install inkink preview $GOPATH/src/github.com/InkProject/ink/template
to preview blogDocker Build (Example)
git clone git@github.com:InkProject/ink.git
docker build -t ink .
in source directorydocker run -p 8888:80 ink
CC Attribution-NonCommercial License 4.0
https://github.com/InkProject/ink/issues
These blogs are driven by InkPaperRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4