Πώς να εγκαταστήσετε το Raneto στο Ubuntu 17.10

Το Raneto είναι μια δωρεάν και ανοιχτού κώδικα βάση γνώσεων, χτισμένη στο Node.js, η οποία είναι εύκολη στη ρύθμιση και τη χρήση, καθώς και εύκολη στη διαχείριση. Οι κατηγορίες και οι σελίδες είναι γραμμένες σε Markdown, γεγονός που καθιστά εύκολη την επεξεργασία. Εάν το Markdown δεν σας αρέσει, το Raneto σας επιτρέπει επίσης να χρησιμοποιείτε HTML.

Προαπαιτούμενα

• Ένα VPS με εγκατεστημένο το Ubuntu 17.10.
• Πρόσβαση SSH στο VPS σας.
• Βασική κατανόηση του τερματικού Linux.

Σύνδεση

Πρώτα, πρέπει να συνδεθούμε στον διακομιστή μας χρησιμοποιώντας SSH. Για να το κάνετε αυτό, ανοίξτε τον αγαπημένο σας πελάτη SSH.

ssh root@SERVER_IP

Αφού εισαγάγετε τον κωδικό πρόσβασής σας (μπορείτε να τον λάβετε από τον πίνακα ελέγχου Vultr) θα συνδεθείτε στο VPS σας.

Εγκατάσταση Node.js & PM2

Το Raneto εκτελείται στο Node.js, έναν χρόνο εκτέλεσης javascript και ένα πλαίσιο. Σε αυτό το σεμινάριο, θα χρησιμοποιήσουμε το Node.js v8 λόγω της μακροχρόνιας υποστήριξής του. Ξεκινήστε την εγκατάσταση πληκτρολογώντας την παρακάτω εντολή.

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -

Αφού ολοκληρωθεί η εκτέλεση αυτού του σεναρίου, μπορείτε να εκτελέσετε την κύρια εγκατάσταση.

sudo apt-get install -y nodejs

Μόλις ολοκληρωθεί αυτό το πρόγραμμα εγκατάστασης, θα έχετε ένα ενημερωμένο αντίγραφο του Node.js εγκατεστημένο στο VPS σας. Στη συνέχεια, θα εγκαταστήσουμε το PM2, έναν διαχειριστή διεργασιών για το Node.js που διευκολύνει την εκτέλεση του Raneto (και πολλών άλλων εφαρμογών Node.js).

npm install pm2 -g

Έχουμε τώρα όλο το λογισμικό που χρειαζόμαστε για να εγκαταστήσουμε το Raneto.

Εγκατάσταση του Raneto

Θα χρησιμοποιήσουμε το Git για να κλωνοποιήσουμε το αποθετήριο Raneto στον διακομιστή μας.

git clone https://github.com/gilbitron/Raneto.git

Αυτό θα δημιουργήσει έναν φάκελο που ονομάζεται Raneto. Εισαγάγετε το φάκελο.

cd Raneto

Εγκαταστήστε το NPM.

npm install

Εκτελέστε το Gulp πληκτρολογώντας τα παρακάτω.

npm run gulp

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

npm start
# or
npm example/server.js

Τώρα θα μπορείτε να αποκτήσετε πρόσβαση στη νέα σας εγκατάσταση Raneto μεταβαίνοντας στο SERVER_IP:3000. Το υπόλοιπο αυτού του σεμιναρίου θα σας διδάξει πώς να διαμορφώσετε περαιτέρω το Raneto, να δημιουργήσετε νέες σελίδες, να προσθέσετε κατηγορίες, να προσαρμόσετε την ταξινόμηση, να προσθέσετε μια προσαρμοσμένη αρχική σελίδα και να επεξεργαστείτε το πρότυπο.

Περαιτέρω Διαμόρφωση

Τώρα έχετε μια προεπιλεγμένη εγκατάσταση Raneto που φιλοξενείται στο VPS σας. Πριν ξεκινήσετε να κάνετε οτιδήποτε άλλο, προτείνω να κάνετε μερικές αλλαγές στις προεπιλεγμένες ρυθμίσεις και ρυθμίσεις.

Ας ρίξουμε μια ματιά στο config.default.js, το οποίο βρίσκεται στο exampleφάκελο. Αυτό το αρχείο ρυθμίσεων είναι αρκετά μεγάλο, αλλά παρακαλώ μην παραξενεύεστε, καθώς σχολιάζεται έντονα. Εδώ είναι οι ιδιότητες που πρέπει να επεξεργαστείτε:

• site_title - Αλλάξτε το στον τίτλο του ιστότοπού σας.
• base_url- Θα πρέπει να οριστεί στη διεύθυνση URL του ιστότοπού σας. Μπορεί να χρησιμοποιηθεί ως μεταβλητή κατά την επεξεργασία σελίδων.
• support_email- Αλλάξτε το σε έγκυρο email. Θα εμφανίζεται στο υποσέλιδο του ιστότοπου.
• copyright - Κείμενο υποσέλιδου.
• analytics - Προσθέστε έναν κώδικα παρακολούθησης του Google Analytics εδώ.
• allow_editing - Θέλετε να μπορείτε να επεξεργάζεστε αρχεία χρησιμοποιώντας το πρόγραμμα επεξεργασίας ιστού;
• authentication_for_read - Θέλετε να συνδεθούν άτομα για να δουν τον ιστότοπο;
• credentials - Προσθέστε χρήστες εδώ εάν η σύνδεση είναι ενεργοποιημένη.
• locale - Γλώσσα.
• datetime_format - Μορφή ημερομηνίας και ώρας.
• home_meta - Επεξεργαστείτε το για να αλλάξετε τις μετα-πληροφορίες της αρχικής σας σελίδας.
• table_of_content - Πρέπει ο Raneto να εμφανίζει έναν πίνακα περιεχομένων;

Χρήση του Online Editor

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

Μπορείτε να αποκτήσετε πρόσβαση σε αυτό ενεργοποιώντας τη ρύθμιση config.default.js(όπως αναφέρθηκε παραπάνω) και στη συνέχεια επισκεφτείτε το VPS σας και κάνοντας κλικ στο κουμπί σύνδεσης στην επάνω δεξιά γωνία. Εισαγάγετε το όνομα χρήστη και τον κωδικό πρόσβασής σας (μπορείτε να τα αλλάξετε στο config.default.js) και κάντε κλικ στο κουμπί σύνδεσης. Απλώς κάντε κλικ στη σελίδα που θέλετε να επεξεργαστείτε, κάντε κλικ στο Actionsαναπτυσσόμενο μενού και επιλέξτε την ενέργεια που θέλετε να ολοκληρώσετε. Μπορείτε να προσθέσετε σελίδες πατώντας το +κουμπί δίπλα στο όνομα της κατηγορίας και μπορείτε να δημιουργήσετε κατηγορίες χρησιμοποιώντας το πεδίο εισαγωγής στην επάνω αριστερή γωνία.

Προσθήκη σελίδων

Η προσθήκη σελίδων είναι τόσο απλή όσο η δημιουργία ενός νέου .mdεγγράφου Markdown ( ) στον example/contentφάκελο.

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

/*
 Title: Enter your page title here, if none is added, the file-name will be used
 Description: Enter your page's description here (for search engines and the site search feature)
 ShowOnHome: true/false
 */

Εάν χρειάζεται, μπορείτε επίσης να χρησιμοποιήσετε τις ακόλουθες μεταβλητές στις σελίδες σας:

• %base_url% - Αυτό σας επιτρέπει να αναφέρετε τη διεύθυνση URL του ιστότοπού σας.
• %image_url% - Αυτό σας επιτρέπει να λάβετε τη βασική διεύθυνση URL του καταλόγου εικόνων σας.

Προσθήκη Κατηγοριών

Μπορείτε να προσθέσετε κατηγορίες στη βάση γνώσεων σας εύκολα. Απλώς δημιουργήστε έναν νέο φάκελο στον example/contentκατάλογο και βάλτε τις σελίδες που θέλετε να ανήκουν σε αυτήν την κατηγορία σε αυτόν τον φάκελο. Για παράδειγμα, ας πούμε ότι θέλαμε μια κατηγορία να ονομάζεται helpμε τις σελίδες contact, help-meκαι awesome. Τα αρχεία θα μοιάζουν με αυτό:

/example/content/help/contact.md
/example/content/help/help-me.md
/example/content/help/awesome.md

Μπορείτε να προσθέσετε όσους υποφακέλους θέλετε μέσα σε κατηγορίες.

Οι κατηγορίες μπορούν επίσης να έχουν μετα-πληροφορίες. Δημιουργήστε ένα αρχείο που ονομάζεται metaστο φάκελο κατηγορίας. Υποστηρίζονται τα ακόλουθα χαρακτηριστικά (όλα προαιρετικά):

• Τίτλος - Αντικαθιστά τον τίτλο με βάση το όνομα φακέλου.
• Ταξινόμηση - Σας επιτρέπει να ταξινομήσετε τη σειρά των κατηγοριών, λειτουργεί με τον ίδιο τρόπο όπως η ταξινόμηση σελίδων.
• ShowOnHome - true/false.

Προσαρμοσμένη αρχική σελίδα

Εάν θέλετε να προσθέσετε μια προσαρμοσμένη αρχική σελίδα, το μόνο που χρειάζεται να κάνετε είναι να προσθέσετε ένα αρχείο σήμανσης που καλείται index.mdστον example/contentφάκελό σας .

Ταξινόμηση σελίδων

Το Raneto ταξινομεί αυτόματα τις σελίδες αλφαβητικά, αλλά μπορείτε να εφαρμόσετε μια χειροκίνητη ταξινόμηση προσθέτοντας ένα Sortστοιχείο στο meta της σελίδας. Η τιμή της ταξινόμησης πρέπει να είναι ακέραιος, για παράδειγμα:

Sort: 7

Αυτή η σελίδα θα εμφανίζεται τώρα πριν από σελίδες με τιμή ταξινόμησης 8 ή μεγαλύτερη, αλλά μετά από σελίδες με τιμή 6 ή μικρότερη.

Αλλαγή του προτύπου

Εάν είστε εξοικειωμένοι με το HTML ή το CSS, μπορείτε εύκολα να αλλάξετε την εμφάνιση της εγκατάστασης Raneto. Το Raneto χρησιμοποιεί Handlebars, μια γλώσσα προτύπου JavaScript, που διαμορφώνει την επεξεργασία HTML. Μπορείτε να βρείτε τα αρχεία θεμάτων στο themes/defaultφάκελο. Εάν θέλετε περισσότερες πληροφορίες σχετικά με την επεξεργασία προτύπων Renato, μπορείτε να επισκεφτείτε την ενότητα βοήθειάς τους . Μόλις ολοκληρώσετε την επεξεργασία του προτύπου, βεβαιωθείτε ότι έχετε επανεκκινήσει την εφαρμογή.