czon 0.1.1 → 0.1.2

package/.zen/src/pt-BR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -1,70 +0,0 @@
----
-'title': 'ZEN - Construtor de Site Estático Minimalista Markdown + IA'
-'summary': 'ZEN é um gerador de sites estáticos com integração de IA, focado em simplificar a escrita e construção de documentação. Permite que usuários criem sites HTML estáticos a partir de pastas gerenciadas por git usando Markdown, sem configuração complexa - todas as configurações ficam ocultas no diretório .zen. Funcionalidades principais incluem navegação inteligente por categorias (geração de mapa do site via análise de conteúdo por IA), tradução incremental automática (suporte a versões multilíngues, permitindo escrita no idioma nativo com tradução processada por IA) e experiência de escrita com distrações minimizadas. A ferramenta depende de Node.js, chave da API OpenAI e Git, com construção rápida via linha de comando, suportando parâmetros de idioma como zh-Hans e en-US.'
-'tags':
-  - 'Gerador de Sites Estáticos'
-  - 'Markdown'
-  - 'IA'
-  - 'Tradução Multilíngue'
-  - 'Minimalismo'
-  - 'Ferramenta de Documentação'
-  - 'ZEN'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - Construtor de Site Estático Minimalista Markdown + IA
-
-[> Demonstração do Site](https://zen.zccz14.com/)
-
-## Funcionalidades Básicas
-
-1. 📃 **Geração de Site Estático**: Transforma qualquer pasta git contendo Markdown em um site HTML estático.
-2. 🧭 **Navegação Inteligente por Categorias**: Usa IA para análise de conteúdo, gerando mapa do site e navegação independente da localização dos arquivos fonte.
-3. 🌍 **Tradução Incremental Automática**: Utiliza IA para tradução incremental, permitindo que usuários escrevam Markdown em seu idioma nativo, mas com suporte multilíngue.
-
-Por que criar mais um gerador de sites estáticos com Markdown? Reflito sobre como ferramentas de documentação podem servir melhor aos escritores na era da IA:
-
-- Retorno ao conteúdo: Distrações minimizadas, foco na escrita
-
-  Devolver a documentação à sua essência, devolver a tranquilidade à escrita.
-
-  Primeiro, não quero ser um bibliotecário. Às vezes quero anotar algum conteúdo, mas talvez ainda não tenha pensado em um título, nem organizado adequadamente. Desejo que o LLM gere automaticamente títulos, resumos, categorias, navegação e outras tarefas de organização.
-
-  Segundo, meu escritório precisa estar arrumado. Não quero ferramentas de construção com configuração complexa, nem me preocupar com estruturas complicadas. Sempre que vejo os arquivos de configuração e estruturas de projetos de ferramentas como Docusaurus, VuePress, Astro, fico com dor de cabeça. Agora, o ZEN opta por esconder todas as configurações no diretório .zen, varrendo-as para um canto, para que o usuário foque apenas no conteúdo da escrita, deixando o resto para o ZEN cuidar. Os outros diretórios são seu espaço de escrita, você pode organizar seus arquivos Markdown livremente.
-
-- Retorno ao idioma nativo: Escreva em sua língua materna, construa versões multilíngues suavemente
-
-  A vida é curta, não tenho paciência para traduzir. As pessoas atingem sua máxima profundidade de pensamento quando usam seu idioma nativo. Mas manter conexão com o mundo também é necessário, não quero abrir mão da comunicação multilíngue. Por isso, desejo uma ferramenta que me permita escrever em meu idioma nativo, enquanto permite que mais pessoas vejam meu conteúdo. Atualmente, o i18n exige que você mesmo faça a tradução e mantenha as atualizações de conteúdo, o que é muito trabalhoso. Escolhi usar LLM para fazer a tradução por mim, economizando muito tempo e permitindo a tradução para múltiplos idiomas com um clique.
-
-## Início Rápido
-
-Pré-requisitos:
-
-- [Node.js](https://nodejs.org/) instalado (versão 18 ou superior recomendada, necessário comando npx)
-- Chave da [API OpenAI](https://platform.openai.com/account/api-keys) obtida, ou chave de API compatível com OpenAI
-- Git instalado (para listar arquivos Markdown do Git, ignorando arquivos filtrados pelas regras .gitignore)
-
-Primeiro, trabalhe em uma pasta já gerenciada pelo git:
-
-Configure as variáveis de ambiente
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: substitua pela sua chave da API OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, usa a API oficial da OpenAI por padrão
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, usa o modelo gpt-3.5-turbo por padrão
-```
-
-Construa o site, com suporte a tradução multilíngue. Usa o diretório atual como fonte, saída no diretório `.zen/dist`.
-
-- É possível especificar versões de idioma usando múltiplas vezes o parâmetro `--lang` (exemplo: `--lang zh-Hans --lang en-US`).
-- Não é necessário configurar o idioma fonte, o ZEN detecta automaticamente.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**Veja mais parâmetros ou ajuda**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/pt-BR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - Construtor de Site Estático Minimalista com Markdown + IA'
-'summary': 'ZEN é um gerador de sites estáticos com funcionalidades de IA, projetado para simplificar a escrita de documentação e o processo de construção de sites. Permite que os usuários se concentrem em escrever conteúdo em Markdown em sua língua materna, processando automaticamente a geração de títulos, navegação por categorias e tradução incremental, com suporte a versões multilíngues, sem configurações complexas. A ferramenta é baseada em Node.js e na API da OpenAI, construindo sites rapidamente via linha de comando, ideal para escritores que buscam eficiência e simplicidade.'
-'tags':
-  - 'Gerador de Site Estático'
-  - 'Markdown'
-  - 'IA'
-  - 'Minimalismo'
-  - 'Tradução Multilíngue'
-  - 'Node.js'
-  - 'OpenAI'
-'inferred_lang': 'pt-BR'
----
-
-# ZEN - Construtor de Site Estático Minimalista com Markdown + IA
-
-[> Demonstração do Site](https://zccz14.github.io/ZEN/)
-
-## Funcionalidades Básicas
-
-1. 📃 **Geração de Site Estático**: Transforma qualquer pasta git contendo Markdown em um site HTML estático.
-2. 🧭 **Navegação Inteligente por Categorias**: Usa IA para analisar o conteúdo, gerando mapa do site e navegação, independente da localização dos arquivos fonte.
-3. 🌍 **Tradução Incremental Automática**: Usa IA para tradução incremental, permitindo que o usuário escreva em Markdown em sua língua materna, mas com suporte multilíngue.
-
-Por que criar mais um gerador de site estático com Markdown? Reflito sobre como as ferramentas de documentação podem servir melhor os escritores na era da IA:
-
-- Retorno ao conteúdo: Minimizar distrações, focar na escrita
-
-  Devolver a essência à documentação e a tranquilidade à escrita.
-
-  Primeiro, não quero ser um bibliotecário. Às vezes quero anotar algo, mas talvez ainda não tenha pensado no título ou na organização. Quero que um LLM gere automaticamente títulos, resumos, categorias, navegação e outras tarefas de organização.
-
-  Segundo, meu espaço de trabalho deve estar limpo. Não quero ferramentas de construção com configurações complexas, nem estruturas complicadas. Sempre que vejo os arquivos de configuração e a estrutura de projetos de ferramentas como Docusaurus, VuePress ou Astro, fico com dor de cabeça. Agora, o ZEN esconde todas as configurações no diretório `.zen`, deixando o usuário focado apenas no conteúdo da escrita. Os outros diretórios são seu espaço de escrita, onde você pode organizar seus arquivos Markdown livremente.
-
-- Retorno à língua materna: Escrever na língua materna, construindo versões multilíngues de forma fluida
-
-  A vida é curta, não tenho paciência para traduzir. É na língua materna que conseguimos expressar nossa profundidade de pensamento. Mas manter conexão com o mundo também é necessário, e não quero abrir mão da comunicação multilíngue. Por isso, desejo uma ferramenta que me permita escrever na minha língua materna e, ao mesmo tempo, tornar meu conteúdo acessível a mais pessoas. Atualmente, o i18n exige que você mesmo traduza e mantenha as atualizações, o que é muito trabalhoso. Escolhi usar LLM para fazer a tradução, economizando tempo e permitindo a tradução para vários idiomas com um clique.
-
-## Começo Rápido
-
-Pré-requisitos:
-
-- [Node.js](https://nodejs.org/) instalado (versão 18 ou superior recomendada, com comando `npx` disponível)
-- Chave da [API da OpenAI](https://platform.openai.com/account/api-keys) obtida, ou chave de API compatível com OpenAI
-- Git instalado (para listar arquivos Markdown de um repositório git, ignorando arquivos filtrados por regras `.gitignore`)
-
-Primeiro, trabalhe em uma pasta já gerenciada pelo git:
-
-Configure as variáveis de ambiente:
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: substitua pela sua chave da API da OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, usa a API oficial da OpenAI por padrão
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, usa o modelo gpt-3.5-turbo por padrão
-```
-
-Construa o site, com suporte a tradução multilíngue. Use o diretório atual como fonte e saída no diretório `.zen/dist`.
-
-- É possível especificar os idiomas de saída usando o parâmetro `--lang` várias vezes (ex.: `--lang pt-BR --lang en-US`).
-- Use o parâmetro `--base-url` para definir o prefixo da URL base do site (ex.: nome do repositório no GitHub Pages).
-- Não é necessário configurar o idioma fonte; o ZEN detecta automaticamente.
-
-```bash
-npx zengen@latest build --lang pt-BR --lang en-US
-```
-
-**Veja mais parâmetros ou ajuda**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/pt-BR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - Construtor de Site Estático Minimalista com Markdown + IA'
-'summary': 'ZEN é um gerador de sites estáticos com funcionalidades de IA, projetado especificamente para documentos Markdown. Ele permite que os usuários convertam uma pasta Git contendo arquivos Markdown em um site HTML estático, sem configurações complexas — todas as configurações ficam ocultas no diretório .zen. As funcionalidades principais incluem navegação por categorização inteligente (usando IA para analisar o conteúdo e gerar um mapa do site), tradução incremental automática (suporte a versões multilíngues, permitindo que os usuários escrevam em sua língua nativa enquanto a IA cuida da tradução) e uma experiência de escrita com distrações mínimas. O guia de início rápido requer a instalação do Node.js, obtenção de uma chave de API da OpenAI e Git, construção do site via linha de comando, com suporte para especificação de idioma e URL base.'
-'tags':
-  - 'Gerador de Site Estático'
-  - 'Markdown'
-  - 'IA'
-  - 'Tradução Multilíngue'
-  - 'Minimalismo'
-  - 'Ferramenta de Documentação'
-  - 'Git'
-'inferred_lang': 'pt-BR'
----
-
-# ZEN - Construtor de Site Estático Minimalista com Markdown + IA
-
-[> Demonstração do Site](https://zen.zccz14.com/)
-
-## Funcionalidades Básicas
-
-1.  📃 **Geração de Site Estático**: Transforma qualquer pasta git contendo Markdown em um site HTML estático.
-2.  🧭 **Navegação por Categorização Inteligente**: Usa IA para analisar o conteúdo, gerando um mapa do site e navegação, independente da localização dos arquivos fonte.
-3.  🌍 **Tradução Incremental Automática**: Usa IA para realizar traduções incrementais, permitindo que o usuário escreva Markdown em sua língua nativa, mas o conteúdo final pode ser multilíngue.
-
-Por que criar mais um gerador de site estático para Markdown? Reflito sobre como as ferramentas de documentação podem servir melhor aos escritores na era da IA:
-
-- **Retorno ao Conteúdo: Distrações Mínimas, Foco na Escrita**
-
-  Traga a documentação de volta à sua essência e a escrita de volta à tranquilidade.
-
-  Primeiro, não quero ser um bibliotecário. Às vezes quero anotar algo, mas talvez ainda não tenha pensado em um título ou organizado as ideias. Quero que um LLM (Large Language Model) gere automaticamente títulos, resumos, categorias, navegação e outras tarefas de organização.
-
-  Segundo, meu espaço de trabalho precisa estar arrumado. Não quero ferramentas de construção com configurações complexas, me preocupar com configurações intrincadas de documentos ou estruturas complicadas. Sempre que vejo os arquivos de configuração e a estrutura de projetos de ferramentas como Docusaurus, VuePress ou Astro, fico com dor de cabeça. Agora, o ZEN opta por esconder todas as configurações no diretório `.zen`, varrendo-as para um canto. O usuário só precisa focar no conteúdo da escrita; o resto fica por conta do ZEN. Todos os outros diretórios são seu espaço de escrita, onde você pode organizar seus arquivos Markdown livremente.
-
-- **Retorno à Língua Materna: Escreva em sua língua nativa, construa versões multilíngues sem esforço**
-
-  A vida é curta, não tenho paciência para traduzir. As pessoas atingem sua máxima profundidade de pensamento ao usar sua língua materna. No entanto, manter-se conectado ao mundo é necessário, e não quero abrir mão da comunicação multilíngue. Por isso, desejo uma ferramenta que me permita escrever em minha língua nativa e, ao mesmo tempo, tornar meu conteúdo acessível a mais pessoas. Atualmente, a internacionalização (i18n) exige que você mesmo faça a tradução e mantenha as atualizações de conteúdo, o que é muito trabalhoso. Escolhi usar LLM para fazer a tradução por mim, economizando muito tempo e permitindo a tradução para vários idiomas com um único comando.
-
-## Início Rápido
-
-Pré-requisitos:
-
-- Ter o [Node.js](https://nodejs.org/) instalado (versão 18 ou superior recomendada, necessário comando `npx`)
-- Ter obtido uma [Chave de API da OpenAI](https://platform.openai.com/account/api-keys), ou uma chave de API compatível com a OpenAI
-- Ter o Git instalado (usado para listar arquivos Markdown a partir do Git, ignorando arquivos filtrados pelas regras do `.gitignore`)
-
-Primeiro, trabalhe em uma pasta que já esteja sob controle do Git:
-
-Configure as variáveis de ambiente
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: substitua pela sua Chave de API da OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, usa a API oficial da OpenAI por padrão
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, usa o modelo gpt-3.5-turbo por padrão
-```
-
-Construa o site, com suporte a tradução multilíngue. Usa o diretório atual como fonte e gera a saída no diretório `.zen/dist`.
-
-- É possível especificar os idiomas para gerar usando o parâmetro `--lang` várias vezes (ex.: `--lang pt-BR --lang en-US`).
-- É possível especificar o prefixo da URL base do site usando o parâmetro `--base-url` (ex.: o nome do repositório no GitHub Pages).
-- Não é necessário configurar o idioma de origem; o ZEN detecta automaticamente.
-
-```bash
-npx zengen@latest build --lang pt-BR --lang en-US
-```
-
-**Veja mais parâmetros ou obtenha ajuda**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/pt-BR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -1,30 +0,0 @@
----
-'title': 'Técnicas de Uso da Declaração de Datas em Documentos ZEN'
-'summary': 'Este documento apresenta técnicas para declarar datas diretamente no corpo do texto usando a ferramenta ZEN, contrastando com o método tradicional do Markdown que utiliza YAML Frontmatter. Destaca a capacidade de reconhecimento automático e processamento inteligente do ZEN, melhorando a experiência do usuário, e é ideal para tipos de conteúdo como diários e blogs que exigem uma linha do tempo.'
-'tags':
-  - 'ZEN'
-  - 'Declaração de Datas'
-  - 'Markdown'
-  - 'Processamento por IA'
-  - 'Linha do Tempo'
-  - 'Experiência do Usuário'
-  - 'Gerenciamento de Documentos'
-'inferred_date': '2026-01-08'
-'inferred_lang': 'pt-BR'
----
-
-# Técnicas de Uso
-
-## Declarando Datas no Corpo do Texto
-
-No corpo do texto, você pode usar declarações de data como "Hoje é 8 de janeiro de 2026" (o estilo de formatação é livre), e o ZEN irá reconhecer e processar automaticamente.
-
-Documentos Markdown tradicionais declaram datas através do YAML Frontmatter, exigindo que o usuário lembre os campos correspondentes, caso contrário, a data pode não ser identificada corretamente.
-
-O ZEN suporta a declaração direta de datas no corpo do texto, evitando o problema de esquecer de preencher os campos do Frontmatter.
-
-A IA extrairá e inferirá automaticamente as informações de data presentes no texto, tratando-as como a data de criação do documento.
-
-Essa abordagem é mais flexível e inteligente, melhorando a experiência do usuário.
-
-A propósito, documentos com datas podem gerar uma visualização de linha do tempo, facilitando a navegação e o gerenciamento. É especialmente útil para tipos de conteúdo como diários e blogs que exigem uma linha do tempo.

package/.zen/src/pt-PT/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -1,121 +0,0 @@
----
-'title': 'Documento de Teste de Gráficos Mermaid'
-'summary': 'Este documento é um ficheiro de teste para verificar a funcionalidade de renderização de gráficos Mermaid no ZEN. Inclui exemplos de vários tipos de gráficos Mermaid, como fluxogramas, diagramas de sequência, diagramas de Gantt, diagramas de classes, diagramas de estado e gráficos de setores, além de um teste de sintaxe incorreta para verificar a exibição de mensagens de erro. O documento visa demonstrar o funcionamento correto da integração do Mermaid no ZEN.'
-'tags':
-  - 'Mermaid'
-  - 'Teste de Gráficos'
-  - 'ZEN'
-  - 'Fluxograma'
-  - 'Diagrama de Sequência'
-  - 'Diagrama de Gantt'
-  - 'Diagrama de Classes'
-  - 'Diagrama de Estado'
-'inferred_date': '2024-01-01'
-'inferred_lang': 'pt-PT'
----
-
-# Teste de Gráficos Mermaid
-
-Este é um ficheiro de teste para verificar a funcionalidade de renderização de gráficos Mermaid no ZEN.
-
-## Exemplo de Fluxograma
-
-```mermaid
-graph TD
-    A[Início] --> B{Continuar?}
-    B -->|Sim| C[Executar ação]
-    B -->|Não| D[Fim]
-    C --> E[Verificar resultado]
-    E --> F{Sucesso?}
-    F -->|Sim| G[Concluído]
-    F -->|Não| H[Repetir]
-    H --> C
-    G --> D
-```
-
-## Exemplo de Diagrama de Sequência
-
-```mermaid
-sequenceDiagram
-    participant Utilizador
-    participant Sistema
-    participant Base de Dados
-
-    Utilizador->>Sistema: Submeter pedido
-    Sistema->>Base de Dados: Consultar dados
-    Base de Dados-->>Sistema: Retornar resultados
-    Sistema-->>Utilizador: Exibir resultados
-```
-
-## Exemplo de Diagrama de Gantt
-
-```mermaid
-gantt
-    title Cronograma do Projeto
-    dateFormat  YYYY-MM-DD
-    section Design
-    Análise de Requisitos     :done,    des1, 2024-01-01, 7d
-    Design do Protótipo       :active,  des2, 2024-01-08, 5d
-    Design Detalhado          :         des3, after des2, 5d
-    section Desenvolvimento
-    Desenvolvimento Frontend  :         dev1, after des3, 10d
-    Desenvolvimento Backend   :         dev2, after des3, 15d
-    section Testes
-    Testes Unitários          :         test1, after dev1, 5d
-    Testes de Integração      :         test2, after dev2, 5d
-```
-
-## Exemplo de Diagrama de Classes
-
-```mermaid
-classDiagram
-    class Animal {
-        +String nome
-        +int idade
-        +void comer()
-        +void dormir()
-    }
-    class Cão {
-        +void ladrar()
-    }
-    class Gato {
-        +void miar()
-    }
-
-    Animal <|-- Cão
-    Animal <|-- Gato
-```
-
-## Exemplo de Diagrama de Estado
-
-```mermaid
-stateDiagram-v2
-    [*] --> Inativo
-    Inativo --> Processamento : Iniciar processamento
-    Processamento --> Sucesso : Processamento bem-sucedido
-    Processamento --> Erro : Processamento falhado
-    Sucesso --> [*]
-    Erro --> [*]
-```
-
-## Exemplo de Gráfico de Setores
-
-```mermaid
-pie title Taxa de Utilização de Navegadores
-    "Chrome" : 65.2
-    "Firefox" : 15.3
-    "Safari" : 12.5
-    "Edge" : 5.2
-    "Outros" : 1.8
-```
-
-## Teste de Sintaxe Incorreta (deve exibir mensagem de erro)
-
-```mermaid
-graph TD
-    A --> B
-    // Falta definição da seta aqui
-    C --> D
-```
-
-Este ficheiro de teste inclui vários tipos de gráficos Mermaid para verificar se a integração do Mermaid no ZEN está a funcionar corretamente.

package/.zen/src/pt-PT/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -1,78 +0,0 @@
----
-'title': 'Teste de Renderização de Fórmulas KaTeX'
-'summary': 'Este documento é um exemplo para testar a renderização de fórmulas KaTeX, incluindo múltiplas fórmulas matemáticas inline e em bloco, como E=mc^2, integrais, derivadas, séries, funções por partes, tabelas, matrizes, etc., com o objetivo de verificar a renderização correta das fórmulas.'
-'tags':
-  - 'KaTeX'
-  - 'Teste de Fórmulas'
-  - 'Fórmulas Matemáticas'
-  - 'LaTeX'
-  - 'Renderização'
-  - 'Exemplo de Documento'
-'inferred_lang': 'pt-PT'
----
-
-# Teste de Renderização de Fórmulas KaTeX
-
-Este é um teste de fórmula inline: $ E = mc^2 $.
-
-Este é um teste de fórmula em bloco:
-
-$$
-\int_a^b f(x) \, dx = F(b) - F(a)
-$$
-
-Este é outro teste de fórmula em bloco:
-
-$$
-\frac{d}{dx}e^x = e^x
-$$
-
-Este é um teste de fórmula complexa:
-
-$$
-\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
-$$
-
-Teste de fórmula com casos:
-
-$$
-f(x) =
-\begin{cases}
-x^2 & \text{se } x \geq 0 \\
--x & \text{se } x < 0
-\end{cases}
-$$
-
-Fórmula de tabela:
-
-$$
-\begin{array}{c|c|c}
-a & b & c \\
-\hline
-1 & 2 & 3 \\
-4 & 5 & 6 \\
-\end{array}
-$$
-
-Fórmula de matriz:
-
-$$
-\begin{pmatrix}
-1 & 2 \\
-3 & 4
-\end{pmatrix}
-$$
-
-Teste de fórmula com texto:
-
-$$
-E = mc^2 \quad \text{onde } m \text{ é massa e } c \text{ é a velocidade da luz}
-$$
-
-Fórmula de Kelly generalizada:
-
-$$
-f^* = \argmax_f \sum_{i \in X} P_i \ln (1 + f \cdot R_i)
-$$
-
-Por favor, certifique-se de que todas as fórmulas acima são renderizadas corretamente.

package/.zen/src/pt-PT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -1,70 +0,0 @@
----
-'title': 'ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA'
-'summary': 'O ZEN é um gerador de sites estáticos com IA, focado em simplificar a escrita e construção de documentação. Permite aos utilizadores criar sites HTML estáticos em pastas geridas por git usando Markdown, sem configuração complexa, com todas as definições ocultas no diretório .zen. As funcionalidades principais incluem navegação inteligente por categorias (geração de mapa do site através de análise de conteúdo por IA), tradução automática incremental (suporte a versões multilingues, permitindo escrita na língua materna com tradução processada por IA) e uma experiência de escrita com distrações minimizadas. A ferramenta depende do Node.js, de uma chave da API OpenAI e do Git, construindo rapidamente através da linha de comandos e suportando parâmetros de idioma como zh-Hans e en-US.'
-'tags':
-  - 'Gerador de Sites Estáticos'
-  - 'Markdown'
-  - 'IA'
-  - 'Tradução Multilingue'
-  - 'Minimalismo'
-  - 'Ferramenta de Documentação'
-  - 'ZEN'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA
-
-[> Demonstração do Website](https://zen.zccz14.com/)
-
-## Funcionalidades Básicas
-
-1. 📃 **Geração de Sites Estáticos**: Constrói um site HTML estático a partir de qualquer pasta git que contenha ficheiros Markdown.
-2. 🧭 **Navegação Inteligente por Categorias**: Utiliza IA para analisar o conteúdo, gerando um mapa do site e navegação, sem depender da localização dos ficheiros de origem.
-3. 🌍 **Tradução Automática Incremental**: Utiliza IA para tradução incremental, permitindo que os utilizadores escrevam Markdown na sua língua materna, mas com suporte multilingue.
-
-Porque criar mais um gerador de sites estáticos com Markdown? Refliti sobre como as ferramentas de documentação podem servir melhor os escritores na era da IA:
-
-- Regresso ao conteúdo: Minimizar distrações, focar na escrita
-
-  Devolver a essência à documentação e a serenidade à escrita.
-
-  Primeiro, não quero ser um bibliotecário. Por vezes quero escrever algo, mas ainda não pensei no título ou na organização. Desejo que a LLM me ajude automaticamente a gerar títulos, resumos, categorias, navegação e outras tarefas de organização.
-
-  Segundo, o meu espaço de trabalho deve estar arrumado. Não quero ferramentas de construção com configuração complexa, nem estruturas complicadas. Sempre que vejo os ficheiros de configuração e estruturas de projetos de ferramentas como Docusaurus, VuePress ou Astro, fico com dor de cabeça. Agora, o ZEN opta por ocultar toda a configuração no diretório .zen, escondendo-a num canto, para que o utilizador se concentre apenas no conteúdo da escrita, deixando o resto para o ZEN tratar. Todos os outros diretórios são o seu espaço de escrita, onde pode organizar os seus ficheiros Markdown livremente.
-
-- Regresso à língua materna: Escrever na língua materna, construir versões multilingues de forma fluida
-
-  A vida é curta, não tenho paciência para traduzir. É na língua materna que conseguimos explorar melhor a profundidade do nosso pensamento. Mas manter a ligação com o mundo é essencial, e não quero abdicar da comunicação multilingue. Por isso, desejo uma ferramenta que me permita escrever na minha língua materna e, ao mesmo tempo, tornar o meu conteúdo acessível a mais pessoas. Atualmente, o i18n exige que traduzamos e mantenhamos as atualizações de conteúdo, o que é demasiado trabalhoso. Opto por usar a LLM para me ajudar com as traduções, poupando muito tempo e permitindo a tradução para vários idiomas com um único clique.
-
-## Início Rápido
-
-Pré-requisitos:
-
-- Ter o [Node.js](https://nodejs.org/) instalado (recomenda-se versão 18 ou superior, com comando npx disponível)
-- Obter uma [Chave da API OpenAI](https://platform.openai.com/account/api-keys), ou uma chave de API compatível com a OpenAI
-- Ter o Git instalado (para listar ficheiros Markdown a partir do Git, ignorando ficheiros filtrados pelas regras .gitignore)
-
-Primeiro, trabalhe numa pasta já gerida pelo git:
-
-Configure as variáveis de ambiente
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: substitua pela sua chave da API OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, utiliza por predefinição a API oficial da OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, utiliza por predefinição o modelo gpt-3.5-turbo
-```
-
-Construa o site, com suporte a tradução multilingue. Utiliza o diretório atual como origem e gera a saída para o diretório `.zen/dist`.
-
-- Pode especificar as versões de idioma a gerar usando várias vezes o parâmetro `--lang` (por exemplo, `--lang zh-Hans --lang en-US`).
-- Não é necessário configurar o idioma de origem, o ZEN deteta-o automaticamente.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**Ver mais parâmetros ou ajuda**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/pt-PT/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA'
-'summary': 'O ZEN é um gerador de sites estáticos com funcionalidades de IA, concebido para simplificar a escrita de documentação e o processo de construção de sites. Permite que os utilizadores se concentrem em escrever conteúdo em Markdown na sua língua materna, processando automaticamente a geração de títulos, navegação por categorias e tradução incremental, suportando versões multilingues sem configuração complexa. A ferramenta baseia-se em Node.js e na API da OpenAI, construindo sites rapidamente através da linha de comandos, sendo ideal para escritores que valorizam eficiência e simplicidade.'
-'tags':
-  - 'Gerador de Sites Estáticos'
-  - 'Markdown'
-  - 'IA'
-  - 'Minimalismo'
-  - 'Tradução Multilingue'
-  - 'Node.js'
-  - 'OpenAI'
-'inferred_lang': 'pt-PT'
----
-
-# ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA
-
-[> Demonstração do Website](https://zccz14.github.io/ZEN/)
-
-## Funcionalidades Básicas
-
-1. 📃 **Geração de Sites Estáticos**: Constrói um site HTML estático a partir de qualquer pasta git que contenha ficheiros Markdown.
-2. 🧭 **Navegação Inteligente por Categorias**: Utiliza IA para analisar o conteúdo, gerando um mapa do site e navegação, independentemente da localização dos ficheiros de origem.
-3. 🌍 **Tradução Automática Incremental**: Utiliza IA para realizar traduções incrementais, permitindo que os utilizadores escrevam em Markdown na sua língua materna, mas com suporte multilingue.
-
-Porque criar mais um gerador de sites estáticos com Markdown? Refliti sobre como as ferramentas de documentação podem servir melhor os escritores na era da IA:
-
-- Regresso ao conteúdo: Minimizar distrações, focar na escrita
-
-  Devolver a essência à documentação e a serenidade à escrita.
-
-  Primeiro, não quero ser um bibliotecário. Por vezes, quero escrever algo, mas ainda não pensei no título ou na sua organização. Desejo que um LLM gere automaticamente títulos, resumos, categorias, navegação e outras tarefas de organização.
-
-  Segundo, o meu espaço de trabalho deve estar arrumado. Não quero ferramentas de construção com configurações complexas, nem estruturas complicadas. Sempre que vejo os ficheiros de configuração e estruturas de projetos de ferramentas como Docusaurus, VuePress ou Astro, fico com dor de cabeça. Agora, o ZEN opta por esconder todas as configurações no diretório `.zen`, arrumando-as num canto, para que o utilizador se concentre apenas no conteúdo da escrita, deixando o resto a cargo do ZEN. Todos os outros diretórios são o seu espaço de escrita, onde pode organizar os seus ficheiros Markdown livremente.
-
-- Regresso à língua materna: Escrever na língua materna, construindo versões multilingues de forma fluida
-
-  A vida é curta, não tenho paciência para traduzir. É na língua materna que conseguimos explorar melhor a profundidade do nosso pensamento. No entanto, manter a ligação com o mundo é essencial, e não quero abdicar da comunicação multilingue. Por isso, desejei uma ferramenta que me permitisse escrever na minha língua materna, ao mesmo tempo que torna o meu conteúdo acessível a mais pessoas. Atualmente, o i18n exige que façamos as nossas próprias traduções e mantenhamos as atualizações de conteúdo, o que é demasiado trabalhoso. Optei por utilizar um LLM para me ajudar nas traduções, poupando-me muito tempo e permitindo a tradução para vários idiomas com um único clique.
-
-## Início Rápido
-
-Pré-requisitos:
-
-- Ter o [Node.js](https://nodejs.org/) instalado (recomenda-se versão 18 ou superior, com comando npx disponível)
-- Obter uma [Chave de API da OpenAI](https://platform.openai.com/account/api-keys), ou uma chave de API compatível com a OpenAI
-- Ter o Git instalado (para listar ficheiros Markdown a partir de um repositório Git, ignorando ficheiros filtrados pelas regras do .gitignore)
-
-Primeiro, trabalhe numa pasta já gerida pelo git:
-
-Configure as variáveis de ambiente
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: Substitua pela sua Chave de API da OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, utiliza por predefinição a API oficial da OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, utiliza por predefinição o modelo gpt-3.5-turbo
-```
-
-Construa o site, com suporte para tradução multilingue. Utiliza o diretório atual como fonte e gera a saída para o diretório `.zen/dist`.
-
-- Pode especificar as versões de idioma a gerar utilizando várias vezes o parâmetro `--lang` (por exemplo, `--lang pt-PT --lang en-US`).
-- Pode especificar o prefixo do URL base do site com o parâmetro `--base-url` (por exemplo, o nome do repositório no GitHub Pages).
-- Não é necessário configurar o idioma de origem, o ZEN deteta-o automaticamente.
-
-```bash
-npx zengen@latest build --lang pt-PT --lang en-US
-```
-
-**Ver mais parâmetros ou ajuda**:
-
-```bash
-npx zengen@latest
-```