jigsaw blog template

Plantilla de inicio de blog de rompecabezas

Esta es una plantilla inicial para crear un blog hermoso y personalizable en Jigsaw con un mínimo esfuerzo. Sólo tendrás que cambiar algunas configuraciones y estarás listo para comenzar.

Vea una vista previa de la plantilla del blog.

Instalación

Después de instalar Jigsaw, ejecute el siguiente comando desde el directorio de su proyecto:

./vendor/bin/jigsaw init blog

Esta plantilla inicial incluye ejemplos de tipos de páginas comunes y viene preconfigurada con:

• Una barra de navegación totalmente responsiva
• Tailwind CSS, un framework CSS de utilidad que te permite personalizar tu diseño sin tocar una línea de CSS
• Purguecss para eliminar selectores no utilizados de su CSS, lo que da como resultado archivos CSS más pequeños
• Resaltado de sintaxis usando resaltado.js
• Un script que genera automáticamente un archivo sitemap.xml
• Una página 404 personalizada
• Un componente para aceptar suscripciones a un boletín informativo de Mailchimp
• Un formulario de contacto de muestra
• Una barra de búsqueda impulsada por Fuse.js y Alpine.js, que indexa su contenido automáticamente y no requiere configuración

---

---

Configurando su nuevo sitio

Como ocurre con todos los sitios de Jigsaw, los ajustes de configuración se pueden encontrar en config.php ; puede actualizar las variables en ese archivo con configuraciones específicas de su sitio. También puede agregar nuevas variables de configuración allí para usarlas en su sitio; Eche un vistazo a la documentación de Jigsaw para obtener más información.

 // config.php
return [
    ' baseUrl ' => ' https://my-awesome-jigsaw-site.com/ ' ,
    ' production ' => false ,
    ' siteName ' => ' My Site ' ,
    ' siteDescription ' => ' Give your blog a boost with Jigsaw. ' ,
    ...
];

Consejo: Este archivo de configuración también es donde definirá las "colecciones" (por ejemplo, una colección de los contribuyentes a su sitio o una colección de publicaciones de blog organizadas por tema). Consulte la documentación oficial de Jigsaw para obtener más información.

---

Agregar contenido

Puede escribir su contenido utilizando una variedad de tipos de archivos. De forma predeterminada, esta plantilla inicial espera que su contenido esté ubicado en la carpeta source/_posts/ .

La parte superior de cada página de contenido contiene un encabezado YAML que especifica cómo se debe representar. El atributo title se utiliza para generar dinámicamente title HTML y etiquetas OpenGraph para cada página. El atributo extends define con qué diseño principal de Blade se representará este archivo de contenido (por ejemplo, _layouts.post se representará con source/_layouts/post.blade.php ), y el atributo section define la "sección" de Blade que espera que se coloque este contenido. en ello.

---
extends : _layouts.post
section : content
title : Getting Started
date : 2022-08-02
description : Getting started with the Jigsaw blog starter template
cover_image : /assets/img/post-cover-image-2.png
featured : true
---

---

Agregar activos

Cualquier activo que deba compilarse (como archivos JavaScript, Less o Sass) se puede agregar al directorio source/_assets/ , y Laravel Mix los procesará cuando se ejecute npm run dev o npm run prod . Los activos procesados ​​se almacenarán en /source/assets/build/ (tenga en cuenta que no hay guiones bajos en este segundo directorio de assets ).

Luego, cuando Jigsaw cree su sitio, todo el directorio /source/assets/ que contiene sus archivos creados (y cualquier otro directorio que contenga recursos estáticos, como imágenes o fuentes, que elija almacenar allí) se copiará a las carpetas de compilación de destino. ( build_local , en su máquina local).

Los archivos que no requieren procesamiento (como imágenes y fuentes) se pueden agregar directamente a /source/assets/ .

Lea más sobre cómo compilar recursos en Jigsaw usando Laravel Mix.

---

Construyendo su sitio

Ahora que ha editado sus variables de configuración y sabe cómo personalizar sus estilos y contenido, creemos el sitio.

 # build static files with Jigsaw
./vendor/bin/jigsaw build

# compile assets with Laravel Mix
# options: dev, prod
npm run dev