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前事項鍵，因此預計它是一個多項選擇屬性。