Hosting con 20% de descuento comprando por el enlace

Diseño y temas

El aspecto de un sitio Velk vive en su tema: las plantillas y el CSS que escribe la IA. Cómo pedir cambios visuales, convertir un sitio HTML estático en un tema y por qué a veces un cambio de CSS no se ve.

Un sitio Velk tiene tres partes: la estructura es un archivo (site.json), el contenido está en la base de datos y el aspecto es el tema — las plantillas de las páginas en theme/templates/, las piezas compartidas como el encabezado y el pie en theme/partials/, y el CSS (las reglas de estilo), los scripts y las imágenes al lado. Todo lo que ve el visitante — colores, fuentes, espacios, maquetación — viene del tema, y lo escribe la IA.

El cliente cambia el contenido en el panel, nunca el aspecto. Un post nuevo o un bloque nuevo siempre sale con el diseño del sitio, y el panel no tiene forma de cambiar la maquetación.

Cómo pedir un cambio visual

  • Da una referencia. Un sitio que te gusta, el manual de marca, los códigos de color y los nombres de las fuentes, una maqueta (una imagen o un PDF adjunto en la conversación). “Moderno y limpio” no le dice nada a nadie; “tarjetas como las de esta página, en nuestro azul #1A3D8F” sí.
  • Un cambio a la vez. “Un título más grande en el hero” y luego “más espacio entre los servicios”: dos pedidos que revisas uno por uno.
  • Di dónde aplica — solo la home, todas las páginas, solo los posts — y qué no debe cambiar.
  • Revisa en el teléfono. Achica la ventana del navegador o abre la página en un teléfono, y describe lo que se rompe: “en el teléfono el menú tapa el logo”.

Pídele a la IA

En el hero de la home (la sección grande de apertura), agranda el título — unos 56px en computadora, 36px en teléfono —, mantén la fuente y deja más espacio entre el título y el botón. No cambies nada más en el sitio.

Un cambio medible, en un solo lugar, diciendo qué queda igual: fácil de revisar y fácil de deshacer.

Para una página nueva

Crea la página “Talleres” siguiendo la maqueta adjunta. Pon sus estilos en un archivo CSS propio, que cargue solo esa página, para que nada más cambie en el sitio mientras la ajustamos.

Una página en construcción con su propio CSS aguanta muchas rondas sin romper el resto del sitio. Un ajuste puntual a una regla que ya existe se hace donde esa regla ya vive.

De un sitio HTML estático a un tema Velk

Un sitio en HTML puro — una plantilla que compraste, un sitio estático antiguo, un diseño exportado a HTML — puede convertirse en un tema Velk con el panel ya completado. Pon los archivos en la carpeta del proyecto y pídelo; la primera parada de la skill es un plan para que lo apruebes.

Pídele a la IA

Convierte este HTML en un tema de Velk. Los archivos están en la carpeta sitio-antiguo. Mantén el aspecto idéntico. El blog pasa a ser un tipo de contenido, los testimonios una lista editable, y el menú y los contactos del pie de página van a las opciones. Muéstrame el plan antes de generar nada.

Decir cómo quieres dividir el contenido acerca el plan a lo que necesitas desde el primer intento.

Lo que hace la skill

  1. Aparta el original

    Los archivos originales van a una carpeta _source/ en la raíz del proyecto, fuera del tema. Si Velk todavía no está instalado, propone instalarlo y espera tu sí.

  2. Lee cada página

    El encabezado y el pie repetidos pasan a ser piezas compartidas; las tarjetas repetidas, una lista o un tipo de contenido; el menú y los contactos, opciones; los textos, campos de la página. También recoge los textos y las imágenes escritos en el HTML.

  3. Muestra el plan

    Páginas y sus campos, tipos de contenido, opciones y con qué contenido nacerá el panel. No se genera nada hasta que lo apruebas.

  4. Arma y completa

    Escribe site.json, las plantillas y el CSS; luego un script de una sola vez copia el contenido antiguo a la base de datos, y el panel se abre completo.

  5. Informa lo que falta

    Imágenes para pasar a la biblioteca de medios (hasta entonces se ven los archivos originales), destinatarios de formularios para configurar, scripts de seguimiento (píxeles, chat) para registrar en la pantalla Scripts, y _source/ para borrar cuando apruebes: el primer deploy no se ejecuta mientras esté ahí.

Lo que ejecuta la IA
# después de escribir site.json, las plantillas y el script de carga $ ./bin/velk schema:validate ✓ site.json is valid. $ ./bin/velk page:sync ✓ Pages synced. $ php theme/install/seed.php # copia los textos y las imágenes del sitio antiguo al panel $ ./bin/velk serve ✓ Velk serving on http://localhost:8080
Abre el sitio local y el panel, y compáralos con el original antes de aprobar.

Por qué un cambio de CSS no se ve

Las reglas de servidor de Velk (el archivo .htaccess) les dicen a los navegadores que guarden los archivos CSS y JavaScript durante un mes. Eso hace el sitio más rápido, y significa que una hoja de estilos cargada siempre desde la misma dirección sigue mostrando la versión vieja a quien vuelve al sitio, a veces también a ti. La solución está en el tema: cada archivo CSS y JS se carga con una versión en su dirección, tomada del último cambio del archivo, así que cada cambio tiene una dirección nueva que todos los navegadores buscan.

Los temas que arma la skill ya lo hacen, y la publicación versionada avisa cuando el CSS o el JS cambió sin esa versión. En un tema más antiguo, pídelo una vez: “carga el CSS y el JS con una versión en la dirección”.

Preguntas

¿El cliente puede cambiar colores o fuentes en el panel?

Por defecto, no: el aspecto está en el tema. Si el cliente necesita cambiar algo — el color de un banner, una imagen de temporada —, pide una opción que el tema lea, como una elección entre los colores de la marca.

Cambié el CSS y el sitio se ve igual.

Si solo tú ves la versión vieja, recarga sin caché (Cmd/Ctrl+Shift+R en la mayoría de los navegadores). Si todos la ven, el tema carga el CSS sin versión en su dirección: pídele a la IA que la agregue.