notoma

诺托玛

在 Notion 中为您的静态生成博客撰写文章。

• 文档网站
  • 使用 CLI
  • 贡献
  • 支持的 Markdown 标签

---

安装

Notoma 可通过 Pip 或 Homebrew 获得：

 # Installing with pip, use this if you plan using Notoma as a python library.
pip install notoma

在 Mac OS 上使用 Homebrew 安装。

brew install nategadzhi/notoma/notoma

---

您可以使用 Notoma 做什么

Notoma 提供命令：

• 将 Notion Blog 数据库的内容转换为一堆 Markdown 文件。
• 即将推出：关注 Notion 博客数据库的更新并在任何更新时重新生成 Markdown 文件。
• 即将推出：为您的博客创建一个包含所有必填字段的新概念数据库。

基本用法示例：此命令将仅将已发布的帖子从 Notion 博客数据库转换到./posts/ directory 。

notoma convert --dest ./posts/

此示例假设您有一个.env配置文件，其中包含身份验证和博客 URL 参数。

在概念中进行身份验证

Notoma 使用内部 Notion API，不幸的是，它要求您提供身份验证令牌token_v2 ，您可以在 notion.so Cookes 中找到该令牌。

您可以为每个命令行调用提供token_v2选项，或将其存储在您的环境或.env配置文件中。

---

概念数据库结构

Notoma 对您的 Notion 的结构抱有很少的期望。这是一个公共示例数据库。

Notoma 要求您的 Notion 博客数据库具有以下属性：

• Published ：文章是否已发表，或者仍是草稿
• Title ：将用于为该文章的 Markdown 等效文件创建文件名。不会在文章本身中使用。

Notoma 尝试解析其他属性并将它们作为前面的内容添加到生成的 Markdown 文章中：

• 发布日期将用作文章的发布日期（如果存在）。
• 类别将用作categories前事项键，因此预计它是一个多项选择属性。