@plutocms/core 0.47.1 → 0.48.0

package/app/components/Pluto/PlutoHtml.vue

@@ -7,7 +7,10 @@
 // The prose look is `.pluto-prose` in app/assets/css/pluto-base.css: plain CSS that a site
 // imports with `@plutocms/css/base`. No Tailwind class here, so the component works on a site
 // with no Tailwind. See the public-components skill.
-withDefaults(
+//
+// A site under a sub path (a project site of GitHub Pages) gets its base path before each site
+// path of the body (`withBaseInHtml`), so the images and the links of a post still work.
+const props = withDefaults(
   defineProps<{
     html: string
     tag?: string
@@ -16,6 +19,9 @@ withDefaults(
     tag: 'article',
   }
 )
+
+const baseURL = useRuntimeConfig().app.baseURL
+const body = computed(() => withBaseInHtml(props.html, baseURL))
 </script>
 
 <template>
@@ -23,5 +29,5 @@ withDefaults(
        on a dynamic `<component :is>` drops the value in the SSR output. The
        hyphenated spelling renders a literal `inner-h-t-m-l` attribute. -->
   <!-- eslint-disable-next-line vue/attribute-hyphenation -- must stay camelCase, see comment above -->
-  <component :is="tag" v-if="html" :innerHTML="html" class="pluto-prose" />
+  <component :is="tag" v-if="html" :innerHTML="body" class="pluto-prose" />
 </template>

package/app/composables/internal/async-component.ts

@@ -42,6 +42,10 @@ interface ExtensionComponents {
     id: string
     component: Component
   }[]
+  backend?: {
+    id: string
+    details?: Component
+  }
 }
 
 /**
@@ -68,5 +72,10 @@ export function findSyncComponents(definition: ExtensionComponents): string[] {
     }
   }
 
+  const details = definition.backend?.details
+  if (details && !isAsyncComponent(details)) {
+    found.push(`${definition.id}:backend:${definition.backend!.id}`)
+  }
+
   return found
 }

package/app/composables/pluto-extension.ts

@@ -47,6 +47,10 @@ export function definePlutoExtension(definition: PlutoExtension): void {
   registry.accountMenu.set(definition.id, definition.accountMenu ?? [])
   registry.adminBanners.set(definition.id, definition.adminBanners ?? [])
   registry.siteInfo.set(definition.id, definition.site ? [definition.site] : [])
+  registry.backend.set(
+    definition.id,
+    definition.backend ? [definition.backend] : []
+  )
   registry.contentTypes.set(definition.id, definition.contentTypes ?? [])
   registry.contentFieldWidgets.set(
     definition.id,

package/app/composables/pluto-navbar.ts

@@ -131,3 +131,28 @@ export function usePlutoSiteInfo() {
     url: computed(() => pick('url')),
   }
 }
+
+/**
+ * The backend that stores the content, for the badge of the admin navbar. The last registered
+ * entry wins. `null` when no backend gives one.
+ */
+export function usePlutoBackend() {
+  const registry = usePlutoRegistry()
+  const { tx } = usePlutoI18n()
+
+  const backend = computed(() => {
+    const entry = registry.backend.list.value.at(-1)
+    if (!entry) {
+      return null
+    }
+    const count = Math.max(0, Math.trunc(Number(entry.count?.() ?? 0)) || 0)
+    return {
+      ...entry,
+      label: tx(entry.label),
+      count,
+      countLabel: count && entry.countLabel ? tx(entry.countLabel, count) : '',
+    }
+  })
+
+  return { backend }
+}

package/app/composables/pluto-registry.ts

@@ -29,6 +29,7 @@ export function usePlutoRegistry(): PlutoRegistry {
       accountMenu: createOwnedRegistry<PlutoAccountMenuItem>(),
       adminBanners: createOwnedRegistry<PlutoAdminBanner>(),
       siteInfo: createOwnedRegistry<PlutoSiteInfo>(),
+      backend: createOwnedRegistry<PlutoBackendInfo>(),
       contentTypes: createOwnedRegistry<PlutoContentTypeEntry>(),
       contentFieldWidgets: createOwnedRegistry<PlutoContentFieldWidget>(),
       contentActions: createOwnedRegistry<PlutoContentAction>(),

package/i18n/locales/en.json

@@ -20,7 +20,9 @@
       "create": "Create",
       "error": "Error",
       "switchToLightMode": "Switch to light mode",
-      "switchToDarkMode": "Switch to dark mode"
+      "switchToDarkMode": "Switch to dark mode",
+      "copy": "Copy",
+      "copied": "Copied"
     },
     "navbar": {
       "openNavigation": "Open navigation",
@@ -169,7 +171,8 @@
       "tabs": {
         "general": "General",
         "email": "Email",
-        "github": "GitHub"
+        "github": "GitHub",
+        "deploy": "Deploy"
       },
       "noPermission": {
         "title": "You cannot open this page",
@@ -371,6 +374,156 @@
             "retry": "Start again"
           }
         }
+      },
+      "backend": {
+        "local": "Local",
+        "github": "GitHub",
+        "description": "Each save is a commit in this repo, made with your GitHub account.",
+        "repo": "Repo",
+        "branch": "Branch",
+        "private": "Private",
+        "public": "Public",
+        "openRepo": "Open the repo",
+        "commits": "Commits"
+      },
+      "local": {
+        "description": "Each save writes a Markdown file in this project and makes a commit in your local Git repo. The live site changes after you push.",
+        "ahead": "No commits to push | 1 commit not pushed | {count} commits not pushed",
+        "aheadShort": "{count} to push",
+        "upToDate": "All commits are pushed.",
+        "noGit": "Git is not installed. Saves only write the files.",
+        "notARepo": "This project is not a Git repo. Saves only write the files.",
+        "detached": "Git is not on a branch. Check out a branch to push.",
+        "noRemote": "The repo has no remote. Add one to push, for example with git remote add origin <url>.",
+        "push": "Push",
+        "pushed": "Pushed.",
+        "pushHint": "Push runs git push on this computer.",
+        "errors": {
+          "notARepo": "This project is not a Git repo.",
+          "detached": "Git is not on a branch.",
+          "noRemote": "The repo has no remote.",
+          "rejected": "The remote has commits that this repo does not have. Run git pull, then push again.",
+          "auth": "Git could not sign in to the remote. Run git push in a terminal to sign in.",
+          "timeout": "The push took too long. Run git push in a terminal to see why.",
+          "failed": "Git could not push. Run git push in a terminal to see why."
+        }
+      },
+      "users": {
+        "title": "Users",
+        "description": "The people with write access to {repo} on GitHub can sign in to the admin. GitHub controls the access: add or remove people there.",
+        "manage": "Manage access on GitHub",
+        "restricted": "NUXT_PLUTO_GITHUB_ALLOWED_USERS is set: only the users in that list can sign in.",
+        "error": "Could not load the users",
+        "empty": "No user has write access to the repo.",
+        "you": "You",
+        "columns": {
+          "user": "User",
+          "role": "GitHub role",
+          "access": "In Pluto"
+        },
+        "roles": {
+          "admin": "Admin",
+          "maintain": "Maintain",
+          "write": "Write"
+        },
+        "access": {
+          "admin": "Administrator: everything",
+          "editor": "Editor: write, publish and delete content"
+        },
+        "blocked": "Cannot sign in: not in ALLOWED_USERS",
+        "footnote": "People with the Triage or Read role on GitHub cannot sign in.",
+        "reason": {
+          "noApp": {
+            "title": "The list needs the GitHub App",
+            "description": "In local mode you are the only user. To see the people of the GitHub repo here, set up the GitHub App.",
+            "action": "Set up the GitHub App"
+          },
+          "noRepo": {
+            "title": "No GitHub repo",
+            "description": "Pluto does not know the GitHub repo of this site. Set PLUTO_GITHUB_REPO, or add a GitHub remote named origin."
+          },
+          "appError": {
+            "title": "The GitHub App cannot read the repo",
+            "description": "The App gave no token. Check that it is installed on the repo, and that its private key is right.",
+            "action": "Check the GitHub App"
+          }
+        }
+      },
+      "deploy": {
+        "intro": "Put the site online. Pick a host.",
+        "error": "Could not load the deploy settings",
+        "full": {
+          "title": "The site and the admin",
+          "description": "These hosts run the whole app. Editors sign in on the live site with GitHub, and a save is live in seconds.",
+          "after": "After the first deploy, open /admin on the live site. It shows how to create the GitHub App that editors use to sign in."
+        },
+        "hosts": {
+          "vercel": {
+            "name": "Vercel",
+            "description": "Import this repo. Vercel finds Nuxt and the repo by itself.",
+            "action": "Deploy to Vercel"
+          },
+          "netlify": {
+            "name": "Netlify",
+            "description": "Import this repo from your GitHub account. Netlify finds Nuxt by itself.",
+            "action": "Deploy to Netlify"
+          },
+          "node": {
+            "name": "A Node host",
+            "description": "Any host that runs Node.js. Build with nuxt build, then start .output/server/index.mjs.",
+            "action": "Read the guide"
+          }
+        },
+        "static": {
+          "title": "A static site",
+          "description": "The site is plain files, so the host is simple and free. The admin stays on your computer: save, push, and the host builds the site again."
+        },
+        "pages": {
+          "name": "GitHub Pages",
+          "description": "A GitHub Action builds the site on each push and puts it on GitHub Pages. The build needs no secret.",
+          "ready": "Ready",
+          "open": "Open the site",
+          "setup": "Set up GitHub Pages",
+          "settings": "Pages settings on GitHub",
+          "showWorkflow": "Show the workflow",
+          "hideWorkflow": "Hide the workflow",
+          "workflow": {
+            "done": "The workflow is in the project:",
+            "old": "The workflow is in the project, but Pluto has a new version:",
+            "missing": "The workflow is not in the project yet:"
+          },
+          "state": {
+            "on": "GitHub Pages is on, with GitHub Actions as the source.",
+            "legacy": "GitHub Pages is on, but it builds from a branch. Set up moves it to GitHub Actions.",
+            "off": "GitHub Pages is off for the repo."
+          },
+          "reason": {
+            "no-gh": "Pluto cannot see GitHub Pages: the GitHub CLI (gh) is not installed. Set up still writes the workflow. Then turn Pages on in the settings of the repo.",
+            "signed-out": "Pluto cannot see GitHub Pages: the GitHub CLI is not signed in. Run gh auth login, or turn Pages on in the settings of the repo.",
+            "error": "Pluto cannot see GitHub Pages for the repo."
+          },
+          "done": {
+            "title": "GitHub Pages is set up",
+            "description": "Push your commits to deploy: use the Git badge in the bar, or run git push. The first build takes a few minutes."
+          },
+          "partial": {
+            "title": "The workflow is ready",
+            "description": "Pluto could not turn GitHub Pages on. Open the Pages settings of the repo, and set the source to GitHub Actions. Then push your commits."
+          },
+          "manual": {
+            "step1": "Add the workflow below to the repo, at the path that it shows.",
+            "step2": "In the Pages settings of the repo, set the source to GitHub Actions.",
+            "step3": "Push. The Action builds and deploys the site."
+          },
+          "nodeAdmin": "An admin on a Node host can use the same site: set commit.skipDeploy to false, so that each save of published content starts a build."
+        },
+        "cloudflare": {
+          "name": "Cloudflare Pages",
+          "description": "Connect the repo in Cloudflare, and use these build settings.",
+          "command": "Build command",
+          "output": "Output directory",
+          "action": "Open Cloudflare"
+        }
       }
     },
     "validation": {
@@ -751,6 +904,15 @@
         "clear": "Clear the selection"
       },
       "dropHint": "Drop files here, or upload them. Every layer of the site uses this library."
+    },
+    "backend": {
+      "kind": {
+        "git": "Git",
+        "database": "Database"
+      },
+      "open": "Where the content is: {name}",
+      "gitMode": "Git mode: the content is Markdown files in a Git repo.",
+      "databaseMode": "Database mode: the content is in a database."
     }
   }
 }

package/i18n/locales/pt-BR.json

@@ -20,7 +20,9 @@
       "create": "Criar",
       "error": "Erro",
       "switchToLightMode": "Mudar para o tema claro",
-      "switchToDarkMode": "Mudar para o tema escuro"
+      "switchToDarkMode": "Mudar para o tema escuro",
+      "copy": "Copiar",
+      "copied": "Copiado"
     },
     "navbar": {
       "openNavigation": "Abrir a navegação",
@@ -169,7 +171,8 @@
       "tabs": {
         "general": "Geral",
         "email": "E-mail",
-        "github": "GitHub"
+        "github": "GitHub",
+        "deploy": "Publicar"
       },
       "noPermission": {
         "title": "Você não pode abrir esta página",
@@ -371,6 +374,156 @@
             "retry": "Começar de novo"
           }
         }
+      },
+      "backend": {
+        "local": "Local",
+        "github": "GitHub",
+        "description": "Cada salvamento é um commit neste repositório, feito com a sua conta do GitHub.",
+        "repo": "Repositório",
+        "branch": "Branch",
+        "private": "Privado",
+        "public": "Público",
+        "openRepo": "Abrir o repositório",
+        "commits": "Commits"
+      },
+      "local": {
+        "description": "Cada salvamento grava um arquivo Markdown neste projeto e faz um commit no seu repositório Git local. O site no ar muda depois do push.",
+        "ahead": "Nenhum commit para enviar | 1 commit não enviado | {count} commits não enviados",
+        "aheadShort": "{count} para enviar",
+        "upToDate": "Todos os commits foram enviados.",
+        "noGit": "O Git não está instalado. Os salvamentos só gravam os arquivos.",
+        "notARepo": "Este projeto não é um repositório Git. Os salvamentos só gravam os arquivos.",
+        "detached": "O Git não está em uma branch. Faça checkout de uma branch para enviar.",
+        "noRemote": "O repositório não tem remote. Adicione um para enviar, por exemplo com git remote add origin <url>.",
+        "push": "Enviar",
+        "pushed": "Enviado.",
+        "pushHint": "Enviar roda git push neste computador.",
+        "errors": {
+          "notARepo": "Este projeto não é um repositório Git.",
+          "detached": "O Git não está em uma branch.",
+          "noRemote": "O repositório não tem remote.",
+          "rejected": "O remote tem commits que este repositório não tem. Rode git pull e envie de novo.",
+          "auth": "O Git não conseguiu entrar no remote. Rode git push em um terminal para entrar.",
+          "timeout": "O envio demorou demais. Rode git push em um terminal para ver o motivo.",
+          "failed": "O Git não conseguiu enviar. Rode git push em um terminal para ver o motivo."
+        }
+      },
+      "users": {
+        "title": "Usuários",
+        "description": "As pessoas com acesso de escrita a {repo} no GitHub podem entrar no admin. O GitHub controla o acesso: adicione ou remova pessoas lá.",
+        "manage": "Gerenciar o acesso no GitHub",
+        "restricted": "NUXT_PLUTO_GITHUB_ALLOWED_USERS está definido: só os usuários dessa lista podem entrar.",
+        "error": "Não foi possível carregar os usuários",
+        "empty": "Ninguém tem acesso de escrita ao repositório.",
+        "you": "Você",
+        "columns": {
+          "user": "Usuário",
+          "role": "Papel no GitHub",
+          "access": "No Pluto"
+        },
+        "roles": {
+          "admin": "Admin",
+          "maintain": "Maintain",
+          "write": "Write"
+        },
+        "access": {
+          "admin": "Administrador: tudo",
+          "editor": "Editor: escrever, publicar e excluir conteúdo"
+        },
+        "blocked": "Não pode entrar: fora de ALLOWED_USERS",
+        "footnote": "Pessoas com o papel Triage ou Read no GitHub não podem entrar.",
+        "reason": {
+          "noApp": {
+            "title": "A lista precisa do GitHub App",
+            "description": "No modo local você é o único usuário. Para ver aqui as pessoas do repositório no GitHub, configure o GitHub App.",
+            "action": "Configurar o GitHub App"
+          },
+          "noRepo": {
+            "title": "Nenhum repositório do GitHub",
+            "description": "O Pluto não sabe qual é o repositório do GitHub deste site. Defina PLUTO_GITHUB_REPO ou adicione um remote do GitHub chamado origin."
+          },
+          "appError": {
+            "title": "O GitHub App não consegue ler o repositório",
+            "description": "O App não deu um token. Confira se ele está instalado no repositório e se a chave privada está certa.",
+            "action": "Conferir o GitHub App"
+          }
+        }
+      },
+      "deploy": {
+        "intro": "Coloque o site no ar. Escolha um host.",
+        "error": "Não foi possível carregar as configurações de publicação",
+        "full": {
+          "title": "O site e o admin",
+          "description": "Estes hosts rodam o app inteiro. Os editores entram no site no ar com o GitHub, e um salvamento fica no ar em segundos.",
+          "after": "Depois da primeira publicação, abra /admin no site no ar. Ele mostra como criar o GitHub App que os editores usam para entrar."
+        },
+        "hosts": {
+          "vercel": {
+            "name": "Vercel",
+            "description": "Importe este repositório. A Vercel encontra o Nuxt e o repositório sozinha.",
+            "action": "Publicar na Vercel"
+          },
+          "netlify": {
+            "name": "Netlify",
+            "description": "Importe este repositório da sua conta do GitHub. A Netlify encontra o Nuxt sozinha.",
+            "action": "Publicar na Netlify"
+          },
+          "node": {
+            "name": "Um host Node",
+            "description": "Qualquer host que rode Node.js. Compile com nuxt build e inicie .output/server/index.mjs.",
+            "action": "Ler o guia"
+          }
+        },
+        "static": {
+          "title": "Um site estático",
+          "description": "O site são arquivos simples, então o host é simples e gratuito. O admin fica no seu computador: salve, faça o push, e o host compila o site de novo."
+        },
+        "pages": {
+          "name": "GitHub Pages",
+          "description": "Uma GitHub Action compila o site a cada push e o coloca no GitHub Pages. A compilação não precisa de segredo.",
+          "ready": "Pronto",
+          "open": "Abrir o site",
+          "setup": "Configurar o GitHub Pages",
+          "settings": "Configurações do Pages no GitHub",
+          "showWorkflow": "Mostrar o workflow",
+          "hideWorkflow": "Esconder o workflow",
+          "workflow": {
+            "done": "O workflow está no projeto:",
+            "old": "O workflow está no projeto, mas o Pluto tem uma versão nova:",
+            "missing": "O workflow ainda não está no projeto:"
+          },
+          "state": {
+            "on": "O GitHub Pages está ligado, com o GitHub Actions como fonte.",
+            "legacy": "O GitHub Pages está ligado, mas compila de uma branch. Configurar o passa para o GitHub Actions.",
+            "off": "O GitHub Pages está desligado no repositório."
+          },
+          "reason": {
+            "no-gh": "O Pluto não consegue ver o GitHub Pages: o GitHub CLI (gh) não está instalado. Configurar ainda grava o workflow. Depois ligue o Pages nas configurações do repositório.",
+            "signed-out": "O Pluto não consegue ver o GitHub Pages: o GitHub CLI não está conectado. Rode gh auth login, ou ligue o Pages nas configurações do repositório.",
+            "error": "O Pluto não consegue ver o GitHub Pages do repositório."
+          },
+          "done": {
+            "title": "O GitHub Pages está configurado",
+            "description": "Envie seus commits para publicar: use o selo do Git na barra, ou rode git push. A primeira compilação leva alguns minutos."
+          },
+          "partial": {
+            "title": "O workflow está pronto",
+            "description": "O Pluto não conseguiu ligar o GitHub Pages. Abra as configurações do Pages do repositório e escolha GitHub Actions como fonte. Depois envie seus commits."
+          },
+          "manual": {
+            "step1": "Adicione o workflow abaixo ao repositório, no caminho que ele mostra.",
+            "step2": "Nas configurações do Pages do repositório, escolha GitHub Actions como fonte.",
+            "step3": "Faça o push. A Action compila e publica o site."
+          },
+          "nodeAdmin": "Um admin em um host Node pode usar o mesmo site: defina commit.skipDeploy como false, para que cada salvamento de conteúdo publicado inicie uma compilação."
+        },
+        "cloudflare": {
+          "name": "Cloudflare Pages",
+          "description": "Conecte o repositório na Cloudflare e use estas configurações de compilação.",
+          "command": "Comando de compilação",
+          "output": "Pasta de saída",
+          "action": "Abrir a Cloudflare"
+        }
       }
     },
     "validation": {
@@ -751,6 +904,15 @@
         "clear": "Limpar a seleção"
       },
       "dropHint": "Solte os arquivos aqui ou envie-os. Todas as camadas do site usam esta biblioteca."
+    },
+    "backend": {
+      "kind": {
+        "git": "Git",
+        "database": "Banco de dados"
+      },
+      "open": "Onde o conteúdo fica: {name}",
+      "gitMode": "Modo Git: o conteúdo são arquivos Markdown em um repositório Git.",
+      "databaseMode": "Modo banco de dados: o conteúdo fica em um banco de dados."
     }
   }
 }