pages cms

ページCMS

Pages CMSは、Githubのオープンソースコンテンツ管理システムです。静的サイトジェネレーターに特に適しています（例：Jekyll、next.js、vuepress、hugo）。

GitHubでウェブサイトまたはアプリのコンテンツを直接編集するためのユーザーフレンドリーなインターフェイスを提供します。

デモ▶をご覧ください

ドキュメント

pagescms.org/docsにアクセスしてください。

で構築されています

• next.js
• Tailwind CSS
• shadcn/ui
• 霧雨
• ヴェルセル
• ターソ
• 再送信

オンラインで使用します

開始する最も簡単な方法は、ページCMSのオンラインバージョンを使用することです。 GitHubアカウントでログインして、Pages CMSの最新バージョンを取得できます。

このオンラインバージョンは、このリポジトリにあるものと同じですが、独自のバージョンをローカルにインストールするか、以下の手順に従ってvercelに（無料で）展開することもできます。

インストールして展開します

GitHubアプリを作成します

Page CMSをローカルにインストールする場合でも、オンラインで展開する場合でも、GitHubアプリが必要です。

個人アカウント（https://github.com/settings/apps）または組織のいずれか（https://github.com/organizations/settings/apps）の下で作成できます。

次の情報に記入する必要があります。

• githubアプリ名：「ページCMS」または適切だと思うものを使用します（「ページCMS（dev）」）。
• ホームページURL ：必要なものは何でも、https：//pagescms.orgが行います。
• ユーザーの識別と承認：
  • コールバックURL： /api/auth/githubのURL：
    • http://localhost:3000/api/auth/github開発のための、
    • vercelで展開している場合、 https://my-vercel-url.vercel.app/api/auth/github （または使用しているカスタムドメイン）のようなもの。
  • ユーザー承認トークンの期限切れ：いいえ。
  • インストール中にユーザー認証（OAUTH）をリクエスト：はい。
  • デバイスフローを有効にする：いいえ。
• インストールの投稿：
  • セットアップURL（オプション）：空のままにします。
  • 更新のリダイレクト：いいえ。
• webhook ：
  • アクティブ：はい。
  • webhook url：（public）url for /api/webhook/github ：
    • 開発には、ngrokのようなものを使用する必要があります。 https://your-unique-subdomain.ngrok-free.app/api/webhook/githubのようなものになります。
    • https://my-vercel-url.vercel.app/api/webhook/github （または使用しているカスタムドメイン）のようなもの。
  • 秘密：ランダムな文字列を生成します（たとえば、 openssl rand -base64 32でmacos/linuxで）
• 許可：
  • リポジトリの権限：
    • 管理：読み取りと書き込み
    • 内容：読み取りと書き込み
    • メタデータ：読むだけです
  • 組織の許可：何もありません。
  • アカウント許可：何もありません。
• イベントを購読する：
  • インストールターゲット
  • リポジトリ（GitHubアプリの作成後にこれを追加する必要があるでしょう）
• このgithubアプリはどこにインストールできますか？ ：このGitHubアプリが作成されているアカウントでページCMSのみを使用する場合を除き、「任意のアカウント」を選択する必要があります。

環境変数

変数	コメント
CRYPTO_KEY	データベースでGitHubトークンを暗号化/復号化するために使用されます。 MacOS/Linux*では、 openssl rand -base64 32使用できます。
GITHUB_APP_ID	githubアプリの詳細ページからのgithubアプリID。
GITHUB_APP_NAME	GitHubアプリ（ pages-cmsなど）のマシン名は、GitHubアプリの詳細ページのURLをスラッグする必要があります。
GITHUB_APP_PRIVATE_KEY	PEMファイルGitHubアプリのUpong Creationをダウンロードできます。
GITHUB_APP_WEBHOOK_SECRET	あなたがあなたのwebhookのために選んだ秘密。これは、リクエストがGitHubからのものであることを確認するために使用されます。
GITHUB_APP_CLIENT_ID	githubアプリの詳細ページからのgithubアプリクライアントID。
GITHUB_APP_CLIENT_SECRET	githubアプリクライアントシークレットTheGithubアプリの詳細ページで生成します。
RESEND_API_KEY	（無料の）再送信アカウントを作成してメールを処理すると、それを取得します。
SQLITE_URL	file:./local.db development、 libsql://pages-cms-username.turso.ioたとえば、たとえば、ターソを使用する場合（cursoは素晴らしいです）。
SQLITE_AUTH_TOKEN	開発のために空白のままにします。そうでなければ、Tursoが提供するトークンを使用します（それが使用している場合）。
BASE_URL	オプション。 Vercelに展開したり、地元で働いたりする場合は、それは必要ありません。他の場所に展開している場合は、アプリのベースURL（ https://mycustomdomain.comなど）を指定する必要があります。

ローカル開発

GitHubアプリを既に作成しており、GitHubアプリWebhook用の実行中のトンネルを持っていると仮定します（たとえば、Ngrokを使用）：

1. 依存関係をインストール： npm install
2. 環境変数を更新します：copy .env.example to .envに、設定に従って値を入力します（上記のセクションを参照）。
3. データベースの作成： npm run db:migrate
4. 実行： npm run dev

Vercelに展開します

1. SQLiteデータベースを作成する：Tursoを使用することをお勧めします。

2. Vercelに展開：この段階では、2つの選択肢があります。

   1. フォークを作成する：fork fork fork pages-cms/pages-cms repo in your counce and deploy deplay deplay deplayこれにより、更新を取得できます。上記のすべての環境変数を定義してください。

   2. 展開ボタンを使用します：

3. GitHub OAuthアプリの更新：Vercel URL（「Callback URL」および「WebHook URL」など）を使用したら、GitHubアプリの設定に戻る必要があるでしょう。

自己ホスト

他にもたくさんのオプションがあります：fly.io、デジタルオーシャン、レンダリング、SSTなど。

ライセンス

このレポのすべては、MITライセンスの下でリリースされます。