Jekyll
Formulario de contacto para Jekyll sin backend.
Las plantillas Liquid de Jekyll producen archivos estáticos en _site; no procesan solicitudes después del despliegue. Coloque un include reutilizable en el sitio, envíe HTML estándar a FormsFort y despliegue los archivos generados donde quiera.
Cómo funciona
Tres pasos para la producción de formularios.
Prepare la entrega
Cree un formulario de FormsFort, establezca su destino de notificación y copie la clave de acceso pública.
Cree un include Liquid
Guarde el marcado como _includes/contact-form.html y renderícelo desde la página o diseño que lo necesite.
Publique _site
Ejecute jekyll build y cargue _site. El host estático solo sirve archivos; FormsFort gestiona el POST del navegador.
Configuración
Include Liquid de Jekyll con formulario de contacto
<!-- _includes/contact-form.html -->
<form action="https://api.formsfort.com/submit" method="POST">
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY">
<fieldset>
<legend>Send a question</legend>
<label for="jekyll-name">Your name</label>
<input id="jekyll-name" name="name" type="text" autocomplete="name" required>
<label for="jekyll-email">Reply-to email</label>
<input id="jekyll-email" name="email" type="email" autocomplete="email" required>
<label for="jekyll-topic">Topic</label>
<select id="jekyll-topic" name="topic" required>
<option value="">Choose a topic</option>
<option value="support">Support</option>
<option value="partnership">Partnership</option>
</select>
<label for="jekyll-message">Question</label>
<textarea id="jekyll-message" name="message" rows="5" required></textarea>
</fieldset>
<input type="checkbox" name="botcheck" style="display:none">
<button type="submit">Send question</button>
</form>
<!-- Render from a page or layout with: {% include contact-form.html %} -->Migración
Lista de verificación de migración.
Mueve un formulario existente en minutos sin reconstruir el marcado.
Cree un formulario FormsFort y copie la clave de acceso público.
Guarde el marcado como _includes/contact-form.html.
Renderice el include con {% include contact-form.html %} en la página de contacto.
Mantenga action en https://api.formsfort.com/submit y use method=POST.
Deje que Liquid se encargue solo de las plantillas; no añada un controlador de envíos en Ruby.
Ejecute jekyll build, despliegue _site y envíe una prueba desde el dominio de producción.
Recursos relacionados
Sigue construyendo desde aquí.
Formulario HTML sin backend
Vea el patrón de navegador a endpoint que utiliza el HTML generado de Jekyll.
Ejemplos de formularios HTML
Adapte campos accesibles de selección, área de texto y carga para un include de Liquid.
Backend de formularios con carga de archivos
Añada un campo de carga cuando un sitio Jekyll necesite adjuntos.
Preguntas frecuentes
Preguntas comunes.
¿Liquid puede procesar un formulario Jekyll enviado?
No. Liquid se ejecuta durante la compilación de Jekyll y _site contiene HTML estático. Un endpoint alojado como FormsFort debe aceptar el POST después del despliegue.
¿Funcionará en GitHub Pages u otro host estático?
Sí. Cualquier host que sirva los archivos _site generados puede mostrar el formulario. La entrega del envío va a FormsFort y no al host de Jekyll.
¿La clave de acceso debe ser un secreto de Jekyll?
Use la clave de acceso pública de FormsFort en el formulario renderizado. No coloque credenciales de administrador, secretos de webhook ni tokens de API privados en Liquid o código del navegador.
¿Puede usarse el include en varios diseños de Jekyll?
Sí. Renderice el mismo include donde sea necesario; cada formulario renderizado puede usar el mismo endpoint y clave de acceso mientras FormsFort registra el envío de la página.
Dejar de administrar servidores de formularios.
Cree un endpoint de formulario de producción, migre su primer formulario de forma gratuita y escale cuando esté listo.