@gitpagedocs/cli 0.0.10 → 0.0.11

package/data/i18n-langmenu.mjs

@@ -7,8 +7,8 @@ export const defaultLangMenu = {
           PdfUnavailable: "A prévia do PDF depende do navegador. Use as ações disponíveis para abrir ou baixar o documento.",
           PdfDownloadError: "Não foi possível baixar o PDF. Tente abrir o documento em uma nova aba.",
           PdfDownloading: "Baixando PDF...",
-          pt: "Portugues",
-          en: "Ingles",
+          pt: "Português",
+          en: "Inglês",
           es: "Espanhol",
           footerLabel: "Projeto",
           menuOpen: "Menu",
@@ -20,11 +20,11 @@ export const defaultLangMenu = {
           mdDownloadLabel: "Baixar .md",
           hideMenu: "Fechar menu",
           quickNavigation: "Ctrl+K",
-          searchOwnerLabel: "Usuario (ex: Vidigal-code)",
-          searchRepoLabel: "Repositorio (ex: git-page-link-create)",
+          searchOwnerLabel: "Usuário (ex: Vidigal-code)",
+          searchRepoLabel: "Repositório (ex: git-page-link-create)",
           searchButtonLabel: "Buscar",
           typeToNavigate: "Digite para navegar...",
-          noNavigationResults: "Nenhum resultado de navegacao.",
+          noNavigationResults: "Nenhum resultado de navegação.",
           focusMode: "Modo foco",
           focusFirstDocument: "Primeiro documento",
           focusLastDocument: "Último documento",
@@ -51,27 +51,27 @@ export const defaultLangMenu = {
           narrationSpeaking: "Lendo documento",
           narrationPaused: "Leitura pausada",
           narrationSettingsHint: "As vozes são fornecidas pelo navegador. Pare a leitura para alterar as preferências.",
-          versionLinksLabel: "Links do repositorio",
+          versionLinksLabel: "Links do repositório",
           titleHeaderMenuMd: "Markdown",
-          titleHeaderMenuSourceViewer: "Codigo fonte",
+          titleHeaderMenuSourceViewer: "Código fonte",
           titleHeaderMenuVideo: "Vídeo",
           titleHeaderMenuAudio: "Áudio",
           titleHeaderMenuHtml: "Páginas",
           sourceViewerBranchLabel: "Branch",
           sourceViewerFilterLabel: "Filtrar arquivos",
           sourceViewerClearLabel: "Limpar",
-          sourceViewerLoadingTree: "Carregando arvore do repositorio...",
+          sourceViewerLoadingTree: "Carregando árvore do repositório...",
           sourceViewerLoadingFile: "Carregando arquivo...",
-          sourceViewerNotFound: "Repositorio, branch ou arvore de codigo nao encontrado.",
-          sourceViewerFileError: "Nao foi possivel carregar o arquivo.",
+          sourceViewerNotFound: "Repositório, branch ou árvore de código não encontrado.",
+          sourceViewerFileError: "Não foi possível carregar o arquivo.",
           sourceViewerEmpty: "Nenhuma entrada encontrada.",
           sourceViewerSelectFile: "Selecione um arquivo",
           sourceViewerPreview: "Preview",
-          sourceViewerCode: "Codigo",
-          sourceViewerEntryHint: "Explore os arquivos de um repositorio sem abrir a documentacao.",
-          sourceViewerEntryAction: "Abrir o visualizador de codigo",
+          sourceViewerCode: "Código",
+          sourceViewerEntryHint: "Explore os arquivos de um repositório sem abrir a documentação.",
+          sourceViewerEntryAction: "Abrir o visualizador de código",
           sourceViewerBackLabel: "Voltar",
-          lastUpdateVersionLabel: "Ultima versao de atualizacao",
+          lastUpdateVersionLabel: "Ultima versão de atualização",
           darkMode: "Modo escuro",
           lightMode: "Modo claro",
           blockMenuOnNavActive: "Bloquear menu na navegação",
@@ -345,24 +345,24 @@ export const defaultLangMenu = {
           PdfUnavailable: "La vista previa del PDF depende del navegador. Usa las acciones disponibles para abrir o descargar el documento.",
           PdfDownloadError: "No se pudo descargar el PDF. Intenta abrir el documento en una pestaña nueva.",
           PdfDownloading: "Descargando PDF...",
-          pt: "Portugues",
-          en: "Ingles",
-          es: "Espanol",
+          pt: "Portugués",
+          en: "Inglés",
+          es: "Español",
           footerLabel: "Proyecto",
-          menuOpen: "Menu",
+          menuOpen: "Menú",
           menuClose: "Cerrar",
-          showMenu: "Abrir menu",
+          showMenu: "Abrir menú",
           mdCopyLabel: "Copiar Markdown",
           mdCopiedLabel: "¡Copiado!",
           mdCopyErrorLabel: "No se pudo copiar",
           mdDownloadLabel: "Descargar .md",
-          hideMenu: "Cerrar menu",
+          hideMenu: "Cerrar menú",
           quickNavigation: "Ctrl+K",
           searchOwnerLabel: "Usuario (ej: Vidigal-code)",
           searchRepoLabel: "Repositorio (ej: git-page-link-create)",
           searchButtonLabel: "Buscar",
           typeToNavigate: "Escribe para navegar...",
-          noNavigationResults: "Sin resultados de navegacion.",
+          noNavigationResults: "Sin resultados de navegación.",
           focusMode: "Modo foco",
           focusFirstDocument: "Primer documento",
           focusLastDocument: "Último documento",
@@ -391,25 +391,25 @@ export const defaultLangMenu = {
           narrationSettingsHint: "El navegador proporciona las voces. Detén la lectura para cambiar las preferencias.",
           versionLinksLabel: "Enlaces del repositorio",
           titleHeaderMenuMd: "Markdown",
-          titleHeaderMenuSourceViewer: "Codigo fuente",
+          titleHeaderMenuSourceViewer: "Código fuente",
           titleHeaderMenuVideo: "Vídeo",
           titleHeaderMenuAudio: "Áudio",
           titleHeaderMenuHtml: "Páginas",
           sourceViewerBranchLabel: "Branch",
           sourceViewerFilterLabel: "Filtrar archivos",
           sourceViewerClearLabel: "Limpiar",
-          sourceViewerLoadingTree: "Cargando arbol del repositorio...",
+          sourceViewerLoadingTree: "Cargando árbol del repositorio...",
           sourceViewerLoadingFile: "Cargando archivo...",
-          sourceViewerNotFound: "Repositorio, branch o arbol de codigo no encontrado.",
+          sourceViewerNotFound: "Repositorio, branch o árbol de código no encontrado.",
           sourceViewerFileError: "No se pudo cargar el archivo.",
           sourceViewerEmpty: "No se encontraron entradas.",
           sourceViewerSelectFile: "Selecciona un archivo",
           sourceViewerPreview: "Preview",
-          sourceViewerCode: "Codigo",
-          sourceViewerEntryHint: "Explora los archivos de un repositorio sin abrir la documentacion.",
-          sourceViewerEntryAction: "Abrir el visor de codigo",
+          sourceViewerCode: "Código",
+          sourceViewerEntryHint: "Explora los archivos de un repositorio sin abrir la documentación.",
+          sourceViewerEntryAction: "Abrir el visor de código",
           sourceViewerBackLabel: "Volver",
-          lastUpdateVersionLabel: "Ultima version de actualizacion",
+          lastUpdateVersionLabel: "Ultima versión de actualización",
           darkMode: "Modo oscuro",
           lightMode: "Modo claro",
           blockMenuOnNavActive: "Bloquear menú en la navegación",

package/data/i18n-translations.mjs

@@ -1,20 +1,20 @@
 export const defaultTranslations = {
       notFound: {
-        title: { pt: "Pagina nao encontrada", en: "Page not found", es: "Pagina no encontrada" },
+        title: { pt: "Página não encontrada", en: "Page not found", es: "Página no encontrada" },
         description: {
-          pt: "A pagina de documentacao solicitada nao existe neste contexto de repositorio.",
+          pt: "A página de documentação solicitada não existe neste contexto de repositório.",
           en: "The requested documentation page does not exist in this repository context.",
-          es: "La pagina de documentacion solicitada no existe en este contexto de repositorio.",
+          es: "La página de documentación solicitada no existe en este contexto de repositorio.",
         },
-        returnHome: { pt: "Voltar para inicio", en: "Return Home", es: "Volver al inicio" },
+        returnHome: { pt: "Voltar para início", en: "Return Home", es: "Volver al inicio" },
       },
       navigation: {
         previous: { pt: "Voltar", en: "Previous", es: "Volver" },
-        next: { pt: "Proximo", en: "Next", es: "Siguiente" },
-        menuOpen: { pt: "Menu", en: "Menu", es: "Menu" },
+        next: { pt: "Próximo", en: "Next", es: "Siguiente" },
+        menuOpen: { pt: "Menu", en: "Menu", es: "Menú" },
         menuClose: { pt: "Fechar", en: "Close", es: "Cerrar" },
         browsePrev: { pt: "Anterior", en: "Previous", es: "Anterior" },
-        browseNext: { pt: "Proximo", en: "Next", es: "Siguiente" },
+        browseNext: { pt: "Próximo", en: "Next", es: "Siguiente" },
       },
       footer: { footerLabel: { pt: "Projeto", en: "Project", es: "Proyecto" } },
     };

package/data/menu-sections.mjs

@@ -1,22 +1,28 @@
+import { COMPOSED_PAGE_MENU } from "./composed-pages.mjs";
+
 export const MARKDOWN_MENU_SECTIONS = [
   1,
   2,
   {
     id: 1000,
+    routeId: 31,
     titles: { en: "Guides", pt: "Guias", es: "Guías" },
     submenus: [
       {
         id: 1001,
+        routeId: 32,
         titles: { en: "Configure your site", pt: "Configure seu site", es: "Configura tu sitio" },
         submenus: [13, 25, 16, 20],
       },
       {
         id: 1002,
+        routeId: 33,
         titles: { en: "Read and explore", pt: "Leia e explore", es: "Lee y explora" },
-        submenus: [22, 21, 24, 30],
+        submenus: [22, 21, 24, 30, 40, COMPOSED_PAGE_MENU],
       },
       {
         id: 1003,
+        routeId: 34,
         titles: { en: "Automate and integrate", pt: "Automatize e integre", es: "Automatiza e integra" },
         submenus: [18, 19, 6],
       },
@@ -24,15 +30,18 @@ export const MARKDOWN_MENU_SECTIONS = [
   },
   {
     id: 1100,
+    routeId: 35,
     titles: { en: "Operations and development", pt: "Operação e desenvolvimento", es: "Operación y desarrollo" },
     submenus: [
       {
         id: 1101,
+        routeId: 36,
         titles: { en: "Ship and maintain", pt: "Publique e mantenha", es: "Publica y mantén" },
         submenus: [14, 26, 27, 17],
       },
       {
         id: 1102,
+        routeId: 37,
         titles: { en: "Develop the project", pt: "Desenvolva o projeto", es: "Desarrolla el proyecto" },
         submenus: [15, 28, 3],
       },
@@ -40,6 +49,7 @@ export const MARKDOWN_MENU_SECTIONS = [
   },
   {
     id: 1200,
+    routeId: 38,
     titles: { en: "Git and GitHub", pt: "Git e GitHub", es: "Git y GitHub" },
     submenus: [5, 4],
   },

package/data/path-mappings.mjs

@@ -4,6 +4,7 @@ export const PDF_GUIDE_FILENAME = "gitpagedocs-project-guide.pdf";
 export const HTML_DOOM_FILENAME = "doom.html";
 
 export const ROUTE_PATHS = {
+  40: { en: "content-blocks.md", pt: "content-blocks.md", es: "content-blocks.md" },
   1: { pt: "getting-started.md", en: "getting-started.md", es: "getting-started.md" },
   2: { pt: "project-overview.md", en: "project-overview.md", es: "project-overview.md" },
   3: { pt: "functionalities.md", en: "functionalities.md", es: "functionalities.md" },
@@ -26,6 +27,14 @@ export const ROUTE_PATHS = {
   27: { pt: "troubleshooting.md", en: "troubleshooting.md", es: "troubleshooting.md" },
   28: { pt: "contributing.md", en: "contributing.md", es: "contributing.md" },
   30: { pt: "html-containers.md", en: "html-containers.md", es: "html-containers.md" },
+  31: { pt: "guides.md", en: "guides.md", es: "guides.md" },
+  32: { pt: "configure-your-site.md", en: "configure-your-site.md", es: "configure-your-site.md" },
+  33: { pt: "read-and-explore.md", en: "read-and-explore.md", es: "read-and-explore.md" },
+  34: { pt: "automate-and-integrate.md", en: "automate-and-integrate.md", es: "automate-and-integrate.md" },
+  35: { pt: "operations-and-development.md", en: "operations-and-development.md", es: "operations-and-development.md" },
+  36: { pt: "ship-and-maintain.md", en: "ship-and-maintain.md", es: "ship-and-maintain.md" },
+  37: { pt: "develop-the-project.md", en: "develop-the-project.md", es: "develop-the-project.md" },
+  38: { pt: "git-and-github.md", en: "git-and-github.md", es: "git-and-github.md" },
 };
 
 export const VIDEO_IDS = ["bdIJkGr2NV0", "c67GaAkf1BE", "N3my6W_Rdwg", "r8jQ9hVA2qs"];
@@ -39,7 +48,7 @@ export const PAGE2_AUDIO = {
     {
       url: "https://www.youtube.com/watch?v=0w80F8FffQ4",
       type: "youtube",
-      title: { pt: "Musica pagina 2", en: "Page 2 music", es: "Musica pagina 2" },
+      title: { pt: "Música página 2", en: "Page 2 music", es: "Música página 2" },
     },
   ],
 };

package/data/route-metas.mjs

@@ -39,6 +39,10 @@ export const ROUTE_META_ID6 = {
 };
 
 export const REFERENCE_ROUTE_METAS = {
+  40: {
+    titles: { en: "Ordered content blocks", pt: "Blocos de conteúdo ordenados", es: "Bloques de contenido ordenados" },
+    descriptions: { en: "Combine and repeat content in one page", pt: "Combine e repita conteúdos na mesma página", es: "Combina y repite contenidos en una página" },
+  },
   13: {
     titles: { pt: "Configuração", en: "Configuration", es: "Configuración" },
     descriptions: { pt: "Idiomas, ícones, navegação, foco e acessibilidade", en: "Languages, icons, navigation, focus and accessibility", es: "Idiomas, iconos, navegación, foco y accesibilidad" },
@@ -103,35 +107,67 @@ export const REFERENCE_ROUTE_METAS = {
     titles: { pt: "Containers HTML", en: "HTML containers", es: "Contenedores HTML" },
     descriptions: { pt: "Páginas HTML, URLs externas e o exemplo interativo DOOM", en: "HTML pages, external URLs and the interactive DOOM example", es: "Páginas HTML, URLs externas y el ejemplo interactivo DOOM" },
   },
+  31: {
+    titles: { pt: "Guias", en: "Guides", es: "Guías" },
+    descriptions: { pt: "Escolha um caminho para configurar, ler ou integrar", en: "Choose a path to configure, read or integrate", es: "Elige un recorrido para configurar, leer o integrar" },
+  },
+  32: {
+    titles: { pt: "Configure seu site", en: "Configure your site", es: "Configura tu sitio" },
+    descriptions: { pt: "Organize conteúdo, navegação e apresentação", en: "Organize content, navigation and presentation", es: "Organiza contenido, navegación y presentación" },
+  },
+  33: {
+    titles: { pt: "Leia e explore", en: "Read and explore", es: "Lee y explora" },
+    descriptions: { pt: "Escolha como ler documentos e exemplos interativos", en: "Choose how to read documents and interactive examples", es: "Elige cómo leer documentos y ejemplos interactivos" },
+  },
+  34: {
+    titles: { pt: "Automatize e integre", en: "Automate and integrate", es: "Automatiza e integra" },
+    descriptions: { pt: "Use CLI, MCP e políticas de acesso", en: "Use the CLI, MCP and access policies", es: "Usa la CLI, MCP y políticas de acceso" },
+  },
+  35: {
+    titles: { pt: "Operação e desenvolvimento", en: "Operations and development", es: "Operación y desarrollo" },
+    descriptions: { pt: "Publique, mantenha e desenvolva a documentação", en: "Publish, maintain and develop the documentation", es: "Pública, mantén y desarrolla la documentación" },
+  },
+  36: {
+    titles: { pt: "Publique e mantenha", en: "Ship and maintain", es: "Pública y mantén" },
+    descriptions: { pt: "Prepare a publicação e preserve compatibilidade", en: "Prepare releases and preserve compatibility", es: "Prepara publicaciones y conserva compatibilidad" },
+  },
+  37: {
+    titles: { pt: "Desenvolva o projeto", en: "Develop the project", es: "Desarrolla el proyecto" },
+    descriptions: { pt: "Localize fontes, contratos e verificações", en: "Locate sources, contracts and checks", es: "Localiza fuentes, contratos y comprobaciones" },
+  },
+  38: {
+    titles: { pt: "Git e GitHub", en: "Git and GitHub", es: "Git y GitHub" },
+    descriptions: { pt: "Versione mudanças e organize o trabalho", en: "Version changes and organize the work", es: "Versiona cambios y organiza el trabajo" },
+  },
 };
 
 export const HTML_DOOM_META = {
   id: 29,
   titles: { pt: "DOOM: exemplo HTML", en: "DOOM: HTML example", es: "DOOM: ejemplo HTML" },
   descriptions: {
-    pt: "Um container HTML com título, descrição e um jogo carregado apenas ao clicar.",
-    en: "An HTML container with a title, description and a game loaded only after clicking.",
-    es: "Un contenedor HTML con título, descripción y un juego que se carga solo al hacer clic.",
+    pt: "Jogue DOOM em um container HTML usando os controles do próprio player.",
+    en: "Play DOOM in an HTML container using the player’s native controls.",
+    es: "Juega a DOOM en un contenedor HTML con los controles del reproductor.",
   },
 };
 
 export const SOURCE_VIEWER_META = {
   id: 7,
-  titles: { pt: "Codigo fonte", en: "Source code", es: "Codigo fuente" },
+  titles: { pt: "Código fonte", en: "Source code", es: "Código fuente" },
   descriptions: {
-    pt: "Explore a arvore do repositorio, navegue por pastas e visualize arquivos diretamente na documentacao.",
+    pt: "Explore a árvore do repositório, navegue por pastas e visualize arquivos diretamente na documentação.",
     en: "Explore the repository tree, browse folders, and preview files directly inside the documentation.",
-    es: "Explora el arbol del repositorio, navega por carpetas y previsualiza archivos directamente en la documentacion.",
+    es: "Explora el árbol del repositorio, navega por carpetas y previsualiza archivos directamente en la documentación.",
   },
 };
 
 export const AUDIO_META_ID12 = {
   id: 12,
-  title: { pt: "Trilha de audio", en: "Audio track", es: "Pista de audio" },
+  title: { pt: "Trilha de áudio", en: "Audio track", es: "Pista de audio" },
   description: {
-    pt: "Ouça uma faixa de exemplo diretamente na documentacao.",
+    pt: "Ouça uma faixa de exemplo diretamente na documentação.",
     en: "Listen to a sample track directly inside the documentation.",
-    es: "Escucha una pista de ejemplo directamente en la documentacion.",
+    es: "Escucha una pista de ejemplo directamente en la documentación.",
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitpagedocs/cli",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "CLI that scaffolds and maintains gitpagedocs documentation, generates docs with AI, configures GitHub Pages, and runs the MCP server.",
   "bin": {
     "gitpagedocs": "index.mjs"
@@ -29,8 +29,8 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.5.1",
-    "@gitpagedocs/mcp": "^0.0.10",
-    "@gitpagedocs/tools": "^0.0.10",
+    "@gitpagedocs/mcp": "^0.0.11",
+    "@gitpagedocs/tools": "^0.0.11",
     "tsx": "^4.21.0"
   },
   "repository": {

package/runtime/doc-path-resolver.mjs

@@ -1,6 +1,9 @@
 /** Map doc paths to content keys and apply version badges */
 
+import { PACKAGE_VERSION } from "../contracts/doc-versions.mjs";
+
 const DOC_FILE_KEYS = new Map([
+  ["content-blocks.md", "contentBlocks"],
   ["index.md", "index"],
   ["getting-started.md", "gettingStarted"],
   ["configuration.md", "configuration"],
@@ -24,6 +27,14 @@ const DOC_FILE_KEYS = new Map([
   ["troubleshooting.md", "troubleshooting"],
   ["contributing.md", "contributing"],
   ["html-containers.md", "htmlContainers"],
+  ["guides.md", "guides"],
+  ["configure-your-site.md", "configureYourSite"],
+  ["read-and-explore.md", "readAndExplore"],
+  ["automate-and-integrate.md", "automateAndIntegrate"],
+  ["operations-and-development.md", "operationsAndDevelopment"],
+  ["ship-and-maintain.md", "shipAndMaintain"],
+  ["develop-the-project.md", "developTheProject"],
+  ["git-and-github.md", "gitAndGitHub"],
 ]);
 
 export function parseDocFileToKey(fileName) {
@@ -43,13 +54,17 @@ export function extractLanguageFromPath(docPath) {
 }
 
 export function withVersionBadge(content, versionId, language) {
-  const normalized = typeof content === "string" ? content : "";
+  const normalized = typeof content === "string"
+    ? content.replaceAll(`/versions/${PACKAGE_VERSION}/`, `/versions/${versionId}/`)
+    : "";
   if (!normalized.trim()) {
     return normalized;
   }
 
   const alreadyTagged =
     normalized.includes(`Version: ${versionId}`) ||
+    normalized.includes(`Versão: ${versionId}`) ||
+    normalized.includes(`Versión: ${versionId}`) ||
     normalized.includes(`Versao: ${versionId}`) ||
     normalized.includes(`Version (ES): ${versionId}`);
   if (alreadyTagged) {
@@ -62,7 +77,7 @@ export function withVersionBadge(content, versionId, language) {
 }
 
 /** Badge wording per language; every other language reads the English form. */
-const VERSION_LABEL_PREFIXES = { pt: "Versao", es: "Version (ES)" };
+const VERSION_LABEL_PREFIXES = { pt: "Versão", es: "Versión" };
 
 function versionLabelPrefix(language) {
   return VERSION_LABEL_PREFIXES[language] ?? "Version";