GitBook, Markdown ve AsciiDoc sözdizimi formatlarını destekleyen Node.js tabanlı bir komut satırı aracıdır ve e-kitapları HTML, PDF, eBook ve diğer formatlarda çıkarabiliyor.
Kurulum node.js
Gitbook aracını kullanmadan önce bilgisayarın node.js ortamı yüklemesi gerekir ve kurulumdan sonra sürüm komutunu kontrol ederek kurulumun başarılı olup olmadığını kontrol edebilirsiniz:
Gitbook'u Yükle
Gitbook npm ile kurulu, komut satırı:
Kurulumun başarılı olup olmadığını doğrulamak için aşağıdaki komutu çalıştırarak GitBook sürümünü izleyin.
Tarihsel sürümleri kur
gitbook-cli, kitaplarınızı test etmek için diğer GitBook sürümlerini indirip yüklemeyi kolaylaştırır:
Gitbook ls-remote kullanılarak indirilebilecek sürümler sıralanır.
Markdown editörü
Burada belgelerimiz için yazı dili olarak Markdown sözdizimini kullanıyoruz, bir Markdown editörü hazırlamamız gerekiyor, piyasada Typora, MacDown, Bear, MarkdownPad, MarkdownX, JetBrains'in IDE'si (eklenti kurulumu gerekiyor), Atom, Jianshu, CSDN ve GitBook'un kendi editörü gibi birçok Markdown editörü bulabiliyoruz GitBook Editor ve benzeri.
Bilgisayarımda VS kod geliştirme araçları yüklü, VS kod varsayılan olarak markdown'u destekliyor, sadece bir önizleme eklentisi artefaktı kurmam gerekiyor: Markdown Preview Enhanced, ve onu kullanacağım!
Arkadaşlar tarafından tavsiye edildi Editör typora, adres:Bağlantı girişi görünür.
Bir kitabı başlatın
GitBook bir standart plaka oluşturabilir:
Yeni bir dizine kitap oluşturmak istiyorsanız, gitbook init ./directory çalıştırarak bunu yapabilirsiniz.
Uygulamadan sonra, şu işlemleri yapan iki dosya daha göreceksiniz - README.md ve SUMMARY.md:
README.md - Kitabın girişi bu belgede yazılmıştır
SUMMARY.md - Kitabın katalog yapısı burada yapılandırılmıştır
Markdown sözdizimi konusunda bilgim yok, bu yüzden sadece birkaç cümle yaz!
Statik web sayfaları oluşturun
Statik web sayfaları oluşturun ve sunucuları çalıştırın
Yukarıdakilerin hepsi kitap kataloğunda _book oluşturulacaktır.
Servet komutu ayrıca portu da belirtebilir:
Oluştururken gitbook'un sürümünü belirtin, önce yerel olarak indirilmez
Tüm yerel gitbook sürümlerini listeler
Uzaktan erişilebilir gitbook sürümlerini listeleyin
İlgili gitbook sürümünü kur
Gitbook'un en son sürümüne güncelleme
İlgili gitbook sürümünü kaldır
Log seviyesini belirtir
Çıkış hata mesajı
Özet
GitBook, kitabın bölümlerinin ve alt bölümlerinin yapısını tanımlamak için SUMMARY.md dosyalar kullanır. SUMMARY.md Dosyası, kitabın içeriğini oluşturmak için kullanılır.
SUMMARY.md formatı bir bağlantı listesidir. Bağlantının başlığı bölümün başlığı olarak hizmet eder ve bağlantı o bölüm dosyasına giden yola hedeflenir.
Ana bölüme iç içe bir liste eklemek bir alt bölüm oluşturur.
Basit bir örnek:
Sonra tekrar komut satırına dönüp mybook klasöründe gitbook init komutunu tekrar çalıştırıyoruz. GitBook, SUMMARY.md dosyalarında tanımlanan dizinleri ve dosyaları arar,Eğer yoksa, oluşturulur。
PDF, ePub veya mobi dosyalarını çıktı
Pdf versiyonu oluşturmak istiyorsanız, gitbook pdf'yi çalıştırabilirsiniz, tıpkı epub formatı dışa aktarıyorsanız gitbook epub'u çalıştırabilirsiniz, mobi formatı ise gitbook mobi yeterli olur.
Bir e-kitabı PDF, ePub veya mobi formatında dışa aktarmak istiyorsanız,Calibre eBook Reader/Manager ve komut satırı araçları gerektiriraksi takdirde "EbookError: Error during ebook generation: 'ebook-convert'" şeklinde bir hata bildirilebilir.
GitBook Özel Dosyalarının Özellikleri:
dosya | Açıklama | | book.json | Yapılandırma Verileri (isteğe bağlı) | | README.md | E-Kitap'a önsöz veya giriş (zorunlu) | | SUMMARY.md | E-kitap kataloğu (isteğe bağlı) | | GLOSSARY.md | Kelime dağarcığı/açıklama terimleri listesi (isteğe bağlı) |
Gitbook Genel Ayarları
GitBook, e-kitabınızı esnek yapılandırmalarla özelleştirmenize olanak tanıyor.
Bu seçenekler book.json dosyasında belirtilmiştir. JSON sözdizimine aşina olmayan yazarlar için, JSONlint gibi araçlarla sözdizimini doğrulayabilirsiniz.
değişken | Açıklama | | kök | Tüm kitap dosyalarını içeren kök klasöre giden yol, hariç book.json | | Yapı | Readme, özetler, sözlükler vb. için yollar belirtin | | Başlık | Kitabınızın başlığı, varsayılan değer README'den çıkarılır. GitBook.com bu alan önceden doldurulmuştur. | | descrip{filter}tion | Kitabınızın tanımı, varsayılan değer README'den çıkarılır. GitBook.com bu alan önceden doldurulmuştur. | | Yazar | Yazarın adı. GitBook.com bu alan önceden doldurulmuştur. | | ISBN | ISBN | | Dil | Bu kitabın dil türü ISO kodudur. Varsayılan değer en'dir. | | Yönetmenlik | Metin okuma sırası. RTL (sağdan sola) veya LTR (soldan sağa) olabilir ve varsayılan değer dilin değerine bağlıdır. | | gitbook | GitBook versiyonu kullanılmalı. SemVer spesifikasyonunu kullanın ve "> = 3.0.0" gibi koşulları kabul edin. |
|
Yayınlandı 23.11.2018 14:03:54
|
|
|
|
