GitBook, kirjutage oma projektide dokumentatsioon Ubuntu kaudu

Järgmises artiklis heidame pilgu GitBookile. See on üks platvormidevaheline GUI rakendus, mille põhiülesanne on tuua GitBooki töövoog meie Ubuntu töölauale. Vaadates selle liidest, näete, et see on teksti redigeerimiseks ja projekti reaalajas eelvaate töötamiseks hästi läbi mõeldud.

GitBook loodi 2014. aasta keskel. See sündis a Kaasaegne ja lihtne lahendus dokumentide loomiseks, digitaalseks kirjutamiseks ja sisu avaldamiseks. Projekti filosoofia on olla lihtne, kaotamata elegantsi. Sisu loojate tähelepanu hajumine ja mured on välistatud, nii et nad saavad kirjutada vabalt.

GitBooki kasutavad sajad tuhanded kasutajad kirjutada dokumentatsiooni (teek, API, tööriistad jne) või teadmistebaase (näiteks KKK-sid). Inimesed kasutavad seda programmi ka tehniliste raamatute, õppematerjalide ja paljude muude asjade avaldamiseks.

GitBooki üldised omadused

See on veebiplatvorm dokumentatsiooni kirjutamiseks ja majutamiseks. See pakub avatud lähtekoodiga raamatu vormingut ja tööriistakette.

See programm pakub meile sisseehitatud Git-juhtelemendid. Samuti on meie käsutuses sisukorra paneel, failipuu paneel ja kiirvormindamise nupud, et hõlbustada meie dokumentide struktureerimist.

Lisaks pakub GitBook meile võimalust kuvada meie sisu veebisaidina (kohandatav ja laiendatav) või nagu e-raamat (PDF, ePub või Mobi).

GitBook.com on veebiplatvorm rakendusevormingus loodud raamatute loomiseks ja majutamiseks. Pakub hostimist, koostööfunktsioone ja hõlpsasti kasutatavat redaktorit. See programm võimaldab meil kasutada oma meeskonda kohalike raamatute loomiseks GitHubis või nende võõrustamiseks mõeldud platvormil.

Selle programmi kasutamiseks alustavad loojad kasutajatele kättesaadavaks võimaluse programmiga tutvuda paigaldusjuhised dokumentatsioonis. Kui keegi seda soovib või vajab, saab ta selle rakenduse lähtekoodiga tutvuda lehel GitHub sellest rakendusest.

GitBooki installimine

Kui soovite programmipaketi alla laadida, saate selle alla laadida oma saidilt Ametlik kodulehekülg. Seal me saame laadige see brauseri abil alla. Paketi saame ka kasutades wget käsk terminali avamine (Ctrl + Alt + T) ja selle sisestamine järgmiselt:

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

Kui pakett on alla laaditud, saame selle installida, käivitades samas terminalis järgmise käsu:

dpkg -i linux-64-bit

Pärast installi lõpetamist saate kasutada Ubuntu Dashi otsinguvälja ja tippida gitbook. Ekraanile kuvatakse rakenduse ikoon.

Kui oleme sisse loginud, kas a-ga GitBooki konto või meie sotsiaalmeedia kontoga, saame nüüd luua uue raamatu. Saame seda teha, klõpsates ekraanil oleval valikul Uus raamat.

Nüüd võite alustada kirjutage redaktoris oma raamat. Ärge unustage redaktoris valida hoidla, kuhu soovime muudatused üles laadida.

Kuidas Gitbooki Githubiga sünkroonida?

Selle programmi juures on väga huvitav see, et see pakub meile võimalust töötada koos GitHubiga. Olen lugenud, et mõnele inimesele on see probleem olnud sünkroonige Githubi hoidla GitBooki platvormiga.

Esimene asi, mida peame tegema, on luua Githubis avalik hoidla. Me vajame ka luua raamat Gitbooki veebis. See on soovitatav, kuigi arvan, et pole hädavajalik, et mõlemal hoidlal oleks sama nimi.

Kui raamat on loodud, on oluline sellele juurdepääs Broneerige tööriistad ja minge jaotisse Github. Kui olete sees, jätkate valige integreerimine GitHubi hoidlaga millega soovite sünkroonida. Kui hoidla on valitud, jätkame kogu protsessi aktsepteerimist ja salvestamist.

Kui see toiming on läbi viidud, peaks kõik minema hästi, kui ilmub roheline teade, mis näitab, et integratsioon Githubiga see töötab.

Kontrollimaks, kas kõik töötab. Nüüd alustame seanssi GitBooki kliendiga, mille oleme oma Ubuntu installinud. Kui see algab, saame teha muudatusi, mida peame asjakohaseks. Nüüd saame need üles laadida meie äsja loodud GitHubi hoidla.