pages cms

頁面CMS

頁面CMS是GitHub的開源內容管理系統。它特別適合靜態現場生成器（例如Jekyll，Next.js，Vuepress，Hugo）。

它提供了一個用戶友好的界面，可以直接在GitHub上編輯網站或應用程序的內容。

觀看演示▶

文件

轉到pagescms.org/docs。

建立

• next.js
• 尾風CSS
• shadcn/ui
• 細雨
• 動詞
• Turso
• 重新發出

在線使用

最簡單的入門方法是使用頁面CMS的在線版本。您將能夠使用GitHub帳戶登錄並獲取最新版本的頁面CMS。

此在線版本與此存儲庫中的內容相同，但是您也可以在本地安裝自己的版本或在Vercel上（免費）遵循以下步驟（免費）。

安裝和部署

創建一個GitHub應用程序

無論您是在本地安裝頁面CMS還是在線部署，都需要GitHub應用程序。

您可以在您的個人帳戶（https://github.com/settings/apps）或您的一個組織（https://github.com/organization/organization//settings/apps）下創建它。

您將需要填寫以下信息：

• github應用程序名稱：使用“頁面CMS”或您認為適當的任何內容（例如“頁面CMS（dev）”）。
• 主頁URL ：無論您想要什麼，https：//pagescms.org都會做。
• 識別和授權用戶：
  • 回調URL： /api/auth/github的URL：
    • http://localhost:3000/api/auth/github開發，
    • https://my-vercel-url.vercel.app/api/auth/github （或正在使用的任何自定義域）之類的東西，如果您在Vercel上部署時。
  • 到期用戶授權令牌：否。
  • 在安裝過程中請求用戶授權（OAUTH）：是的。
  • 啟用設備流：否。
• 後安裝：
  • 設置URL（可選）：空白。
  • 重定向更新：否。
• Webhook ：
  • 活動：是的。
  • Webhook URL：（公共）URL /api/webhook/github ：
    • 為了開發，您需要使用Ngrok之類的東西。您最終會得到https://your-unique-subdomain.ngrok-free.app/api/webhook/github 。
    • 如果您在Vercel上部署，則類似於https://my-vercel-url.vercel.app/api/webhook/github （或您使用的任何自定義域）。
  • 秘密：生成一個隨機字符串（例如，macOS/linux上的openssl rand -base64 32 ）
• 許可：
  • 存儲庫權限：
    • 管理：讀寫
    • 內容：讀寫
    • 元數據：只讀
  • 組織許可：什麼都沒有。
  • 帳戶權限：什麼都沒有。
• 訂閱事件：
  • 安裝目標
  • 存儲庫（創建GitHub應用程序後，您可能需要添加此內容）
• 此GitHub應用程序可以在哪里安裝？ ：除非您打算僅在帳戶上使用該github應用程序在下面創建的帳戶上使用頁面CMS，否則您需要選擇“任何帳戶”。

環境變量

多變的	評論
CRYPTO_KEY	用於在數據庫中加密/解密GitHub令牌。在MacOS/Linux*上，您可以使用openssl rand -base64 32 。
GITHUB_APP_ID	GitHub應用程序ID中的GitHub應用程序詳細信息頁面。
GITHUB_APP_NAME	GitHub應用程序的機器名稱（例如pages-cms ）應為GitHub應用程序詳細信息頁面的URL。
GITHUB_APP_PRIVATE_KEY	PEM文件，您可以下載uPong創建GitHub應用程序。
GITHUB_APP_WEBHOOK_SECRET	您為Webhook選擇的秘密。這用於確保請求來自GitHub。
GITHUB_APP_CLIENT_ID	GitHub應用客戶端ID從您的GitHub應用詳細信息頁面。
GITHUB_APP_CLIENT_SECRET	GitHub應用客戶端秘密您在thegithub應用程序詳細信息頁面上生成。
RESEND_API_KEY	當您創建一個（免費）重新匯總帳戶以處理電子郵件時，您會得到這一點。
SQLITE_URL	file:./local.db進行開發， libsql://pages-cms-username.turso.io例如，如果您使用turso（您應該使用Turso，Turso很棒）。
SQLITE_AUTH_TOKEN	留空供開發，否則請使用Turso提供的令牌（如果您使用的話）。
BASE_URL	選修的。如果您要部署到Vercel或在本地工作，則不需要。如果您要部署其他地方，則需要為應用程序指定基本URL（例如https://mycustomdomain.com ）。

地方發展

我們假設您已經創建了GitHub應用程序，並為Github應用程序Webhook設有運行隧道（例如，使用NGrok）：

1. 安裝依賴項： npm install
2. 更新您的環境變量：將.env.example複製到.env並根據您的設置填寫值（請參見上面的部分）。
3. 創建數據庫： npm run db:migrate
4. 運行： npm run dev

部署在Vercel上

1. 創建一個SQLITE數據庫：我建議使用Turso，因為它是免費的（而且很棒）

2. 部署到Vercel ：在此階段，您有2個選擇：

   1. 創建一個叉子：fork您的帳戶中的pages-cms/pages-cms存儲庫並部署該叉子。這將使您獲得更新。確保定義上面列出的所有環境變量。

   2. 使用部署按鈕：

3. 更新您的github oauth應用程序：一旦您擁有vercel url（例如“ callback url”和“ webhook url”，您可能需要返回GitHub應用程序設置以更新某些設置。

自主

還有很多其他選擇：Fly.io，數字海洋，渲染，SST，等。

執照

此存儲庫中的所有內容均根據MIT許可發布。