gatsby starter ghost

Hantu Pemula Gatsby

Templat awal untuk membangun situs web secepat kilat dengan Ghost & Gatsby

Demo: https://gatsby.ghost.org/

Menginstal

 # With Gatsby CLI
gatsby new gatsby-starter-ghost https://github.com/TryGhost/gatsby-starter-ghost.git

 # From Source
git clone https://github.com/TryGhost/gatsby-starter-ghost.git
cd gatsby-starter-ghost

Kemudian instal dependensi

yarn

Berlari

Mulai server pengembangan. Anda sekarang memiliki situs Gatsby yang mengambil konten dari Ghost tanpa kepala.

gatsby develop

Secara default, starter akan mengisi konten dari instalasi Ghost default yang terletak di https://gatsby.ghost.io.

Untuk menggunakan instalasi Anda sendiri, Anda perlu mengedit file konfigurasi .ghost.json dengan kredensial Anda. Ubah nilai apiUrl menjadi URL situs Hantu Anda. Untuk pelanggan Ghost(Pro), ini adalah URL Hantu yang diakhiri dengan .ghost.io , dan untuk orang yang menggunakan versi Ghost yang dihosting sendiri, ini adalah URL yang sama yang digunakan untuk mengakses situs Anda.

Selanjutnya, perbarui nilai contentApiKey ke kunci yang terkait dengan situs Hantu. Kunci dapat diberikan dengan membuat integrasi dalam Ghost Admin. Navigasikan ke Integrasi dan klik "Tambahkan integrasi baru". Beri nama integrasi dengan tepat dan klik buat.

Terakhir, konfigurasikan URL yang Anda inginkan di siteConfig.js , sehingga tautan (misalnya tautan kanonik) dibuat dengan benar. Anda juga dapat memperbarui nilai default lainnya, seperti postsPerPage di file ini.

Untuk menggunakan starter ini tanpa masalah, instalasi Ghost Anda harus setidaknya pada versi 2.10.0 .

Versi Ghost default yang digunakan untuk starter ini adalah 5.x Jika instalasi Ghost Anda berada pada versi yang lebih rendah, Anda harus memasukkan properti version di pengaturan .ghost.json Anda:

Hantu >=2.10.0 <5.0.0

{
    "apiUrl" : " https://gatsby.ghost.io " ,
    "contentApiKey" : " 9cc5c67c358edfdd81455149d0 " ,
    "version" : " v4.0 "
}

Hantu >=5.0.0

{
    "apiUrl" : " https://gatsby.ghost.io " ,
    "contentApiKey" : " 9cc5c67c358edfdd81455149d0 "
}

Menerapkan dengan Netlify

Pemula berisi tiga file konfigurasi khusus untuk diterapkan dengan Netlify. File netlify.toml untuk pengaturan build, file /static/_headers dengan header keamanan default yang disetel untuk semua rute, dan /static/_redirects untuk menyetel pengalihan domain kustom Netlify.

Untuk menerapkan ke akun Netlify Anda, tekan tombol di bawah.

Kunci API Konten umumnya tidak dianggap sebagai informasi sensitif, kunci tersebut ada sehingga dapat diubah jika terjadi penyalahgunaan; jadi kebanyakan orang memasukkannya langsung ke file konfigurasi .ghost.json mereka. Jika Anda lebih memilih untuk menyimpan informasi ini dari repositori Anda, Anda dapat menghapus konfigurasi ini dan mengatur variabel Netlify ENV untuk build produksi.

Setelah diterapkan, Anda dapat menyiapkan Integrasi Ghost + Netlify untuk menggunakan kait penerapan dari Ghost untuk memicu pembangunan kembali Netlify. Dengan begitu, setiap kali data berubah di Ghost, situs Anda akan dibangun kembali di Netlify.

Mengoptimalkan

Anda dapat menonaktifkan front-end Tema Ghost Handlebars default dengan mengaktifkan tanda Make this site private dalam pengaturan Ghost Anda. Hal ini mengaktifkan perlindungan kata sandi di depan instalasi Ghost dan menyetel <meta name="robots" content="noindex" /> sehingga front-end Gatsby Anda menjadi sumber kebenaran untuk SEO.

Opsi tambahan

 # Run a production build, locally
gatsby build

# Serve a production build, locally
gatsby serve

develop Gatsby menggunakan konfigurasi development di .ghost.json - sedangkan build Gatsby menggunakan konfigurasi production .

Hak Cipta & Lisensi

Hak Cipta (c) 2013-2025 Ghost Foundation - Dirilis di bawah lisensi MIT.