pages cms

หน้า CMS

หน้า CMS เป็นระบบการจัดการเนื้อหาโอเพ่นซอร์สสำหรับ GitHub มันเหมาะอย่างยิ่งสำหรับเครื่องกำเนิดไฟฟ้าแบบคงที่ (เช่น Jekyll, next.js, vuepress, hugo)

มีอินเทอร์เฟซที่ใช้งานง่ายเพื่อแก้ไขเนื้อหาของเว็บไซต์หรือแอพของคุณโดยตรงบน GitHub

ดูการสาธิต▶

เอกสาร

ไปที่ pagescms.org/docs

สร้างขึ้นด้วย

• next.js
• tailwind css
• Shadcn/ui
• ละอองฝน
• vercel
• เต่า
• ส่งคืน

ใช้ออนไลน์

วิธีที่ง่ายที่สุดในการเริ่มต้นคือการใช้ CMS เวอร์ชันออนไลน์ คุณจะสามารถเข้าสู่ระบบด้วยบัญชี GitHub ของคุณและรับ CMS เวอร์ชันล่าสุด

เวอร์ชันออนไลน์นี้เหมือนกับสิ่งที่อยู่ใน repo นี้ แต่คุณสามารถติดตั้งเวอร์ชันของคุณเองในพื้นที่หรือปรับใช้ (ฟรี) บน vercel ตามขั้นตอนด้านล่าง

ติดตั้งและปรับใช้

สร้างแอพ GitHub

ไม่ว่าคุณจะติดตั้งหน้า CMS ในเครื่องหรือปรับใช้ออนไลน์คุณจะต้องใช้แอพ GitHub

คุณสามารถสร้างมันภายใต้บัญชีส่วนตัวของคุณ (https://github.com/settings/apps) หรือภายใต้องค์กรของคุณ (https://github.com/organizations//settings/apps)

คุณจะต้องกรอกข้อมูลต่อไปนี้:

• ชื่อแอพ GitHub : ใช้ "หน้า CMS" หรืออะไรก็ตามที่คุณคิดว่าเหมาะสม (เช่น "หน้า CMS (dev)")
• URL หน้าแรก : ไม่ว่าคุณต้องการอะไรก็ตาม https://pagescms.org จะทำ
• การระบุและอนุญาตให้ผู้ใช้ :
  • URL การโทรกลับ: URL สำหรับ /api/auth/github :
    • http://localhost:3000/api/auth/github สำหรับการพัฒนา
    • บางอย่างเช่น https://my-vercel-url.vercel.app/api/auth/github (หรือโดเมนที่กำหนดเองที่คุณใช้) หากคุณกำลังปรับใช้กับ Vercel
  • หมดอายุโทเค็นการอนุญาตของผู้ใช้: ไม่
  • ขอการอนุญาตผู้ใช้ (OAUTH) ระหว่างการติดตั้ง: ใช่
  • เปิดใช้งานการไหลของอุปกรณ์: ไม่
• โพสต์การติดตั้ง :
  • การตั้งค่า URL (ไม่บังคับ): ว่างเปล่า
  • เปลี่ยนเส้นทางการอัปเดต: ไม่
• Webhook :
  • ใช้งาน: ใช่
  • URL WebHook: URL (สาธารณะ) สำหรับ /api/webhook/github :
    • เพื่อการพัฒนาคุณจะต้องใช้บางอย่างเช่น Ngrok คุณจะจบลงด้วยบางอย่างเช่น https://your-unique-subdomain.ngrok-free.app/api/webhook/github
    • บางอย่างเช่น https://my-vercel-url.vercel.app/api/webhook/github (หรือโดเมนที่กำหนดเองที่คุณใช้) หากคุณใช้งานบน Vercel
  • ความลับ: สร้างสตริงแบบสุ่ม (ตัวอย่างเช่น openssl rand -base64 32 บน MacOS/Linux)
• การอนุญาต :
  • สิทธิ์ที่เก็บ:
    • การบริหาร: อ่านและเขียน
    • สารบัญ: อ่านและเขียน
    • ข้อมูลเมตา: อ่านเท่านั้น
  • สิทธิ์ขององค์กร: ไม่มีอะไร
  • สิทธิ์บัญชี: ไม่มีอะไร
• สมัครสมาชิกกิจกรรม :
  • เป้าหมายการติดตั้ง
  • ที่เก็บ (คุณอาจต้องเพิ่มสิ่งนี้หลังจากสร้างแอพ GitHub)
• แอพ GitHub นี้สามารถติดตั้งได้ที่ไหน? : คุณจะต้องเลือก "บัญชีใด ๆ " เว้นแต่ว่าคุณตั้งใจจะใช้หน้า CMS ในบัญชีแอป GitHub นี้เท่านั้น

ตัวแปรสภาพแวดล้อม

ตัวแปร	ความเห็น
CRYPTO_KEY	ใช้เพื่อเข้ารหัส/ถอดรหัสโทเค็น GitHub ในฐานข้อมูล บน MacOS/Linux*คุณสามารถใช้ openssl rand -base64 32
GITHUB_APP_ID	GitHub App ID จากหน้ารายละเอียดแอพ GitHub ของคุณ
GITHUB_APP_NAME	ชื่อเครื่องสำหรับแอพ GitHub ของคุณ (เช่น pages-cms ) ควรเป็น Slug URL ของหน้ารายละเอียดแอพ GitHub ของคุณ
GITHUB_APP_PRIVATE_KEY	ไฟล์ PEM คุณสามารถดาวน์โหลดการสร้างแอป GitHub ได้
GITHUB_APP_WEBHOOK_SECRET	ความลับที่คุณเลือกสำหรับ webhook ของคุณ สิ่งนี้ใช้เพื่อให้แน่ใจว่าคำขอมาจาก GitHub
GITHUB_APP_CLIENT_ID	GitHub App Client ID จากหน้ารายละเอียดแอพ GitHub ของคุณ
GITHUB_APP_CLIENT_SECRET	GitHub App Client Secret คุณสร้างขึ้นในหน้ารายละเอียดแอพ 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 แล้วและมีอุโมงค์ที่กำลังทำงานอยู่สำหรับ Witchub 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. สร้างส้อม : ส้อม repo pages-cms/pages-cms ในบัญชีของคุณและปรับใช้ส้อมนั้น สิ่งนี้จะช่วยให้คุณได้รับการอัปเดต ตรวจสอบให้แน่ใจว่าคุณกำหนดตัวแปรสภาพแวดล้อมทั้งหมดที่ระบุไว้ข้างต้น

   2. ใช้ปุ่มปรับใช้ :

3. อัปเดตแอพ GitHub OAuth ของคุณ : คุณอาจต้องกลับไปที่การตั้งค่าแอป GitHub ของคุณเพื่ออัปเดตการตั้งค่าบางอย่างเมื่อคุณมี URL vercel (เช่น "URL โทรกลับ" และ "WebHook URL")

เป็นเจ้าภาพ

มีตัวเลือกอื่น ๆ อีกมากมาย: Fly.io, Digital Ocean, Render, SST ฯลฯ

ใบอนุญาต

ทุกอย่างใน repo นี้ได้รับการปล่อยตัวภายใต้ใบอนุญาต MIT