Skip to Content
環境変数

設定

Rotion の設定は環境変数だけで行います。 変数は rotion が最初に import された時点で一度だけ読まれます。 そのため、ビルドのプロセスが始まる前に設定しておきます。 Next.js なら .env.local、CI ならジョブの環境、あるいはコマンドラインで指定します。

NOTION_TOKEN=ntn_xxx ROTION_INCREMENTAL_CACHE=true npm run build

環境変数

名前デフォルト説明
NOTION_TOKENなし（必須）Notion インテグレーションのシークレット。すべての API リクエストで使います。
GOOGLEMAP_KEYなしGoogle Maps Embed API のキー。埋め込みブロックの Google マップのリンクを地図にするのに必要です。ないと地図は埋め込まれません。
ROTION_CACHEDIR.cacheAPI のレスポンスのキャッシュとロックファイルを置くディレクトリ。
ROTION_INCREMENTAL_CACHEfalsetrue にすると、データベースは ROTION_CACHE_AVAILABLE_DURATION を過ぎたら、ページとブロックは渡した last_edited_time がキャッシュの値と異なるときに取得し直します。それ以外のときは既存のキャッシュを常に使います。キャッシュを参照してください。
ROTION_CACHE_AVAILABLE_DURATION120000（ミリ秒、2分）インクリメンタルキャッシュが有効なとき、キャッシュしたデータベースのクエリを使い続ける時間。プロパティ値、データベース、パンくずリストのためにキャッシュした問い合わせを使い続ける時間でもあり、こちらはモードにかかわらず適用されます。
ROTION_DOCROOTpublicサイトのルートとして配信するディレクトリ。ダウンロードした画像とファイルはこの下に置きます。
ROTION_IMAGEDIRimages画像のディレクトリ。ROTION_DOCROOT からの相対パスです。データの中の画像のパスの先頭（/images/...）にもなります。
ROTION_FILEDIRfilesファイル、PDF、動画のディレクトリ。ROTION_DOCROOT からの相対パスです。それらのパスの先頭（/files/...）にもなります。
ROTION_WEBP_QUALITY95ダウンロードした画像から変換する WebP の品質（1〜100）。0 にすると変換しません。
ROTION_WAITTIME0（ミリ秒）Notion API へのリクエストが成功するたびに入れる待ち時間。
ROTION_LIMITED_WAITTIME60000（ミリ秒、1分）レート制限、サーバーエラー、タイムアウトで失敗したリクエストを再試行する前の待ち時間。試行は最大3回です。
ROTION_TIMEOUT1500（ミリ秒）Rotion が自分で行う HTTP リクエスト（ファイルのダウンロードと、ブックマークや埋め込みのためのページの取得）の無通信タイムアウト。Notion API へのリクエストには使いません。
ROTION_MAX_REDIRECTS5それらの HTTP リクエストでたどるリダイレクトの最大回数。
ROTION_UAカレントディレクトリの package.json の <name>/<version>それらの HTTP リクエストの User-Agent ヘッダ。これによって返す内容を変えるサイトもあります。Rotion 自身のサイトは ROTION_UA=curl でビルドしています。
ROTION_SKIP_QUERY_VALIDATIONfalsetrue にすると、データベースのクエリをフィルタとソートの照合なしで送ります。validateQuery を参照してください。
ROTION_DEBUGfalsetrue にすると、キャッシュの判断、再試行、ダウンロードのエラーをログに出し、Notion クライアントのログレベルを debug にします。
ROTION_SKIP_DOWNLOADfalsetrue にすると、画像をダウンロードせずにパスだけを返します。Rotion のテスト用です。

真偽値の変数は、文字列 true と完全に一致するときだけ有効になります。 数値は整数として解釈します。

Note

Rotion は import された時点で、ROTION_UA のデフォルト値のためにカレントディレクトリの package.json を読みます。 ビルドは package.json のあるプロジェクトのルートで実行してください。

ROTION_CACHEDIR と ROTION_DOCROOT のパスも、カレントディレクトリからの相対パスです。

サンプルで使う変数

このドキュメントとサンプルで使っている NOTION_DATABASE_ID は、Rotion が読む変数ではありません。 サンプルのコードがこれを読み、FetchDatabase に渡しています。

Last updated on
コンポーネント概要