pages cms Download - pages cms Code source Télécharger

pages cms

Code Source AI

1.0.0: Pages CMS now runs on Next.js!

Télécharger

Pages CMS

Pages CMS est un système de gestion de contenu open source pour GitHub. Il est particulièrement bien adapté aux générateurs de sites statiques (par exemple Jekyll, next.js, Vuepress, Hugo).

Il propose une interface conviviale pour modifier le contenu de votre site Web ou de votre application directement sur GitHub.

Regardez la démo ▶

Documentation

Accédez à pagescms.org/docs.

Construit avec

Next.js
CSS du vent arrière
shadcn / ui
bruine
Vercel
Turso
Revivre

Utiliser en ligne

La façon la plus simple de commencer est d'utiliser la version en ligne de Pages CMS. Vous pourrez vous connecter avec votre compte GitHub et obtenir la dernière version de Pages CMS.

Cette version en ligne est identique à ce qui est dans ce dépôt, mais vous pouvez également installer votre propre version localement ou la déployer (gratuitement) sur Vercel en suivant les étapes ci-dessous.

Installer et déployer

Créer une application GitHub

Que vous installiez des pages CMS localement ou que vous les déployiez en ligne, vous aurez besoin d'une application GitHub.

Vous pouvez le créer sous votre compte personnel (https://github.com/settings/apps) ou sous l'une de vos organisations (https://github.com/organizations//settings/apps).

Vous devrez remplir les informations suivantes:

Nom de l'application GitHub : utilisez "Pages CMS" ou tout ce que vous pensez être approprié (par exemple "Pages CMS (Dev)").
URL de page d'accueil : tout ce que vous voulez, https://pagescms.org fera l'affaire.
Identification et autorisation des utilisateurs :
- URL de rappel: l'URL pour /api/auth/github :
  - http://localhost:3000/api/auth/github pour le développement,
  - Quelque chose comme https://my-vercel-url.vercel.app/api/auth/github (ou quel que soit le domaine personnalisé que vous utilisez) si vous déployez sur Vercel.
- Expirer les jetons d'autorisation utilisateur: no.
- Demandez l'autorisation de l'utilisateur (OAuth) lors de l'installation: oui.
- Activer le flux de l'appareil: no.
Installation post-post :
- Configuration de l'URL (facultative): laissez vide.
- Rediriger la mise à jour: non.
Webhook :
- Actif: oui.
- URL WebHook: l'URL (publique) pour /api/webhook/github :
  - Pour le développement, vous devrez utiliser quelque chose comme Ngrok. Vous vous retrouverez avec quelque chose comme https://your-unique-subdomain.ngrok-free.app/api/webhook/github .
  - Quelque chose comme https://my-vercel-url.vercel.app/api/webhook/github (ou quel que soit le domaine personnalisé que vous utilisez) si vous déployez sur Vercel.
- Secret: Générez une chaîne aléatoire (par exemple avec openssl rand -base64 32 sur macOS / Linux)
Autorisations :
- Autorisations de référentiel:
  - Administration: lire et écrire
  - Contenu: lire et écrire
  - Métadonnées: lire uniquement
- Autorisations d'organisation: rien.
- Autorisations de compte: rien.
Abonnez-vous aux événements :
- Cible d'installation
- Référentiel (vous devrez probablement l'ajouter après avoir créé l'application GitHub)
Où cette application GitHub peut-elle être installée? : Vous voudrez sélectionner "n'importe quel compte", sauf si vous avez l'intention d'utiliser uniquement des pages CMS sur le compte dans cette application GitHub est créée.

Variables d'environnement

Variable	Commentaires
`CRYPTO_KEY`	Utilisé pour crypter / décrypter les jetons GitHub dans la base de données. Sur MacOS / Linux *, vous pouvez utiliser `openssl rand -base64 32` .
`GITHUB_APP_ID`	ID d'application GitHub à partir de la page Détails de votre application GitHub.
`GITHUB_APP_NAME`	Le nom de la machine pour votre application GitHub (par exemple `pages-cms` ), devrait être la Slug L'URL de la page Détails de votre application GitHub.
`GITHUB_APP_PRIVATE_KEY`	Fichier PEM Vous pouvez télécharger Upong Creation de l'application GitHub.
`GITHUB_APP_WEBHOOK_SECRET`	Le secret que vous avez choisi pour votre webhook. Ceci est utilisé pour s'assurer que la demande provient de GitHub.
`GITHUB_APP_CLIENT_ID`	ID du client GitHub App à partir de la page Détails de votre application GitHub.
`GITHUB_APP_CLIENT_SECRET`	GitHub App Client Secret Vous générez sur la page Détails de l'application TheGitHub.
`RESEND_API_KEY`	Vous obtiendrez cela lorsque vous créez un compte de renvoi (gratuit) pour gérer les e-mails.
`SQLITE_URL`	`file:./local.db` pour le développement, `libsql://pages-cms-username.turso.io` par exemple si vous utilisez TUSSO (vous devriez, TUSSO est génial).
`SQLITE_AUTH_TOKEN`	Laissez vide pour le développement, sinon utilisez le jeton fourni par Turso (si c'est ce que vous utilisez).
`BASE_URL`	FACULTATIF . Si vous vous déployez sur Vercel ou travaillez localement, vous n'en aurez pas besoin. Si vous déploiez ailleurs, vous devrez spécifier l'URL de base pour l'application (par exemple `https://mycustomdomain.com` ).

Développement local

Nous supposons que vous avez déjà créé l'application GitHub et avez un tunnel en cours d'exécution pour l'application GitHub WebHook (en utilisant Ngrok par exemple):

Installer les dépendances : npm install
Mettez à jour vos variables d'environnement : copiez .env.example sur .env et remplissez les valeurs en fonction de votre paramètre (voir la section ci-dessus).
Créez la base de données : npm run db:migrate
Exécutez-le : npm run dev

Déployer sur Vercel

Créez une base de données SQLite : je recommande d'utiliser Turso, car c'est gratuit (et assez génial)
Déployer sur Vercel : À ce stade, vous avez 2 choix:
1. Créez une fourche : fourchez le repo pages-cms/pages-cms dans votre compte et déployez cette fourche. Cela vous permettra d'obtenir des mises à jour. Assurez-vous de définir toutes les variables d'environnement énumérées ci-dessus .
2. Utilisez le bouton Déployer :
Mettez à jour votre application GitHub OAuth : vous devrez probablement revenir aux paramètres de votre application GitHub pour mettre à jour certains des paramètres une fois que vous aurez l'URL Vercel (par exemple "URL de rappel" et "URL Webhook").