GitBook adalah alat baris perintah berbasis Node.js yang mendukung format sintaks Markdown dan AsciiDoc, dan dapat menghasilkan eBook dalam format HTML, PDF, eBook, dan format lainnya.
Instal node.js
Sebelum menggunakan alat gitbook, komputer perlu menginstal lingkungan node.js, dan setelah instalasi, Anda dapat memeriksa perintah versi untuk menguji apakah penginstalan berhasil:
Instal Gitbook
Gitbook diinstal dengan npm, baris perintah:
Jalankan perintah di bawah ini untuk melihat versi GitBook untuk memverifikasi bahwa penginstalan berhasil.
Menginstal versi historis
gitbook-cli memudahkan untuk mengunduh dan menginstal versi GitBook lainnya untuk menguji buku Anda:
Menggunakan gitbook ls-remote menghitung versi yang dapat diunduh.
Editor penurunan harga
Di sini kita menggunakan sintaks Markdown sebagai bahasa penulisan untuk dokumen kita, kita perlu menyiapkan editor Markdown, kita dapat menemukan banyak editor Markdown di pasaran, seperti Typora, MacDown, Bear, MarkdownPad, MarkdownX, IDE JetBrains (memerlukan instalasi plugin), Atom, Jianshu, CSDN dan GitBook sendiri Editor GitBook dan sebagainya.
Saya memiliki alat pengembangan kode VS yang diinstal di komputer saya, vs kode mendukung penurunan harga secara default, saya hanya perlu menginstal artefak plugin pratinjau: Pratinjau Markdown Ditingkatkan, dan saya akan menggunakannya!
Direkomendasikan oleh teman Editor typora, alamat:Login hyperlink terlihat.
Menginisialisasi buku
GitBook dapat mengatur boilerplate:
Jika Anda ingin membuat buku ke direktori baru, Anda dapat melakukannya dengan menjalankan gitbook init ./directory.
Setelah eksekusi, Anda akan melihat dua file lagi - README.md dan SUMMARY.md, yang melakukan hal berikut:
README.md - Pengantar buku ini ditulis dalam dokumen ini
SUMMARY.md - Struktur katalog buku dikonfigurasi di sini
Saya tidak terbiasa dengan sintaks penurunan harga, jadi tulis saja beberapa kalimat!
Hasilkan halaman web statis
Hasilkan halaman web statis dan jalankan server
Semua hal di atas akan dihasilkan dalam katalog buku _book.
Perintah serve juga dapat menentukan port:
Saat membuat, tentukan versi gitbook, dan itu tidak akan diunduh secara lokal terlebih dahulu
Mencantumkan semua versi gitbook lokal
Mencantumkan versi gitbook yang tersedia dari jarak jauh
Instal versi gitbook yang sesuai
Perbarui ke gitbook versi terbaru
Copot pemasangan versi gitbook yang sesuai
Menentukan tingkat log
Pesan kesalahan keluaran
Ringkasan
GitBook menggunakan file SUMMARY.md untuk menentukan struktur bab dan subbab buku. SUMMARY.md File digunakan untuk menghasilkan daftar isi buku.
Format SUMMARY.md adalah daftar tautan. Judul tautan akan berfungsi sebagai judul bab, dan tautan akan ditargetkan ke jalur ke file bab tersebut.
Menambahkan daftar berlapis ke bab induk membuat bab turunan.
Contoh sederhana:
Kemudian kita kembali ke baris perintah dan jalankan perintah gitbook init lagi di folder mybook. GitBook mencari direktori dan file yang dijelaskan dalam file SUMMARY.md,Jika tidak, itu dibuat。
Keluarkan file PDF, ePub, atau mobi
Jika Anda ingin membuat versi pdf, Anda dapat menjalankan gitbook pdf, dengan cara yang sama, jika Anda mengekspor format epub, gitbook epub, jika itu adalah format mobi, gitbook mobi akan dilakukan.
Jika Anda ingin mengekspor e-book dalam format PDF, ePub atau mobi,Memerlukan Calibre eBook Reader/Manager dan alat baris perintah, jika tidak, kesalahan dapat dilaporkan "EbookError: Error selama pembuatan ebook: 'ebook-convert'".
Fitur File Khusus GitBook:
berkas | deskripsi | | book.json | Data Konfigurasi (opsional) | | README.md | Kata pengantar atau pengantar eBook (wajib) | | SUMMARY.md | Katalog e-book (opsional) | | GLOSSARY.md | Daftar kosakata/istilah anotasi (opsional) |
Pengaturan Umum Gitbook
GitBook memungkinkan Anda menyesuaikan ebook Anda dengan konfigurasi yang fleksibel.
Opsi ini ditentukan dalam file book.json. Untuk penulis yang tidak terbiasa dengan sintaks JSON, Anda dapat memverifikasi sintaks menggunakan alat seperti JSONlint.
variabel | deskripsi | | akar | Jalur ke folder root yang berisi semua file buku, kecuali book.json | | Struktur | Tentukan jalur untuk readme, abstrak, glosarium, dll | | Judul | Judul buku Anda, nilai default diekstraksi dari README. Pada GitBook.com, bidang ini telah diisi sebelumnya. | | descrip{filter}tion | Deskripsi buku Anda, nilai default diekstraksi dari README. Pada GitBook.com, bidang ini telah diisi sebelumnya. | | penulis | Nama penulis. Pada GitBook.com, bidang ini telah diisi sebelumnya. | | ISBN | ISBN | | Bahasa | Jenis bahasa buku ini adalah kode ISO. Nilai defaultnya adalah en | | arah | Urutan membaca teks. Ini bisa berupa RTL (kanan-ke-kiri) atau LTR (kiri-ke-kanan), dan nilai default tergantung pada nilai bahasa. | | buku gita | Versi GitBook harus digunakan. Gunakan spesifikasi SemVer dan terima kondisi yang mirip dengan "> = 3.0.0". |
|
Diposting pada 23/11/2018 14.03.54
|
|
|
|
