Pemula Gatsby untuk membuat blog dari Ghost CMS tanpa kepala.
Ubah blog Hantu Anda menjadi situs web statis yang sangat cepat. Tema Gatsby ini adalah pengganti front-end dari mesin Ghost Handlebars yang menampilkan tampilan dan nuansa Ghost Casper yang ditingkatkan. Semua konten bersumber dari Ghost CMS tanpa kepala.
Bosan dengan
gatsby-config.js
? Kunjungi Blogody untuk solusi terintegrasi dengan lebih banyak manfaat!
Lebih suka Next.js daripada Gatsby? Pergilah ke hantu cms berikutnya!
Lihat Tutorial untuk panduan praktis dalam menggunakan proyek ini.
Mainkan Demo untuk mendapatkan kesan pertama.
Plugin berikut telah disertakan untuk kenyamanan:
Nama | Versi | Keterangan |
---|---|---|
gatsby-theme-ghost-dark-mode | Pengalih mode gelap? | |
gatsby-rehype-ghost-links | Tulis ulang tautan CMS dari absolut ke relatif | |
gatsby-rehype-prismjs | Penyorotan sintaks dengan PrismJS | |
gatsby-theme-ghost-members ? | Langganan Anggota |
Jika Anda tidak membutuhkannya, Anda dapat mengeluarkannya di gatsby-config.js
dan package.json
yang mungkin menghemat waktu Anda selama proses pembuatan.
Fitur tambahan dapat diintegrasikan dengan menginstal tema atau plugin Gatsby. Plugin berikut telah diuji untuk bekerja dengan gatsby-starter-try-ghost
:
Nama | Versi | Keterangan |
---|---|---|
gatsby-rehype-inline-images ? | Memuat gambar sebaris dengan lambat dan buram | |
gatsby-theme-ghost-contact | Halaman kontak | |
gatsby-theme-ghost-commento | Sistem komentar dengan Commento | |
gatsby-theme-ghost-toc ? | Daftar isi | |
gatsby-plugin-ackee-tracker | Pelacakan situs dengan Ackee | |
gatsby-plugin-google-analytics | Pelacakan situs dengan Google Analytics |
Instal starter ini dengan menjalankan
gatsby new try-ghost https://github.com/styxlab/gatsby-starter-try-ghost
Ubah direktori
cd try-ghost
Berlari
yarn develop
dan kunjungi situs Anda di http://localhost:8000
.
//siteConfig.js
module . exports = {
// Do not include a trailing slash!
siteUrl : `https://your-blog.com` ,
// Maximum number of post shown per page
// Infinite Scroll: Initial chunk of posts, subsequent posts are fetched one by one
postsPerPage : 3 ,
// This allows an alternative site title for meta data for pages.
siteTitleMeta : `Gatsby Starter Ghost CMS` ,
// This allows an site description for meta data for pages.
siteDescriptionMeta : `Turn your Ghost blog into a flaring fast static site with Gatsby` ,
// Used for App and Offline manifest e.g. Mobile Home Screen
shortTitle : `Ghost` ,
siteIcon : `favicon.png` ,
backgroundColor : `#e9e9e9` ,
themeColor : `#15171A` ,
// Include Gatsby images for lazy loading and image optimizations (default: true)
gatsbyImages : true ,
// Overwrite navigation menu (default: []), label is case sensitive
// overwriteGhostNavigation: [{ label: `Home`, url: `/` }],
} ;
Dalam konfigurasi yang ditunjukkan di atas, kolom terpenting yang harus diubah adalah siteUrl
, siteTitleMeta
dan siteDescriptionMeta
. Perbarui setidaknya yang sesuai dengan kebutuhan Anda.
Semua konten bersumber dari Ghost CMS. Secara default, konten diambil dari lokasi demo di https://cms.gotsby.org
. Tentunya Anda ingin mencari sumber konten Anda sendiri. Ada dua cara untuk membuat kunci konten Anda tersedia. Pilih metode sesuai dengan skenario pembangunan Anda.
Jika Anda membangun proyek Anda dengan penyedia cloud (misalnya Gatsby, Netlify, Vercel), opsi terbaik adalah menyediakan kunci dengan variabel lingkungan:
Kunci | Nilai (contoh) |
---|---|
GHOST_API_URL | http://localhost:2368 |
GHOST_CONTENT_API_KEY | 9fccdb0e4ea5b572e2e5b92942 |
Tempat di mana Anda dapat menentukannya bergantung pada penyedia, tetapi Anda biasanya menemukan opsi di bawah pengaturan situs. Ini menghindari penerbitan kunci di repositori publik dan paling aman.
Jika Anda membangun secara lokal atau di jaringan pribadi yang direktori pembangunannya tidak dapat diakses oleh seluruh dunia, Anda dapat dengan aman menambahkan file .ghost.json
baru di direktori dasar Anda dengan struktur JSON berikut:
{
" development " : {
" apiUrl " : " http://localhost:2368 " ,
" contentApiKey " : " 9fccdb0e4ea5b572e2e5b92942 "
},
" production " : {
" apiUrl " : " http://localhost:2368 " ,
" contentApiKey " : " 9fccdb0e4ea5b572e2e5b92942 "
}
}
File ini adalah bagian dari .gitignore
untuk menghindari penerbitannya secara tidak sengaja ke repositori publik Anda. Ubah apiUrl
dan contentApiKey
agar sesuai dengan kunci Ghost CMS Content API Anda sendiri.
Untuk hasil SEO terbaik, sangat disarankan untuk menonaktifkan front-end tema Ghost Handlebars default dengan memilih tanda Jadikan situs ini pribadi dalam pengaturan admin 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 resmi untuk mesin pencari.
Disarankan untuk menginstal npm-upgrade dengan sudo npm install npm-upgrade -g
. Ubah ke direktori dasar dan perbarui semua paket dengan:
npm-upgrade
Anda akan diminta untuk memperbarui semua paket dalam file package.json
Anda. Selanjutnya, unduh paket baru:
yarn
yarn clean
Proses pembaruan kini selesai dan Anda dapat memulai pembangunan baru dengan yarn build
(atau yarn develop
).
Silakan laporkan semua bug dan masalah di gatsby-theme-try-ghost/issues karena semua pengembangan sedang dilakukan di sana.
Proyek ini tidak berafiliasi dengan Gatsby atau Ghost.
Hak Cipta (c) styxlab 2020 - Dirilis di bawah lisensi MIT.