emdash-cms/emdash

Portar um tema WordPress para EmDash

Recrie os layouts e interações relevantes do tema como um site Astro com EmDash. Preserve a fidelidade visual e o escopo de funcionalidades solicitados pelo usuário; não presuma que todo template WordPress ou recurso de demonstração deve fazer parte do port.

Carregue building-emdash-site para obter os padrões atuais de esquema, consulta, renderização, cache e seed do EmDash. Quando um site de referência ao vivo estiver disponível, use a CLI agent-browser para comparação renderizada; execute agent-browser skills get core --full para obter a referência de comandos.

Escolher as evidências

Use as melhores fontes disponíveis nesta ordem:

1. Código fonte do tema e theme.json, folhas de estilo, templates e functions.php;
2. Uma demonstração ao vivo em viewports desktop e mobile representativas;
3. Capturas de tela ou arquivos de design fornecidos pelo usuário;
4. Decisões explícitas de design quando a fonte for ambígua.

Não presuma que o conteúdo ou imagens de demonstração compartilham a licença do código do tema. Reutilize um ativo apenas quando sua licença ou os direitos do usuário permitirem; caso contrário, use um substituto com licença clara e dimensões e peso visual semelhantes.

Planejar o port

Inventarie apenas os tipos de página, componentes, estados responsivos e interações necessários para o site solicitado. Mapeie as responsabilidades do WordPress antes de implementar:

• Templates PHP tornam-se rotas, layouts e componentes Astro.
• Custom post types, metadados e taxonomias tornam-se coleções, campos e taxonomias EmDash.
• Valores do Theme Customizer tornam-se configurações do site ou configuração explícita do projeto.
• Localizações de menu tornam-se menus EmDash nomeados, consultados por templates.
• Sidebars e widgets tornam-se áreas de widgets ou componentes Astro comuns.
• Shortcodes e comportamentos de plugins podem exigir uma migração de plugin separada.

Leia mapeamento de conceitos de temas WordPress ao traduzir hierarquia de templates, registros em functions.php, template tags, hooks, widgets ou blocos reutilizáveis.

Rotas de conteúdo dinâmico EmDash devem permanecer renderizadas no servidor. Use o componente Image do EmDash para campos de mídia do EmDash; ativos comuns do tema podem usar o gerenciamento de ativos do Astro.

Trabalhar em fases com escopo definido

Leia um arquivo de fase somente quando essa fase se aplicar:

• Descoberta e captura de referência
• Extração de design
• Conversão de templates
• Funcionalidades dinâmicas EmDash
• Esquema e dados de seed
• Verificação renderizada

Ao criar um projeto de tema independente, comece a partir do template de site atual do repositório ou do projeto existente do usuário. Confirme o destino antes de escrever e não substitua uma estrutura de site existente sem orientação explícita.

Verificar o resultado

Construa o site e exercite cada página e interação no escopo. Compare viewports correspondentes com a referência, incluindo navegação responsiva, conteúdo com valores longos e ausentes, RTL quando a administração ou o comportamento do tema depender da direção, e estados vazios ou de erro relevantes.

Capture capturas de tela antes e depois ou referência e resultado quando a fidelidade visual fizer parte da aceitação. Relate desvios deliberados, evidências de fonte ausentes, comportamento do WordPress não suportado e substituições de ativos.

Licenciamento e atribuição

Inspecione a licença real e os avisos do tema fonte. Preserve os direitos autorais e atribuições exigidos, inclua o texto de licença aplicável para o código reutilizado e identifique ativos de terceiros separadamente. Não rotule um port como GPL-2.0-or-later apenas porque a fonte é um tema WordPress.