GitBook, γράψτε τεκμηρίωση για τα έργα σας από το Ubuntu

Στο επόμενο άρθρο θα ρίξουμε μια ματιά στο GitBook. Αυτό είναι ένα εφαρμογή GUI πολλαπλών πλατφορμών, του οποίου η κύρια λειτουργία είναι να φέρει τη ροή εργασίας του GitBook στην επιφάνεια εργασίας μας στο Ubuntu. Ρίξτε μια ματιά στη διεπαφή του, μπορείτε να δείτε ότι είναι καλά σχεδιασμένο για επεξεργασία κειμένου και εργασία με τη ζωντανή προεπισκόπηση του έργου.

Το GitBook δημιουργήθηκε στα μέσα του 2014. Γεννήθηκε με σκοπό να δημιουργήσει ένα Σύγχρονη και απλή λύση για τη δημιουργία εγγράφων, την ψηφιακή γραφή και τη δημοσίευση περιεχομένου. Η φιλοσοφία του έργου είναι να είναι απλή χωρίς να χάνει το σημείο κομψότητας. Οι περισπασμοί και οι ανησυχίες για τους δημιουργούς περιεχομένου εξαλείφονται, ώστε να μπορούν να γράφουν ελεύθερα.

Εκατοντάδες χιλιάδες χρήστες χρησιμοποιούν το GitBook γράψτε τεκμηρίωση (βιβλιοθήκη, API, εργαλεία κ.λπ.) ή βάσεις γνώσεων (όπως συχνές ερωτήσεις). Οι άνθρωποι χρησιμοποιούν επίσης αυτό το πρόγραμμα για να δημοσιεύσουν τεχνικά βιβλία, διδακτικό υλικό και πολλά άλλα πράγματα.

Γενικές δυνατότητες του GitBook

Αυτό είναι ένα διαδικτυακή πλατφόρμα γραφής και φιλοξενίας τεκμηρίωσης. Παρέχει μορφή βιβλίου ανοιχτού κώδικα και αλυσίδες εργαλείων.

Αυτό το πρόγραμμα θα μας προσφέρει ενσωματωμένα χειριστήρια Git. Θα έχουμε επίσης στη διάθεσή μας έναν πίνακα πίνακα περιεχομένων, έναν πίνακα δέντρων αρχείων και κουμπιά γρήγορης μορφής για να διευκολύνουμε τη δομή των εγγράφων μας.

Επιπλέον, το GitBook μας προσφέρει τη δυνατότητα εμφανίστε το περιεχόμενό μας ως ιστότοπο (προσαρμόσιμο και επεκτάσιμο) ή σαν ένα ebook (PDF, ePub ή Mobi).

Το GitBook.com είναι η διαδικτυακή πλατφόρμα δημιουργίας και φιλοξενίας βιβλίων που έχουν δημιουργηθεί με τη μορφή εφαρμογής. Προσφέρει φιλοξενία, δυνατότητες συνεργασίας και έναν εύχρηστο επεξεργαστή. Αυτό το πρόγραμμα μας επιτρέπει να χρησιμοποιήσουμε την ομάδα μας για να δημιουργήσουμε τοπικά βιβλία, στο GitHub ή στην πλατφόρμα για να τα φιλοξενήσουμε.

Για να ξεκινήσετε να χρησιμοποιείτε αυτό το πρόγραμμα, οι δημιουργοί παρέχουν στους χρήστες τη δυνατότητα να συμβουλευτούν το Οδηγίες Εγκατάστασης στην τεκμηρίωση. Εάν κάποιος χρήστης το θέλει ή το χρειάζεται, μπορεί να συμβουλευτεί τον πηγαίο κώδικα αυτής της εφαρμογής στη σελίδα του GitHub αυτής της εφαρμογής.

Εγκατάσταση GitBook

Εάν θέλετε να κάνετε λήψη του πακέτου προγράμματος, μπορείτε να το κατεβάσετε από το Επίσημη Ιστοσελίδα. Εκεί μπορούμε κατεβάστε το χρησιμοποιώντας το πρόγραμμα περιήγησης. Μπορούμε επίσης να πάρουμε το πακέτο χρησιμοποιώντας το wget εντολή ανοίγοντας ένα τερματικό (Ctrl + Alt + T) και πληκτρολογώντας σε αυτό τα εξής:

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

Μετά τη λήψη του πακέτου, μπορούμε να το εγκαταστήσουμε εκτελώντας την ακόλουθη εντολή στο ίδιο τερματικό:

dpkg -i linux-64-bit

Μετά την ολοκλήρωση της εγκατάστασης, θα μπορείτε να χρησιμοποιήσετε το πεδίο αναζήτησης του Ubuntu Dash και να πληκτρολογήσετε gitbook. Το εικονίδιο της εφαρμογής θα εμφανιστεί στην οθόνη.

Όταν έχουμε συνδεθεί, είτε με ένα Λογαριασμός GitBook ή με τον λογαριασμό κοινωνικών μέσων, μπορούμε τώρα να δημιουργήσουμε ένα νέο βιβλίο. Μπορούμε να το κάνουμε κάνοντας κλικ στην επιλογή Νέο βιβλίο που είναι διαθέσιμη στην οθόνη.

Τώρα μπορείτε να ξεκινήσετε γράψτε το δικό σας βιβλίο στο πρόγραμμα επεξεργασίας. Μην ξεχάσετε να επιλέξετε στον επεξεργαστή το αποθετήριο στο οποίο θέλουμε να ανεβάσετε τις αλλαγές.

Πώς να συγχρονίσετε το Gitbook με το Github;

Κάτι πολύ ενδιαφέρον για αυτό το πρόγραμμα είναι ότι μας προσφέρει τη δυνατότητα συνεργασίας με το GitHub. Έχω διαβάσει ότι για μερικούς ανθρώπους αυτό ήταν πρόβλημα συγχρονίστε ένα αποθετήριο Github με την πλατφόρμα GitBook.

Το πρώτο πράγμα που θα πρέπει να κάνουμε είναι δημιουργήστε ένα δημόσιο αποθετήριο στο Github. Θα χρειαζόμαστε επίσης δημιουργήστε ένα βιβλίο στον Ιστό του Gitbook. Συνιστάται, αν και πιστεύω ότι δεν είναι απαραίτητο και τα δύο αποθετήρια να έχουν το ίδιο όνομα.

Μόλις δημιουργηθεί το βιβλίο, είναι σημαντικό να αποκτήσετε πρόσβαση στο Εργαλεία ρύθμισης βιβλίων και μεταβείτε στην ενότητα Github. Μόλις μπείτε μέσα, θα προχωρήσετε στο επιλέξτε ενοποίηση με το αποθετήριο GitHub με το οποίο θέλετε να συγχρονίσετε. Μόλις επιλεγεί το αποθετήριο, θα συνεχίσουμε να αποδεχόμαστε και να αποθηκεύουμε ολόκληρη τη διαδικασία.

Μόλις πραγματοποιηθεί αυτή η λειτουργία, εάν όλα πάνε καλά, θα πρέπει να εμφανιστεί ένα πράσινο μήνυμα που να δείχνει ότι το ενσωμάτωση με το Github δουλεύει.

Για να ελέγξετε ότι όλα λειτουργούν. Τώρα θα ξεκινήσουμε τη συνεδρία με τον πελάτη GitBook που έχουμε εγκαταστήσει στο Ubuntu. Όταν ξεκινά, μπορούμε να κάνουμε τις αλλαγές που θεωρούμε σχετικές. Τώρα μπορούμε να τα ανεβάσουμε στο νέο μας Αποθήκη GitHub.