Adicionar Postagens de Blog
Objetivo
Adicionar conteúdo do usuário a um blog estático existente sem forçar um novo sistema de blog.
Esta habilidade deve primeiro entender como o site atual já representa postagens, depois adicionar novo conteúdo nesse estilo. Não é um conversor genérico de Markdown para HTML.
Contrato
Entradas:
- Pasta do site estático existente e seu sistema atual de postagens/índices/modelos.
- Uma ou mais postagens de origem: Markdown, notas do Obsidian, documentos do Word, HTML antigo, texto colado, imagens, anexos ou pastas de conteúdo.
- Metadados opcionais como título, data, tags, resumo, slug, imagem de capa e escopo de importação.
Saídas:
- Novas páginas de artigo/detalhe que correspondem ao estilo de artigo existente do site.
- Pontos de entrada atualizados, como índice do blog, arquivo, tags/categorias, postagens recentes da página inicial, dados de pesquisa, RSS ou sitemap, quando esses sistemas já existem.
- Imagens e anexos locais copiados/religados com caminhos relativos à página.
- Instruções de postagem
EDITING.mdatualizadas, quando aplicável.
Limites:
- Não redesenhe o site ou crie um novo sistema de postagem quando um existente for claro.
- Não invente metadados, datas, autores ou alegações que a fonte não suporte.
- Não adicione dependências remotas de matemática/CDN silenciosamente.
- Não publique; use
publish-static-site.
Portão de sucesso:
- Novas postagens são renderizadas no estilo existente e são acessíveis a partir dos índices apropriados.
- Imagens, matemática, links, código, tabelas e conteúdo rico funcionam ou itens não resolvidos são relatados explicitamente.
- Caminhos são relativos à página a partir de páginas de artigo e índice.
- Páginas afetadas passam pela validação do navegador e
review-static-sitepode passar ou apenas relatar limitações aceitas.
Se o portão falhar:
- Corrija conversão, metadados, caminhos, ativos ou conexão de índice nesta habilidade.
- Use
edit-site-partpara pequenos ajustes visuais causados pela importação. - Use
review-static-sitenovamente após as correções.
Quando Usar
Use esta habilidade quando o usuário quiser:
- Adicionar um novo artigo, nota, ensaio ou postagem de blog.
- Importar vários arquivos Markdown em um site estático.
- Mover postagens de um blog antigo para um novo site gerado.
- Converter texto de artigo colado em uma página de artigo do site.
- Atualizar o índice do blog, arquivo, tags, postagens recentes da página inicial ou pontos de entrada relacionados.
- Preservar a linguagem visual atual do site enquanto adiciona conteúdo.
Não use esta habilidade para escolher um tema, construir um novo site do zero, recriar o estilo de um site, personalizar conteúdo de perfil/sobre, fazer um pequeno ajuste visual, publicar o site ou converter o projeto para um framework.
Entradas
Use o que estiver disponível:
- Pasta do site estático, geralmente
site/,dist/,out/oupublic/. - Um ou mais arquivos Markdown, documentos do Word, postagens coladas, arquivos HTML antigos, pastas de imagens ou pastas de conteúdo.
EDITING.md, mapa de página ou notas de transferência de habilidades anteriores.- Páginas de modelo de artigo existentes ou postagens representativas.
- Título, data, tags, categoria, resumo, slug, imagem de capa e preferência de publicação fornecidos pelo usuário.
- Se importar todas as postagens, um subconjunto selecionado ou um lote representativo primeiro.
Se o conteúdo de origem for grande, inspecione a estrutura primeiro e evite importar tudo cegamente.
1. Entenda o Sistema de Postagem Existente
Antes de escrever novas postagens, inspecione como o site funciona atualmente.
Verifique:
- Arquivos de postagem como
posts/*.html,notes/*.html,articles/*.htmlou pastas de rota aninhadas. - Páginas de índice como
blog.html,archive/index.html,notes/index.html,tags/index.htmloucategory/index.html. - Arquivos de dados como
data/posts.json,data/notes.json,data/site.jsonouprofile.json. - Matrizes de dados JavaScript em
assets/script.jsou arquivos semelhantes. - Seções da página inicial para postagens recentes, postagens em destaque, notas, listas de leitura ou destaques de escrita.
- Páginas de artigo/detalhe existentes que podem ser usadas como modelos.
- Estratégia de caminho existente: se os modelos usam links relativos à página, como
../assets/style.css, ou links raiz do servidor, como/assets/style.css. - RSS, Atom, sitemap, índice de pesquisa ou páginas de tag/categoria, se já presentes.
- Instruções
EDITING.mdpara adicionar postagens. - Convenções existentes de imagem e anexo, como
assets/images/posts/, pastas de postagem colocalizadas, campos de capa, classes de figura, marcação lightbox, legendas ou wrappers de imagem responsivos. - Convenções existentes de conteúdo rico, como renderização matemática, destaque de código, tabelas, notas de rodapé, callouts, âncoras de cabeçalho, índice, cartões de link, incorporações, diagramas e seções de citação/referência.
Siga a estrutura existente. Não invente um novo sistema de postagem quando o site já tiver um.
2. Extrair Metadados da Postagem
Para cada postagem de origem, extraia ou derive:
- Título.
- Data.
- Slug.
- Tags ou categoria.
- Resumo ou trecho.
- Imagem de capa ou imagem herói, se presente e utilizável.
- Caminho de origem.
- Tempo de leitura, apenas se o site atual já o usa ou é fácil de calcular de forma consistente.
Use frontmatter quando presente. Caso contrário, infira a partir do primeiro título, nome do arquivo, pasta circundante, texto de data visível ou primeiro parágrafo.
Não invente datas, tags, autores ou alegações específicas. Se um campo estiver faltando e não puder ser inferido, use um espaço reservado claro ou omita o campo quando o estilo do site permitir.
3. Converter Conteúdo para o Estilo do Site
Crie novas páginas de artigo correspondendo ao modelo de artigo existente e à experiência de leitura.
Preserve:
- Cabeçalho, navegação, rodapé, barras laterais e shell compartilhado.
- Tipografia do artigo, espaçamento, layout de metadados, tags, links de volta e links relacionados.
- Qualquer linguagem de tema especial, como entradas de registro, notas de campo, cartões, moldura de terminal/arquivo ou ensaios mínimos.
- Convenções de classe CSS existentes e estruturas de dados.
Para Markdown:
- Converta cabeçalhos, parágrafos, blockquotes, listas, listas de tarefas, tabelas, blocos de código, links, notas de rodapé, callouts e imagens em HTML semântico.
- Preserve rótulos de idioma de código quando disponíveis.
- Mantenha referências de imagem relativas à página e copie imagens locais apenas quando necessário.
- Mantenha chinês, japonês, coreano, latim acentuado e outro texto não-ASCII como UTF-8 legível.
Para HTML antigo:
- Extraia o corpo do artigo e os metadados.
- Remova chrome antigo do site, análises, comentários, navegação não relacionada e identidade do site de origem.
- Reenvolva o conteúdo no modelo de artigo do novo site.
3.5. Preservar Compatibilidade de Caminho Estática
Ao adicionar postagens, calcule caminhos a partir da localização de cada página gerada. Não copie caminhos de index.html cegamente em páginas de artigo aninhadas.
Regras padrão:
- Novas páginas de artigo devem usar links relativos à página para CSS, JavaScript, fontes, imagens e navegação compartilhados.
- Se a postagem for gerada em
posts/my-post.html, ativos compartilhados geralmente precisam de../assets/style.css,../assets/script.jse imagens de postagem como../assets/images/posts/my-post/figure.png. - Links de páginas raiz para a postagem geralmente devem ser
posts/my-post.html. - Links da postagem de volta para páginas raiz geralmente devem ser
../index.html,../blog.htmlou../archive/index.html, dependendo da estrutura. - Não introduza caminhos absolutos de raiz como
/assets/...,/posts/...,/data/...ou/images/...a menos que o site existente os use intencionalmente e o usuário aceite que a abertura direta defile://e hospedagem de subcaminho podem quebrar. - Atualize links gerados por JavaScript, resultados de pesquisa, filtros de tag, links de postagens relacionadas, caminhos de capa, entradas RSS/sitemap e quaisquer arquivos de dados com a mesma estratégia de caminho.
- Se o site existente já tiver links absolutos de raiz por acidente, relate e prefira corrigir os caminhos afetados em vez de estender o problema.
Evite problemas de busca de arquivo local:
- Não faça postagens recém-adicionadas dependerem de
fetch()de JSON/Markdown local para o corpo do artigo. - Se os índices forem renderizados a partir de dados, mantenha links essenciais de postagem visíveis em HTML ou use um objeto de dados JavaScript relativo que funcione com visualização de abertura direta.
4. Lidar com Formatos de Conteúdo Rico
Preserve conteúdo rico intencionalmente em vez de achatar tudo em parágrafos simples.
Primeiro inspecione se o site atual já suporta:
- Renderização matemática com KaTeX, MathJax, CSS personalizado ou blocos TeX brutos.
- Destaque de código, rótulos de idioma, botões de cópia ou molduras de código estilo terminal.
- Tabelas, wrappers de tabela responsivos, notas de rodapé, callouts, admoestações, citações e listas de tarefas.
- Âncoras de cabeçalho, índice, backlinks, notas relacionadas ou links de seção.
- Cartões de link, listas de favoritos, páginas de índice de URL, citações, listas de referência ou seções de bibliografia.
- Mídia incorporada como vídeo, áudio, PDFs, iframes, diagramas Mermaid, diagramas Excalidraw/SVG ou anexos para download.
Siga o padrão existente quando um existir. Se nenhum padrão existir, use HTML semântico simples e relate qualquer recurso que precise de um renderizador adicional.
Matemática e fórmulas:
- Preserve matemática inline e display de
$...$,$$...$$,\(...\),\[...\]ou exportações de equações do Word. - Use o renderizador matemático existente do site, se presente.
- Se a fonte contém muitas fórmulas e nenhum renderizador existe, prefira uma integração local de KaTeX para sites estáticos simples: armazene CSS/JS/fontes do KaTeX em uma pasta vendor local, adicione um pequeno script de renderização local e não dependa de um CDN.
- Não adicione silenciosamente uma dependência remota de MathJax/KaTeX a um site que de outra forma não tem dependências.
- Preserve o TeX original dentro de elementos marcados com matemática como fallback, depois renderize no navegador. Se a renderização falhar para uma fórmula, o fallback TeX legível deve permanecer visível em vez de quebrar a página.
- Normalize sintaxe de origem óbvia que o KaTeX precisa, como setas softmax,
\cdot,\times, pontuação acidentalmente misturada em fórmulas e expressões comuns de Q/K/V. - Não deixe postagens pesadas de fórmulas como caixas TeX que parecem código quando um renderizador matemático foi adicionado.
- Mantenha fórmulas legíveis na fonte e no fallback do navegador.
Blocos de código:
- Preserve nomes de idioma de código cercado.
- Escape HTML dentro de blocos de código.
- Mantenha longas linhas de código roláveis em vez de quebrar o layout da página.
- Reutilize estilo de bloco de código existente, botões de cópia e convenções de destaque de sintaxe.
- Não execute código fonte de postagens.
Tabelas:
- Converta tabelas Markdown, Word ou HTML em tabelas semânticas.
- Envolva tabelas largas no contêiner responsivo de tabela existente do site ou adicione um pequeno wrapper local.
- Preserve linhas de cabeçalho, intenção de alinhamento e legendas quando disponíveis.
Links, índices de URL e referências internas:
- Preserve links externos com texto de link claro.
- Converta links relativos e links
.mddo Markdown para o caminho HTML estático gerado quando a postagem de destino for importada. - Converta wikilinks do Obsidian como
[[Note]],[[Note#Heading]]e[[Note|Alias]]em links normais quando o destino puder ser resolvido. - Preserve links internos não resolvidos como espaços reservados visíveis ou texto simples, e relate-os.
- Gere IDs de cabeçalho estáveis quando o site usa links de âncora ou índice.
- Para índice de URL, favoritos ou postagens de resumo de links, mantenha a estrutura de lista. Use o estilo de cartão de link/lista existente do site quando presente; não invente cartões de visualização que exijam busca de metadados remotos, a menos que o usuário peça.
Notas de rodapé, citações e referências:
- Converta notas de rodapé Markdown em uma seção de notas de rodapé usando o estilo existente do site, se presente.
- Preserve rótulos de citação, entradas de bibliografia e links de referência.
- Se o texto de origem usar chaves de citação não resolvidas como
[@paper2024], mantenha-os visíveis e relate que os metadados de citação estão faltando, a menos que um arquivo de bibliografia seja fornecido.
Callouts, admoestações e tipos de bloco:
- Converta callouts estilo Obsidian/GitHub como
> [!NOTE],> [!TIP],> [!WARNING]e> [!IMPORTANT]no padrão de callout/cartão/blockquote mais próximo do site. - Preserve listas de tarefas como listas de verificação quando o site atual tiver estilo de lista de verificação; caso contrário, use marcação de caixa de seleção desabilitada ou listas simples.
Incorporações e anexos:
- Para PDFs, slides, conjuntos de dados, downloads, áudio e vídeo, prefira um link claro ou cartão de download, a menos que o site já incorpore esse tipo de mídia.
- Copie anexos locais apenas quando fornecidos pelo usuário.
- Mantenha incorporações remotas apenas quando o usuário as possui ou as referencia intencionalmente.
- Para blocos Mermaid ou diagrama, use o renderizador existente se presente. Se nenhum renderizador existir, preserve o bloco de origem e relate-o, ou converta para um SVG/PNG estático apenas quando prático e apropriado.
5. Lidar com Imagens e Ativos da Postagem
Lide com imagens de acordo com as convenções de ativos atuais do site.
Primeiro inspecione como as postagens existentes armazenam e renderizam imagens:
- Pasta de ativos compartilhada como
assets/images/posts/<slug>/. - Ativos de postagem colocalizados como
posts/<slug>/images/. - Campos de dados como
cover,heroImage,thumbnailouimages. - Marcação de figura, legendas, links lightbox, carregamento preguiçoso, atributos de largura/altura e classes CSS responsivas.
Prefira o padrão existente. Se nenhum padrão existir, use uma convenção estática simples como:
assets/images/posts/<post-slug>/
Para fontes Markdown:
- Resolva links de imagem relativos a partir da pasta do arquivo Markdown.
- Copie imagens locais para a pasta de imagens de postagem do site quando necessário.
- Reescreva referências de imagem Markdown para os novos caminhos relativos do site.
- Para páginas de artigo aninhadas, inclua a profundidade
../correta nos caminhos de imagem. - Preserve texto alternativo do Markdown quando presente.
- Converta legendas de imagem se a fonte usar texto itálico próximo, atributos title ou incorporações estilo Obsidian.
- Não deixe links apontando para caminhos absolutos de disco local.
Para notas do Obsidian:
- Suporte incorporações comuns como
![[image.png]]e pastas de anexo relativas. - Pesquise pastas de anexo prováveis perto da nota, como
attachments/,assets/,images/ou a pasta de anexo configurada do cofre quando visível. - Reescreva incorporações em marcação HTML de imagem ou figura normal.
Para fontes Word .docx:
- Extraia imagens incorporadas do pacote de documento ou use ferramentas de documento disponíveis.
- Preserve a ordem da imagem em relação ao texto circundante quando possível.
- Salve imagens extraídas sob a pasta de imagens de postagem com nomes estáveis.
- Use legendas próximas ou texto alternativo quando disponíveis.
...
[truncado para tradução]