@docsector/docsector-reader 3.2.0 → 3.2.1

package/src/pages/manual/content/blocks/ordered-lists.showcase.pt-BR.md

@@ -0,0 +1,21 @@
+## Demonstração
+
+### Etapas Sequenciais
+
+1. Crie a entrada da página no registry.
+2. Escreva o markdown de overview localizado.
+3. Adicione uma página de showcase com exemplos reais.
+4. Rode os testes e o build.
+
+### Sequência Aninhada
+
+1. Prepare a mudança.
+   1. Confirme o caminho da rota.
+   2. Verifique os arquivos Markdown necessários.
+2. Valide o resultado.
+   1. Rode os testes focados.
+   2. Gere o build do site.
+
+### Quando Listas Ordenadas Funcionam Melhor
+
+Use listas numeradas quando o leitor precisa seguir um procedimento, checklist ou fluxo em uma ordem específica.

package/src/pages/manual/content/blocks/paragraphs.overview.en-US.md

@@ -0,0 +1,19 @@
+## Overview
+
+Paragraphs are the default block for narrative text.
+
+Use them for explanations, transitions between sections, introductions before lists or code, and any copy that should read as a continuous flow.
+
+## Markdown Syntax
+
+```markdown
+This is the first paragraph with **bold text**, _emphasis_, a [link](/guide/getting-started/overview/), and `inline code`.
+
+This is a second paragraph separated by a blank line.
+```
+
+## Notes
+
+- Start a new paragraph with a blank line.
+- Inline formatting such as emphasis, links, code, and math works inside normal paragraphs.
+- Keep each paragraph focused on one idea when the page is long.

package/src/pages/manual/content/blocks/paragraphs.overview.pt-BR.md

@@ -0,0 +1,19 @@
+## Visão Geral
+
+Parágrafos são o bloco padrão para texto corrido.
+
+Use-os para explicações, transições entre seções, introduções antes de listas ou código e qualquer conteúdo que deva ser lido como um fluxo contínuo.
+
+## Sintaxe em Markdown
+
+```markdown
+Este é o primeiro parágrafo com **negrito**, _ênfase_, um [link](/guide/getting-started/overview/) e `código inline`.
+
+Este é um segundo parágrafo separado por uma linha em branco.
+```
+
+## Observações
+
+- Comece um novo parágrafo com uma linha em branco.
+- Formatações inline como ênfase, links, código e matemática funcionam dentro de parágrafos normais.
+- Em páginas longas, mantenha cada parágrafo focado em uma única ideia.

package/src/pages/manual/content/blocks/paragraphs.showcase.en-US.md

@@ -0,0 +1,9 @@
+## Showcase
+
+Paragraphs are where most of the narrative work happens in a documentation page. They carry explanations, transitions, and the details that connect examples to decisions.
+
+This second paragraph is separated by a blank line, which is all Markdown needs to start a new block. Inline formatting such as **bold text**, _emphasis_, [links](/guide/getting-started/overview/), and `inline code` all remain available inside the paragraph flow.
+
+### Reading Rhythm
+
+Short paragraphs keep scanning easy. Longer paragraphs work well when you need to explain tradeoffs, migration notes, or the reasoning behind a recommendation.

package/src/pages/manual/content/blocks/paragraphs.showcase.pt-BR.md

@@ -0,0 +1,9 @@
+## Demonstração
+
+Parágrafos são onde a maior parte do trabalho narrativo acontece em uma página de documentação. Eles carregam explicações, transições e os detalhes que conectam exemplos a decisões.
+
+Este segundo parágrafo é separado por uma linha em branco, que é tudo o que o Markdown precisa para iniciar um novo bloco. Formatações inline como **negrito**, _ênfase_, [links](/guide/getting-started/overview/) e `inline code` continuam disponíveis dentro do fluxo do parágrafo.
+
+### Ritmo de Leitura
+
+Parágrafos curtos facilitam a varredura visual. Parágrafos mais longos funcionam bem quando você precisa explicar tradeoffs, notas de migração ou o motivo por trás de uma recomendação.

package/src/pages/manual/content/blocks/quick-links.overview.en-US.md

@@ -0,0 +1,28 @@
+## Overview
+
+Quick Links render a card-like list of internal or external destinations directly inside Markdown.
+
+They are useful for homepages, landing sections, and any page that should offer clear next steps without writing a long list of prose links.
+
+## Markdown Syntax
+
+```html
+<d-quick-links title="Get started">
+  <d-quick-link
+    title="Install"
+    description="Set up the project"
+    to="/guide/getting-started"
+  />
+  <d-quick-link
+    title="GitHub"
+    description="Open the repository"
+    href="https://github.com/docsector/docsector-reader"
+  />
+</d-quick-links>
+```
+
+## Notes
+
+- Use `to` for internal navigation and `href` for external URLs.
+- Add short descriptions so the cards explain why the destination matters.
+- Use a small set of links per group to keep scanning easy.

package/src/pages/manual/content/blocks/quick-links.overview.pt-BR.md

@@ -0,0 +1,28 @@
+## Visão Geral
+
+Quick Links renderizam uma lista de destinos internos ou externos em formato de cards diretamente no Markdown.
+
+Eles são úteis para homepages, seções de entrada e qualquer página que precise oferecer próximos passos claros sem depender de uma longa lista de links em prosa.
+
+## Sintaxe em Markdown
+
+```html
+<d-quick-links title="Comece aqui">
+  <d-quick-link
+    title="Instalação"
+    description="Configure o projeto"
+    to="/guide/getting-started"
+  />
+  <d-quick-link
+    title="GitHub"
+    description="Abra o repositório"
+    href="https://github.com/docsector/docsector-reader"
+  />
+</d-quick-links>
+```
+
+## Observações
+
+- Use `to` para navegação interna e `href` para URLs externas.
+- Adicione descrições curtas para que os cards expliquem por que o destino importa.
+- Use poucos links por grupo para manter a leitura fácil.

package/src/pages/manual/content/blocks/quick-links.showcase.en-US.md

@@ -0,0 +1,34 @@
+## Showcase
+
+<d-quick-links title="Continue reading">
+  <d-quick-link
+    title="Getting Started"
+    description="Install and run the project"
+    to="/guide/getting-started"
+  />
+  <d-quick-link
+    title="Headings"
+    description="Open a block example with showcase"
+    to="/manual/content/blocks/headings"
+  />
+  <d-quick-link
+    title="GitHub"
+    description="Open the repository"
+    href="https://github.com/docsector/docsector-reader"
+  />
+</d-quick-links>
+
+## Smaller Group
+
+<d-quick-links title="Next actions">
+  <d-quick-link
+    title="Page structure"
+    description="Read the page container overview"
+    to="/manual/content/structures/page"
+  />
+  <d-quick-link
+    title="Quick Links overview"
+    description="Return to the reference page"
+    to="/manual/content/blocks/quick-links"
+  />
+</d-quick-links>

package/src/pages/manual/content/blocks/quick-links.showcase.pt-BR.md

@@ -0,0 +1,34 @@
+## Demonstração
+
+<d-quick-links title="Continue lendo">
+  <d-quick-link
+    title="Começando"
+    description="Instale e rode o projeto"
+    to="/guide/getting-started"
+  />
+  <d-quick-link
+    title="Títulos"
+    description="Abra um exemplo de bloco com showcase"
+    to="/manual/content/blocks/headings"
+  />
+  <d-quick-link
+    title="GitHub"
+    description="Abra o repositório"
+    href="https://github.com/docsector/docsector-reader"
+  />
+</d-quick-links>
+
+## Grupo Menor
+
+<d-quick-links title="Próximas ações">
+  <d-quick-link
+    title="Estrutura de página"
+    description="Leia o overview do container de page"
+    to="/manual/content/structures/page"
+  />
+  <d-quick-link
+    title="Overview de Quick Links"
+    description="Volte para a página de referência"
+    to="/manual/content/blocks/quick-links"
+  />
+</d-quick-links>

package/src/pages/manual/content/blocks/quotes.overview.en-US.md

@@ -0,0 +1,24 @@
+## Overview
+
+Quotes render regular blockquotes without alert styling.
+
+Use them for cited text, quoted excerpts, or offset notes that should stand apart from the main paragraph flow without looking like a warning or a callout.
+
+For alert-style blocks such as Note, Tip, Important, Warning, and Caution, see [Hints](/manual/content/blocks/hints/overview/).
+
+## Markdown Syntax
+
+```markdown
+> This is a regular quote.
+```
+
+## Good Uses
+
+- Quoted speech or copied excerpts
+- Short citations from guides, specs, or changelogs
+- Side notes that need visual separation but not semantic severity
+
+## Notes
+
+- If there is no `[!TYPE]` marker, Docsector keeps the blockquote neutral.
+- Regular quotes can still contain inline emphasis, links, inline code, and math.

package/src/pages/manual/content/blocks/quotes.overview.pt-BR.md

@@ -0,0 +1,24 @@
+## Visão Geral
+
+Citações renderizam blockquotes comuns, sem estilo de alerta.
+
+Use esse bloco para trechos citados, excertos destacados ou notas laterais que precisam se separar visualmente do texto principal sem parecer um aviso ou callout semântico.
+
+Para blocos de alerta como Note, Tip, Important, Warning e Caution, veja [Hints](/manual/content/blocks/hints/overview/).
+
+## Sintaxe em Markdown
+
+```markdown
+> Esta é uma citação comum.
+```
+
+## Bons Usos
+
+- Fala citada ou trechos copiados
+- Pequenas citações de guias, specs ou changelogs
+- Notas laterais que pedem destaque visual, mas não severidade semântica
+
+## Observações
+
+- Se não houver marcador `[!TYPE]`, o Docsector mantém o blockquote em modo neutro.
+- Citações comuns ainda podem conter ênfase inline, links, código inline e matemática.

package/src/pages/manual/content/blocks/quotes.showcase.en-US.md

@@ -0,0 +1,17 @@
+## Showcase
+
+### Single Paragraph Quote
+
+> Documentation becomes easier to maintain when examples stay close to the behavior they describe.
+
+### Multi-Paragraph Quote
+
+> A regular quote can span more than one paragraph.
+>
+> Blank lines are preserved inside the blockquote, so the reader can still distinguish separate ideas.
+
+### Rich Quote Content
+
+> Quotes still support **bold text**, [links](https://github.com/docsector/docsector-reader), and `inline code`.
+>
+> They work well for cited text, pull quotes, or neutral callouts that should not use alert styling.

package/src/pages/manual/content/blocks/quotes.showcase.pt-BR.md

@@ -0,0 +1,17 @@
+## Demonstração
+
+### Citação com Um Parágrafo
+
+> A documentação fica mais fácil de manter quando os exemplos ficam próximos do comportamento que descrevem.
+
+### Citação com Múltiplos Parágrafos
+
+> Uma citação comum pode se estender por mais de um parágrafo.
+>
+> Linhas em branco são preservadas dentro do blockquote, então o leitor ainda consegue distinguir ideias separadas.
+
+### Conteúdo Rico na Citação
+
+> Citações continuam suportando **negrito**, [links](https://github.com/docsector/docsector-reader) e `inline code`.
+>
+> Elas funcionam bem para texto citado, pull quotes ou callouts neutros que não devem usar estilo de alerta.

package/src/pages/manual/content/blocks/raw-html.overview.en-US.md

@@ -0,0 +1,19 @@
+## Overview
+
+Raw HTML can be used inside Markdown when the native Markdown syntax is not expressive enough.
+
+This is useful for custom wrappers, inline labels, embedded elements, and Docsector-specific custom elements such as expandable blocks and quick links.
+
+## Markdown Example
+
+```html
+<div data-kind="secondary-note">
+  This block uses raw HTML inside the page source.
+</div>
+```
+
+## Notes
+
+- Prefer plain Markdown first when it already solves the problem.
+- Use raw HTML when you need structure or attributes that Markdown does not provide.
+- Keep the markup readable, because documentation content still needs to be maintained by humans.

package/src/pages/manual/content/blocks/raw-html.overview.pt-BR.md

@@ -0,0 +1,19 @@
+## Visão Geral
+
+HTML bruto pode ser usado dentro do Markdown quando a sintaxe nativa de Markdown não é expressiva o suficiente.
+
+Isso é útil para wrappers customizados, labels inline, elementos embutidos e custom elements do Docsector, como blocos expansíveis e quick links.
+
+## Exemplo em Markdown
+
+```html
+<div data-kind="secondary-note">
+  Este bloco usa HTML bruto dentro do conteúdo da página.
+</div>
+```
+
+## Observações
+
+- Prefira Markdown puro primeiro quando ele já resolver o problema.
+- Use HTML bruto quando precisar de estrutura ou atributos que o Markdown não oferece.
+- Mantenha a marcação legível, porque o conteúdo da documentação ainda precisa ser mantido por pessoas.

package/src/pages/manual/content/blocks/raw-html.showcase.en-US.md

@@ -0,0 +1,12 @@
+## Showcase
+
+### Custom Wrapper
+
+<div style="padding: 1rem; border: 1px solid currentColor; border-radius: 12px; margin-bottom: 1rem;">
+  <strong>Custom note</strong><br />
+  This example uses raw HTML when plain Markdown is not expressive enough.
+</div>
+
+### Inline Badge
+
+Use <span style="padding: 0.15rem 0.45rem; border: 1px solid currentColor; border-radius: 999px;">beta</span> labels directly inside a sentence.

package/src/pages/manual/content/blocks/raw-html.showcase.pt-BR.md

@@ -0,0 +1,12 @@
+## Demonstração
+
+### Wrapper Customizado
+
+<div style="padding: 1rem; border: 1px solid currentColor; border-radius: 12px; margin-bottom: 1rem;">
+  <strong>Nota customizada</strong><br />
+  Este exemplo usa HTML bruto quando o Markdown puro não é expressivo o suficiente.
+</div>
+
+### Badge Inline
+
+Use selos <span style="padding: 0.15rem 0.45rem; border: 1px solid currentColor; border-radius: 999px;">beta</span> diretamente dentro de uma frase.

package/src/pages/manual/content/blocks/tables.overview.en-US.md

@@ -0,0 +1,19 @@
+## Overview
+
+Tables are useful for comparisons, option matrices, compatibility notes, and any content that benefits from a row-and-column layout.
+
+## Markdown Syntax
+
+```markdown
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Search | Done | Available in the sidebar |
+| Math | Done | Rendered with KaTeX |
+| Mermaid | Done | Theme-aware diagrams |
+```
+
+## Notes
+
+- Keep column labels short and clear.
+- Use tables when scanning is more important than narrative flow.
+- If the content becomes too dense, split it into multiple smaller tables.

package/src/pages/manual/content/blocks/tables.overview.pt-BR.md

@@ -0,0 +1,19 @@
+## Visão Geral
+
+Tabelas são úteis para comparações, matrizes de opções, notas de compatibilidade e qualquer conteúdo que se beneficie de um layout em linhas e colunas.
+
+## Sintaxe em Markdown
+
+```markdown
+| Recurso | Status | Observações |
+|---------|--------|-------------|
+| Busca | Done | Disponível na sidebar |
+| Math | Done | Renderizado com KaTeX |
+| Mermaid | Done | Diagramas adaptados ao tema |
+```
+
+## Observações
+
+- Mantenha os rótulos das colunas curtos e claros.
+- Use tabelas quando a leitura em modo de varredura for mais importante que o fluxo narrativo.
+- Se o conteúdo ficar denso demais, quebre em várias tabelas menores.

package/src/pages/manual/content/blocks/tables.showcase.en-US.md

@@ -0,0 +1,17 @@
+## Showcase
+
+### Feature Matrix
+
+| Block | Showcase | Best for |
+|-------|----------|----------|
+| Paragraphs | Yes | Narrative explanations |
+| Code blocks | Yes | Technical examples |
+| Quick Links | Yes | Guided navigation |
+
+### Alignment Example
+
+| Left | Center | Right |
+|:-----|:------:|------:|
+| Label | Status | 3 |
+| Blocks | Ready | 14 |
+| Structures | Focused | 3 |

package/src/pages/manual/content/blocks/tables.showcase.pt-BR.md

@@ -0,0 +1,17 @@
+## Demonstração
+
+### Matriz de Recursos
+
+| Bloco | Showcase | Melhor uso |
+|-------|----------|-------------|
+| Parágrafos | Sim | Explicações narrativas |
+| Blocos de código | Sim | Exemplos técnicos |
+| Quick Links | Sim | Navegação guiada |
+
+### Exemplo de Alinhamento
+
+| Esquerda | Centro | Direita |
+|:---------|:------:|--------:|
+| Rótulo | Status | 3 |
+| Blocos | Pronto | 14 |
+| Estruturas | Focado | 3 |

package/src/pages/manual/content/blocks/unordered-lists.overview.en-US.md

@@ -0,0 +1,21 @@
+## Overview
+
+Use unordered lists when the order of the items does not matter.
+
+They work well for feature sets, requirements, grouped notes, and short collections of related points.
+
+## Markdown Syntax
+
+```markdown
+- First item
+- Second item
+  - Nested item
+  - Another nested item
+- Third item
+```
+
+## Notes
+
+- `-`, `*`, and `+` are all valid bullet markers.
+- Indent nested items to create sublists.
+- Use unordered lists for collections, not for step-by-step procedures.

package/src/pages/manual/content/blocks/unordered-lists.overview.pt-BR.md

@@ -0,0 +1,21 @@
+## Visão Geral
+
+Use listas não ordenadas quando a sequência dos itens não importa.
+
+Elas funcionam bem para conjuntos de recursos, requisitos, notas agrupadas e coleções curtas de pontos relacionados.
+
+## Sintaxe em Markdown
+
+```markdown
+- Primeiro item
+- Segundo item
+  - Item aninhado
+  - Outro item aninhado
+- Terceiro item
+```
+
+## Observações
+
+- `-`, `*` e `+` são marcadores válidos.
+- Indente itens aninhados para criar sublistas.
+- Use listas não ordenadas para coleções, não para procedimentos passo a passo.

package/src/pages/manual/content/blocks/unordered-lists.showcase.en-US.md

@@ -0,0 +1,24 @@
+## Showcase
+
+### Simple Bullets
+
+- Install dependencies
+- Start the development server
+- Open the project in the browser
+
+### Nested Bullets
+
+- Documentation workflow
+  - Write the overview page
+  - Add the showcase page
+  - Review links and wording
+- Release workflow
+  - Run tests
+  - Build the site
+  - Publish the update
+
+### Mixed Content
+
+- **Important:** keep each item focused on one action.
+- `npm run build` works well as a literal command inside a list.
+- Lists are useful when order does not matter as much as scanability.

package/src/pages/manual/content/blocks/unordered-lists.showcase.pt-BR.md

@@ -0,0 +1,24 @@
+## Demonstração
+
+### Marcadores Simples
+
+- Instale as dependências
+- Inicie o servidor de desenvolvimento
+- Abra o projeto no navegador
+
+### Marcadores Aninhados
+
+- Fluxo de documentação
+  - Escreva a página de overview
+  - Adicione a página de showcase
+  - Revise links e texto
+- Fluxo de release
+  - Rode os testes
+  - Gere o build do site
+  - Publique a atualização
+
+### Conteúdo Misto
+
+- **Importante:** mantenha cada item focado em uma ação.
+- `npm run build` funciona bem como comando literal dentro de uma lista.
+- Listas são úteis quando a ordem importa menos do que a facilidade de leitura.

package/src/pages/manual/content/structures/books.overview.en-US.md

@@ -0,0 +1,36 @@
+## Overview
+
+Books define the top-level documentation sections that appear as primary tabs, such as Manual and Guide.
+
+A book is configured in a `*.book.js` file. It is not a Vue component and it does not render page content by itself.
+
+## Example
+
+```javascript
+import { defineBook } from '../index.js'
+
+export default defineBook({
+  id: 'manual',
+  label: 'Manual',
+  icon: 'menu_book',
+  order: 1,
+  color: {
+    active: 'white',
+    inactive: 'white'
+  }
+})
+```
+
+## What a Book Controls
+
+- The tab label shown in the main navigation
+- The icon used for that tab
+- The order of the top-level sections
+- Active and inactive tab colors
+- The stable id referenced by page registries
+
+## Notes
+
+- Use one `*.book.js` file per top-level section.
+- Page registries such as `manual.index.js` and `guide.index.js` attach entries to a book with the `book` field.
+- A book groups pages under a common tab and route prefix.

package/src/pages/manual/content/structures/books.overview.pt-BR.md

@@ -0,0 +1,36 @@
+## Visão Geral
+
+Books definem as seções principais da documentação exibidas como abas de primeiro nível, como Manual e Guide.
+
+Um book é configurado em um arquivo `*.book.js`. Ele não é um componente Vue e não renderiza conteúdo de página por conta própria.
+
+## Exemplo
+
+```javascript
+import { defineBook } from '../index.js'
+
+export default defineBook({
+  id: 'manual',
+  label: 'Manual',
+  icon: 'menu_book',
+  order: 1,
+  color: {
+    active: 'white',
+    inactive: 'white'
+  }
+})
+```
+
+## O Que um Book Controla
+
+- O rótulo da aba exibida na navegação principal
+- O ícone usado nessa aba
+- A ordem das seções de primeiro nível
+- As cores ativa e inativa da aba
+- O id estável referenciado pelos registries de páginas
+
+## Observações
+
+- Use um arquivo `*.book.js` para cada seção de primeiro nível.
+- Registries como `manual.index.js` e `guide.index.js` associam entradas a um book com o campo `book`.
+- Um book agrupa páginas sob a mesma aba e o mesmo prefixo de rota.