Portar un tema de WordPress a EmDash
Recrea los diseños e interacciones relevantes del tema como un sitio Astro respaldado por EmDash. Preserva la fidelidad visual y el alcance de funcionalidades solicitadas por el usuario; no asumas que cada plantilla de WordPress o característica de demostración pertenece al puerto.
Carga building-emdash-site para conocer el esquema actual de EmDash, consultas, renderizado, caché y patrones de datos semilla. Cuando haya un sitio de referencia en vivo, usa la CLI agent-browser para comparación visual; ejecuta agent-browser skills get core --full para su referencia de comandos.
Elegir la evidencia
Usa las mejores fuentes disponibles en este orden:
- Código fuente del tema y
theme.json, hojas de estilo, plantillas yfunctions.php; - Una demostración en vivo en viewports de escritorio y móvil representativos;
- Capturas de pantalla o archivos de diseño proporcionados por el usuario;
- Decisiones de diseño explícitas donde la fuente sea ambigua.
No infieras que el contenido de demostración o las imágenes comparten la licencia del código del tema. Reutiliza un activo solo cuando su licencia o los derechos del usuario lo permitan; de lo contrario, usa un sustituto con licencia clara y dimensiones y peso visual similares.
Planificar el puerto
Inventaría solo los tipos de página, componentes, estados responsivos e interacciones necesarios para el sitio solicitado. Mapea las responsabilidades de WordPress antes de implementar:
- Las plantillas PHP se convierten en rutas, diseños y componentes de Astro.
- Los tipos de contenido personalizados, metadatos y taxonomías se convierten en colecciones, campos y taxonomías de EmDash.
- Los valores del Personalizador de Temas se convierten en configuración del sitio o configuración explícita del proyecto.
- Las ubicaciones de menús se convierten en menús nombrados de EmDash consultados por las plantillas.
- Las barras laterales y widgets se convierten en áreas de widgets o componentes ordinarios de Astro.
- Los shortcodes y comportamientos propiedad de plugins pueden requerir una migración de plugin separada.
Lee WordPress theme concept mapping al traducir la jerarquía de plantillas, registros de functions.php, etiquetas de plantilla, hooks, widgets o bloques reutilizables.
Las rutas de contenido dinámico de EmDash deben permanecer renderizadas en el servidor. Usa el componente Image de EmDash para campos multimedia de EmDash; los activos comunes del tema pueden usar el manejo de activos de Astro.
Trabajar en fases con alcance definido
Lee un archivo de fase solo cuando esa fase aplique:
- Descubrimiento y captura de referencia
- Extracción de diseño
- Conversión de plantillas
- Funcionalidades dinámicas de EmDash
- Esquema y datos semilla
- Verificación renderizada
Al crear un proyecto de tema independiente, comienza desde la plantilla de sitio actual del repositorio o el proyecto existente del usuario. Confirma el destino antes de escribir y no reemplaces una estructura de sitio existente sin indicación explícita.
Verificar el resultado
Construye el sitio y ejercita cada página e interacción dentro del alcance. Compara los viewports coincidentes con la referencia, incluyendo navegación responsiva, contenido con valores largos y ausentes, RTL cuando la administración o el comportamiento del tema dependa de la dirección, y estados vacíos o de error relevantes.
Captura capturas de pantalla de antes y después o de referencia y resultado cuando la fidelidad visual sea parte de la aceptación. Reporta desviaciones deliberadas, evidencia fuente faltante, comportamiento no soportado de WordPress y sustituciones de activos.
Licencias y atribución
Inspecciona la licencia real y los avisos del tema fuente. Preserva los derechos de autor y atribuciones requeridos, incluye el texto de licencia aplicable para el código reutilizado e identifica los activos de terceros por separado. No etiquetes un puerto como GPL-2.0-o-posterior solo porque la fuente sea un tema de WordPress.