GitBook, tulis dokumentasi untuk projek anda dari Ubuntu

Dalam artikel seterusnya kita akan melihat GitBook. Ini adalah satu aplikasi GUI merentas platform, yang fungsi utamanya adalah membawa aliran kerja GitBook ke desktop kami di Ubuntu. Melihat antara muka, anda dapat melihat bahawa ia difikirkan dengan baik untuk mengedit teks dan bekerja dengan pratonton langsung projek.

GitBook dicipta pada pertengahan tahun 2014. Ia dilahirkan untuk mencipta Penyelesaian moden dan sederhana untuk pembuatan dokumen, penulisan digital dan penerbitan kandungan. Falsafah projek adalah sederhana tanpa kehilangan keanggunan. Gangguan dan kebimbangan untuk pencipta kandungan dihilangkan, sehingga mereka dapat menulis dengan bebas.

Ratusan ribu pengguna menggunakan GitBook untuk tulis dokumentasi (perpustakaan, API, alat, dll.) atau pangkalan pengetahuan (seperti Soalan Lazim). Orang ramai juga menggunakan program ini untuk menerbitkan buku teknikal, bahan pengajaran, dan banyak perkara lain.

Ciri Umum GitBook

Ini adalah satu platform dalam talian untuk menulis dan mengehoskan dokumentasi. Ia menyediakan format buku sumber terbuka dan rantai alat.

Program ini akan menawarkan kepada kami kawalan Git terbina dalam. Kami juga akan menyediakan panel isi kandungan, panel pohon fail dan butang format cepat untuk memudahkan penyusunan dokumen kami.

Di samping itu, GitBook menawarkan kepada kami kemungkinan paparkan kandungan kami sebagai laman web (disesuaikan dan boleh diperluas) atau seperti ebook (PDF, ePub atau Mobi).

GitBook.com adalah platform dalam talian untuk membuat dan menghosting buku yang dibuat dalam format aplikasi. Menawarkan hosting, ciri kolaborasi, dan editor yang mudah digunakan. Program ini membolehkan kami menggunakan pasukan kami untuk membuat buku tempatan, di GitHub atau di platform untuk menjadi tuan rumah mereka.

Untuk mula menggunakan program ini, para pencipta menyediakan kemungkinan kepada pengguna untuk berkonsultasi dengan arahan pemasangan dalam dokumentasi. Sekiranya ada pengguna menginginkan atau memerlukannya, mereka boleh merujuk kod sumber aplikasi ini di halaman GitHub permohonan ini.

Pemasangan GitBook

Sekiranya anda ingin memuat turun pakej program, anda boleh memuat turunnya dari Laman Web Rasmi. Di sana kita boleh memuat turunnya menggunakan penyemak imbas. Kami juga boleh mendapatkan pakej menggunakan perintah wget membuka terminal (Ctrl + Alt + T) dan taipkan perkara berikut di dalamnya:

wget http://downloads.editor.gitbook.com/download/linux-64-bit

Setelah pakej dimuat turun, kami dapat memasangnya dengan menjalankan perintah berikut di terminal yang sama:

dpkg -i linux-64-bit

Setelah selesai pemasangan, anda akan dapat menggunakan medan carian Ubuntu Dash dan menaip gitbook. Ikon aplikasi akan dipaparkan di layar.

Apabila kita telah log masuk, baik dengan a Akaun GitBook atau dengan akaun media sosial kami, kita sekarang boleh membuat Buku baru. Kita boleh melakukannya dengan mengklik pilihan Buku Baru yang terdapat di skrin.

Sekarang anda boleh memulakan tulis Buku anda sendiri di Editor. Jangan lupa memilih di editor repositori tempat kami ingin memuat naik perubahan.

Bagaimana hendak menyegerakkan Gitbook dengan Github?

Sesuatu yang sangat menarik mengenai program ini ialah ia menawarkan kita kemungkinan untuk bekerja dengan GitHub. Saya telah membaca bahawa bagi sesetengah orang ini menjadi masalah segerakkan repositori Github dengan platform GitBook.

Perkara pertama yang harus kita lakukan ialah buat repositori awam di Github. Kami juga akan memerlukan buat buku di laman web Gitbook. Ia disyorkan, walaupun saya rasa tidak penting kedua-dua repositori itu mempunyai nama yang sama.

Setelah buku dibuat, penting untuk mengakses Alat Menetapkan Buku dan pergi ke bahagian Github. Setelah masuk, anda akan terus ke pilih integrasi dengan repositori GitHub dengan yang anda mahu segerakkan. Setelah repositori dipilih, kami akan terus menerima dan menyimpan keseluruhan proses.

Setelah operasi ini dijalankan, jika semuanya berjalan lancar, mesej hijau akan muncul yang menunjukkan bahawa integrasi dengan Github ianya berkesan.

Untuk memastikan semuanya berfungsi. Sekarang kita akan memulakan sesi dengan klien GitBook yang telah kita pasang di Ubuntu kita. Apabila ia bermula, kita dapat membuat perubahan yang kita anggap relevan. Sekarang kita boleh memuat naiknya ke yang baru kita buat Repositori GitHub.