notoma

ノトマ

Notion で静的生成ブログの記事を作成します。

• ドキュメント Web サイト
  • CLIの使用
  • 貢献する
  • サポートされているマークダウンタグ

---

インストール

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 は次のコマンドを提供します。

• Notion Blog データベースのコンテンツを一連の Markdown ファイルに変換します。
• 近日公開予定: Notion Blog データベースの更新を監視し、更新があった場合に Markdown ファイルを再生成します。
• 近日公開予定: すべての必須フィールドを含むブログ用の新しい Notion データベースを作成します。

基本的な使用例: このコマンドは、公開された投稿のみを Notion ブログ データベースから./posts/ directoryに変換します。

notoma convert --dest ./posts/

この例では、認証およびブログ URL パラメーターを含む.env構成ファイルがあることを前提としています。

Notion での認証

Notoma は内部 Notion API を使用するため、残念ながら、notion.so クック内にある認証トークンtoken_v2提供する必要があります。

すべてのコマンド ライン呼び出しにtoken_v2オプションを指定することも、環境または.env構成ファイルに保存することもできます。

---

Notion データベース構造

Notoma は、Notion がどのように構成されているかについてほとんど期待しません。これは公開されているサンプル データベースです。

Notoma では、Notion ブログ データベースに次のプロパティが必要です。

• 公開済み: 記事が公開されたか、まだ下書きであるか。
• Title : その記事の Markdown に相当するファイルのファイル名を作成するために使用されます。記事自体では使用しません。

Notoma は他のプロパティを解析し、結果として得られる Markdown 記事に前付として追加しようとします。

• 発行日が存在する場合、記事の発行日として使用されます。
• カテゴリはcategories前付キーとして使用されるため、複数選択のプロパティであることが予想されます。