blog doc space
v5.4.1
Node.js CMS & SSG paling sederhana!
Api kecil dalam kegelapan kesalahan ...
Penting
Dokumentasi ini tidak lagi mewakili beragam fitur Blog-Doc. Mohon berkonsultasi dengan dokumentasi komprehensif untuk informasi terkini tentang fungsionalitas blog-Doc.
Untuk menginstal Blog-Doc di ruang, buka halaman instalasi dan klik tombol Install App .
Setelah diinstal, buka aplikasi dari cakrawala Anda atau dengan mengakses instance Builder dari aplikasi dan mengklik tombol Open Builder Instance .
Anda akan dialihkan ke alamat aplikasi dan melihat di browser Anda pesan berikut: Route Not Found .
Tolong jangan panik! Saya sudah mencoba beberapa cara lain, tetapi ini adalah yang paling sederhana dan paling aman.
Sekarang dengan asumsi bahwa instance blog-doc Anda memiliki alamat berikut:
https://abc-1-x234.deta.app , di bilah alamat browser Anda.
Tambahkan setelahnya /admin-blog-doc-config , alamatnya sekarang:
https://abc-1-x234.deta.app/admin-blog-doc-config , hit enter.
Anda akan dialihkan ke halaman yang akan memandu Anda untuk mengatur konfigurasi utama untuk mulai menggunakan Blog-Doc, 2 langkah mudah 2 menit.
Pada akhirnya Anda akan mengirimkan formulir, dibutuhkan paling banyak 30 detik untuk mengunggah konfigurasi, maka Anda akan dialihkan ke alamat awal https://abc-1-x234.deta.app dan lihat sekali lagi: Route Not Found .
Sekali lagi jangan panik! Cukup tambahkan `/halaman/dokumentasi`` setelah alamat. Jelajahi di dalam aplikasi selama satu menit (waktu untuk kode untuk berinteraksi dengan drive yang baru dibuat) tanpa mengunjungi rute rumah, lalu pergi ke rute utama dan mulai menggunakan instance blog-doc Anda sendiri?
Jika tidak berhasil dari pertama kali melakukannya lagi sekali lagi dan itu akan terjadi.
siteURL sebelum menggunakan aplikasi.
NOTA BENE: URL LANGSUNG HARUS AKHIR DENGAN SLASH /
Tentu saja, Anda juga harus memodifikasi siteTitle , siteDescription dan rssCopyright di halaman Pengaturan.
Anda harus mengganti nilai siteTitle , siteDescription dan rssCopyright dengan nilai situs Anda.
Anda dapat mengganti nilai rssSiteLanguage dengan bahasa situs Anda.
Daftar kode bahasa yang tersedia dapat ditemukan di halaman kode bahasa RSS.
⬆️ Kembali ke fitur
Seperti umpan RSS, Anda harus menyediakan URL langsung dari situs Anda di halaman Pengaturan dengan memodifikasi nilai siteURL untuk menghasilkan tautan yang benar untuk setiap halaman, posting, tag, dan templat serta untuk rute blog.
Harap diingat bahwa URL situs harus diakhiri dengan slash /
Anda dapat memeriksa situs situs Anda di bawah rute /sitemap .
⬆️ Kembali ke fitur
Blog-Doc memiliki fitur pencarian bawaan.
Fungsi pencarian memungkinkan pengguna untuk melakukan penelitian tentang judul dan isi posting.
Anda dapat memeriksa pencarian situs Anda di bawah rute /search .
Anda dapat menonaktifkan pencarian di aplikasi Node.js serta untuk situs statis yang dihasilkan dengan memberikan searchFeature nilai false di halaman Pengaturan Situs.
⬆️ Kembali ke fitur
Blog-Doc menggunakan sorotan.js untuk menyoroti blok kode .
Untuk menulis kode inline , kelilingi kode Anda dengan backticks `` .
Untuk menyorotnya, berikan bahasa untuk kode inline dengan menempatkan setelahnya mergigit dengan alias bahasa kode.
Contoh -contoh berikut akan memberi Anda ide yang lebih baik.
Dengan asumsi garis css ini p : color { red } , untuk menyorotnya Anda akan menulis `p { color: red }`{language=css} .
Kode ini dikelilingi dengan backtick `` dan diikuti oleh {language=alias of code language} .
Untuk menulis blok kode , kelilingi blok Anda dengan sepasang 3 backtick ``` .
Untuk menyorotnya, berikan alias bahasa untuk blok tepat setelah 3 backtick pertama.
Kami akan mengambil contoh sebelumnya dan menyorotnya sebagai blok:
```css
p { color: red }
```
Kami akan mendapatkan output berikut:
p {
color : red;
}Kunjungi bahasa yang didukung dari sorotan.js untuk mendapatkan alias yang benar jika Anda tidak yakin.
Atau, Anda dapat menulis blok kode tanpa menyediakan alias, sorotan.js akan secara otomatis mendeteksi bahasa.
Jika stabilo gagal mendeteksi bahasa yang benar untuk blok kode tanpa alias, cukup tambahkan bahasa yang diinginkan ke blok seperti yang ditunjukkan di atas.
⬆️ Kembali ke fitur
Menambahkan atribut id ke tag heading, H2 hingga H4 saja, adalah fitur aktif opsional secara default.
Fitur ini dibangun dengan casing tepi dan mengetik dalam pikiran:
Untuk menambahkan id , tambahkan kawat gigi keriting dengan tagar diikuti oleh teks ID.
Contoh -contoh berikut akan memberi Anda ide yang lebih baik:
<!-- Heading tags with an id property -->
## My awesome H2 title {# my-awesome-h2-title}
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >
### My awesome H3 title {# my awesome h3 title}
The HTML output will be : < h3 id = " my-awesome-h3-title " >My awesome H3 title</ h3 >
#### My awesome H4 title {# My awesome H4 title}
The HTML output will be : < h4 id = " my-awesome-h4-title " >My awesome H4 title</ h4 > Setiap whitespace secara otomatis digantikan oleh tanda hubung dan sejumlah tanda hubung berturut -turut digantikan oleh satu tanda hubung saja.
Sejumlah tanda hubung di awal atau akhir teks ID dihapus sehingga berikut ini juga valid:
## My awesome H2 title { # ----- My ----- aWEsOMe ----- h2 ----- tITlE ----- }
Whatever the number of whitespace characters / hyphens is at the beginning,
between the words or at the end, the HTML output will still be :
< h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >Apa pun sebelum tagar terakhir diabaikan dan karakter khusus dalam teks ID juga diabaikan:
## My awesome H2 title { /!@# a comment ?%^& # -my= awesome+ h2 ( title ) | }
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >& will be parsed to amp (ampersand)
" will be parsed to quot (quotation)
> will be parsed to gt (greater then)
< will be parsed to lt (less then)Sebagai contoh:
## Honey & Bees {#Honey & Bees}
The HTML output will be : < h2 id = " honey-amp-bees " >Honey & Bees</ h2 > Jika Anda ingin menonaktifkan fitur ini, atur nilai addIdsToHeadings ke false di halaman Pengaturan Situs.
⬆️ Kembali ke fitur
Karena Blog-Doc berubah menjadi CMS, saya telah berencana untuk menambahkan galeri dan cara untuk mengambil gambar untuk halaman dan posting secara langsung.
Sekarang hampir selesai. Hampir, karena selalu ada ruang untuk membawa perbaikan.
Untuk saat ini, Anda dapat mengunjungi galeri dengan memukul rute /admin/gallery/images , atau pergi ke halaman administrasi dan klik tautan galeri di menu atau kartu itu.
Dalam semangat global Blog-Doc, dapurnya cukup mudah digunakan.
Anda akan menemukan zona drop di mana Anda dapat menjatuhkan gambar Anda atau mengkliknya dan memilih gambar yang ingin Anda unggah.
Anda juga dapat menghapus gambar dari galeri dengan mengklik tombolnya ✘ Hapus .
Terakhir, untuk menetapkan gambar ke halaman atau posting, Anda dapat, saat membuat atau memperbarui, memilih gambar dari galeri dengan memilihnya langsung dari halaman atau posting.
⬆️ Kembali ke fitur
(segera hadir di luar angkasa)
Anda dapat beralih di antara tema dan memilih desain yang sesuai dengan kebutuhan Anda.
Blog-Doc hadir dengan:
Jika sebuah gambar bernilai ribuan kata, sebuah video bernilai satu juta!
Video 30 detik yang menunjukkan kemampuan untuk secara instan mengubah tampilan dan nuansa situs Anda dengan Blog-Doc.
Saya akan menambahkan lebih banyak tema ke Blog-Doc dari waktu ke waktu.
Jika Anda telah mengkodekan tema untuk Blog-Doc dan ingin mencantumkannya di antara tema yang tersedia, Anda dapat memberi tahu saya dalam diskusi repositori Blog-Doc di bawah kategori Ide.
Harap diingat bahwa tema blog-doc hanya harus menggunakan JavaScript biasa dan tidak dapat berisi kode atau gambar apa pun yang memiliki pembatasan penerbitan dan/atau distribusi!
⬆️ Kembali ke fitur
Dengan segala hormat terhadap waktu dan kerja keras dari setiap pengembang yang membuat generator situs statis dengan Node.js, termasuk versi blog-doc sebelumnya , itu adalah Gasworks!
Saya menawarkan permintaan maaf saya yang tulus sebelumnya kepada masing -masing pengembang ini, tetapi sebuah aplikasi tidak seharusnya menjadi pekerjaan gas ...
Meskipun posting berikut tidak lebih relevan dengan versi sebenarnya dari Blog-Doc, mereka menjelaskan dengan cukup baik motivasi saya dan mungkin mengejutkan Anda.
Silakan baca dari 145 hingga 7?
Baca juga Doc Blog baru
Baca juga node_modules tidak berat, pengembang malas!
Blog-Doc for Space sekarang hanya menggunakan 14 modul (1916.1 kb atau 1.9161 MB) bukan 131 (10082 kb atau 10.082 MB)!
Buka halaman Isu-isu Ruang Blog-Doc di GitHub dan buat masalah baru dengan menjelaskan sebanyak mungkin masalah yang Anda hadapi.
Pergi ke ide-ide ruang Blog-Doc di GitHub dan ceritakan tentang hal itu.
Termasuk SSG di Blog-Doc on Space membutuhkan beberapa modifikasi arsitektur.
Saya akan mempertimbangkan nanti untuk memasukkan SSG atau tidak tergantung pada penggunaan dan persyaratan Blog-Doc.
Harap baca bagian instalasi.
Saya bermaksud membuat banyak perbaikan pada aplikasi ini dalam waktu luang saya yang singkat.
Anda dapat menggunakan blog-doc sebagai prototipe dan memodifikasinya sepenuhnya untuk menggunakannya dengan desain lain dan/atau bahasa templat lain.
Saya benar -benar berharap bahwa aplikasi ini akan berguna dengan cara apa pun bagi banyak orang di luar sana, saya menganggapnya sebagai kontribusi pribadi saya ke komunitas node.js dan penurunan harga.
Gagasan, komentar, dan saran paling disambut.
Sya, Lebcit
Dibangun dengan ❤️ oleh lebcit
