Nib CLI

nib-cli 是一个为另一个静态站点生成器 Nib 设计的命令行工具。

用法

安装

% cargo install nib-cli

配置

# e.g.
% cat config.toml
[website]
title = "An awesome blog"
description = """
"""
lang = "en" # language_code
url = "http://127.0.0.1:3000"
# the top most directory (e.g. blog) will be omitted in url
include = [
  "blog/**/*.rst"
]
license = "CC-BY-NC-SA-4.0"
# this or [[website.metadata.authors]] either is required
# authors = [
#  "Yasuhiro Яша Asaka <[email protected]>",
# ]

[build]
target-dir = "dst"

[[website.metadata.authors]]
name = "Yasuhiro Яша Asaka"
nick = "grauwoelfchen"
bio = """
A Programmer. I'm hacking on Gentoo/Funtoo Linux. I love greens and vegetables.
"""
email = "[email protected]"
avatar = "https://www.gravatar.com/avatar/...?s=40"

撰写文章

% cat blog/post/article.rst
.. title:: Nice foo
.. lang:: en # optional
.. date:: 2018-01-31 12:04:00 UTC
.. description:: This is an article about nice foo. # optional
.. slug:: foo.html # optional (default filename as is)

Foo is nice! # above blank line before content is required

生成

将您的文章放在配置文件中 include 部分包含的目录下。

# e.g. blog
% tree blog
blog
├── post
│   └── article.rst
└── hello-word.rst

然后使用 target-dir 指定的目录生成 HTML 文件。

% nib

输出结果如下所示

% tree dst
dst
├── css
│   └── index.css
├── hello-world.html
├── img
├── index.html
├── js
└── post
    └── foo.html

开发

参见 nib-server。

许可

Apache-2.0

参见 LICENSE