stubble "Hello, World!" -t rust
stubble "Hello, World!" -t rust -t programming

覆盖帖子日期

要使用除当前日期以外的日期，请使用日期标志 -D 或 --date。

stubble "Hello, World!" -D 1988-08-10

...然后您应该看到

Created new file 1988-08-10-hello-world.md!

添加帖子的描述

如果您想填充前言描述字段，可以使用描述标志 -d 或 --description。

stubble "Hello, World!" -d "This is my first post generated with Stubble!"

指定文章作者

默认情况下，Stubble 会尝试为您填充前言中的 author 字段。它首先会询问操作系统的 "Real Name"，如果失败，则默认为您的用户名。要指定其他内容，可以使用作者标志 -a 或 --author。

stubble "Hello, World!" -a "Joey Pardella"

更改输出文件名

默认情况下，Stubble 会根据日期和缩写生成文件名。要覆盖此行为，可以使用输出标志 -o 或 --output。

stubble "Hello, World!" -o draft-post.markdown

...然后您应该看到

Created new file draft-post.md!

在您的编辑器中打开

Stubble 可以选择在您选择的编辑器中打开新创建的 stub 文件。标志 -e 或 --editor 可接受最多 1 个参数。提供参数将在该程序中打开文件，省略参数将尝试使用环境变量 $EDITOR 中定义的可执行文件打开文件。

内置帮助

在任何时候，您都可以从命令行检查可用的选项及其用法。

stubble -h
Stubble is a command-line tool for quickly generating markdown files for use by static site generators. Given a title, it will generate a date-stamped markdown file with pre-populated YAML front-matter.

Usage: stubble [OPTIONS] <TITLE> [DEST]

Arguments:
  <TITLE>  Title of the post
  [DEST]   Output destination [default: .]

Options:
  -s, --slug <SLUG>                Optional slug to be used for the permalink
  -t, --tag [<TAG>...]             Tag(s) to apply to the post. Separate multiple tags with spaces
  -D, --date <DATE>                Override the post date: YYYY-MM-DD
  -d, --description <DESCRIPTION>  Post description
  -a, --author [<AUTHOR>]          The name of the author
  -f, --format [<FORMAT>]          The output format that should be used to render the stub. [default: md]
  -o, --output <OUTPUT>            Override the default filename
  -e, --editor [<EDITOR>]          Open in <EDITOR>
  -y, --yes                        Automatically answer 'Y' to all prompts (including existing file warnings)
  -h, --help                       Print help (see more with '--help')
  -V, --version                    Print version

使用标志 --help 可以获取更详细的帮助信息。

安装

使用 Cargo

Cargo 是 Rust 的包管理器。要使用 cargo 安装 Stubble，您需要在计算机上安装 Rust，版本 1.73 或更高。

安装 Rust 后，打开终端并运行

cargo install stubble

假设一切构建正确，并且您的本地 ~/.cargo/bin 目录已添加到 PATH，现在您应该能够运行 stubble。