페이지 CMS는 GitHub의 오픈 소스 컨텐츠 관리 시스템입니다. 특히 정적 사이트 생성기 (예 : Jekyll, Next.js, Vuepress, Hugo)에 적합합니다.
사용자 친화적 인 인터페이스를 제공하여 웹 사이트 또는 앱의 컨텐츠를 GitHub에서 직접 편집합니다.
데모 시청 ▶
pagescms.org/docs로 이동하십시오.
시작하는 가장 쉬운 방법은 온라인 버전의 페이지 CMS를 사용하는 것입니다. GitHub 계정으로 로그인하고 최신 버전의 Pages CMS를 얻을 수 있습니다.
이 온라인 버전은이 Repo의 내용과 동일하지만 아래 단계에 따라 Vercel에 로컬로 자신의 버전을 설치하거나 (무료) 배포 할 수도 있습니다.
CMS를 로컬로 설치하거나 온라인으로 배포하든 Github 앱이 필요합니다.
개인 계정 (https://github.com/settings/apps)으로 또는 조직 중 하나 (https://github.com/organizations//settings/apps) 아래에서 만들 수 있습니다.
다음 정보를 작성해야합니다.
/api/auth/github 의 URL :http://localhost:3000/api/auth/github 개발,https://my-vercel-url.vercel.app/api/auth/github (또는 사용중인 사용자 정의 도메인)과 같은 것입니다./api/webhook/github 용 (공개) URL :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)| 변하기 쉬운 | 의견 |
|---|---|
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 작성을 다운로드 할 수 있습니다. |
GITHUB_APP_WEBHOOK_SECRET | 당신이 당신의 웹 후크를 위해 선택한 비밀. 이것은 요청이 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는 훌륭합니다). |
SQLITE_AUTH_TOKEN | 개발을 위해 공백을 남겨 두십시오. 그렇지 않으면 Turso가 제공하는 토큰을 사용하십시오 (그것이 사용하는 경우). |
BASE_URL | 선택 사항 . Vercel에 배포하거나 현지에서 일하는 경우 필요하지 않습니다. 다른 곳에 배포하는 경우 앱의 기본 URL을 지정해야합니다 (예 : https://mycustomdomain.com ). |
우리는 당신이 이미 Github 앱을 만들었고 Github 앱 Webhook 용 실행 터널을 가지고 있다고 가정합니다 (예 : Ngrok 사용).
npm install.env.example .env 로 복사하고 설정에 따라 값을 채우십시오 (위의 섹션 참조).npm run db:migratenpm run devSQLITE 데이터베이스 만들기 : Turso를 사용하는 것이 좋습니다. 무료이기 때문입니다.
Vercel에 배포 :이 단계에서는 두 가지 선택이 있습니다.
포크 생성 : 계정에서 pages-cms/pages-cms repo를 포크하고 해당 포크를 배포하십시오. 이를 통해 업데이트를받을 수 있습니다. 위에 나열된 모든 환경 변수를 정의하십시오 .
배포 버튼 사용 :
GitHub Oauth 앱 업데이트 : Vercel URL (예 : "Callback URL"및 "Webhook URL")이 있으면 일부 설정을 업데이트하려면 GitHub 앱 설정으로 돌아 가야 할 것입니다.
다른 옵션이 많이 있습니다 : Fly.io, Digital Ocean, Render, SST 등.
이 저장소의 모든 것은 MIT 라이센스에 따라 릴리스됩니다.