jigsaw blog template

Templat Pemula Blog Jigsaw

Ini adalah template awal untuk membuat blog yang indah dan dapat disesuaikan dalam Jigsaw dengan sedikit usaha. Anda hanya perlu mengubah beberapa pengaturan dan Anda siap berangkat.

Lihat pratinjau template blog.

Instalasi

Setelah menginstal Jigsaw, jalankan perintah berikut dari direktori proyek Anda:

./vendor/bin/jigsaw init blog

Templat pemula ini mencakup contoh jenis halaman umum, dan telah dikonfigurasikan sebelumnya dengan:

• Bilah navigasi yang sepenuhnya responsif
• Tailwind CSS, kerangka kerja CSS utilitas yang memungkinkan Anda menyesuaikan desain tanpa menyentuh sebaris pun CSS
• Pembersihan untuk menghapus pemilih yang tidak digunakan dari CSS Anda, sehingga menghasilkan file CSS yang lebih kecil
• Penyorotan sintaks menggunakan highlight.js
• Skrip yang secara otomatis menghasilkan file sitemap.xml
• Halaman 404 khusus
• Sebuah komponen untuk menerima pendaftaran buletin Mailchimp
• Contoh formulir kontak
• Bilah pencarian yang didukung oleh Fuse.js dan Alpine.js, yang mengindeks konten Anda secara otomatis dan tidak memerlukan konfigurasi apa pun

---

---

Mengonfigurasi situs baru Anda

Seperti semua situs Jigsaw, pengaturan konfigurasi dapat ditemukan di config.php ; Anda dapat memperbarui variabel dalam file tersebut dengan pengaturan khusus untuk situs Anda. Anda juga dapat menambahkan variabel konfigurasi baru di sana untuk digunakan di seluruh situs Anda; lihat dokumentasi Jigsaw untuk mempelajari lebih lanjut.

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

Tip: File konfigurasi ini juga merupakan tempat Anda menentukan "koleksi" apa pun (misalnya, kumpulan kontributor situs Anda, atau kumpulan postingan blog yang disusun berdasarkan topik). Lihat dokumentasi resmi Jigsaw untuk mempelajari lebih lanjut.

---

Menambahkan Konten

Anda dapat menulis konten Anda menggunakan berbagai jenis file. Secara default, template pemula ini mengharapkan konten Anda ditempatkan di folder source/_posts/ .

Bagian atas setiap halaman konten berisi header YAML yang menentukan cara merendernya. Atribut title digunakan untuk menghasilkan title HTML dan tag OpenGraph secara dinamis untuk setiap halaman. Atribut extends mendefinisikan tata letak Blade induk mana yang akan merender file konten ini (misalnya _layouts.post akan merender dengan source/_layouts/post.blade.php ), dan atribut section mendefinisikan "bagian" Blade yang mengharapkan konten ini ditempatkan ke dalamnya.

---
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
---

---

Menambah Aset

Aset apa pun yang perlu dikompilasi (seperti file JavaScript, Less, atau Sass) dapat ditambahkan ke direktori source/_assets/ , dan Laravel Mix akan memprosesnya saat menjalankan npm run dev atau npm run prod . Aset yang diproses akan disimpan di /source/assets/build/ (perhatikan tidak ada garis bawah pada direktori assets kedua ini).

Kemudian, ketika Jigsaw membangun situs Anda, seluruh direktori /source/assets/ yang berisi file yang Anda buat (dan direktori lain yang berisi aset statis, seperti gambar atau font, yang Anda pilih untuk disimpan di sana) akan disalin ke folder build tujuan ( build_local , di mesin lokal Anda).

File yang tidak memerlukan pemrosesan (seperti gambar dan font) dapat ditambahkan langsung ke /source/assets/ .

Baca selengkapnya tentang kompilasi aset di Jigsaw menggunakan Laravel Mix.

---

Membangun Situs Anda

Sekarang setelah Anda mengedit variabel konfigurasi dan mengetahui cara menyesuaikan gaya dan konten, mari buat situsnya.

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

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