Cara Memasang Raneto di Ubuntu 17.10

• Prasyarat
• Masuk
• Menginstal Node.js & PM2
• Menginstal Raneto
• Konfigurasi Lebih Lanjut
• Menambahkan Halaman
• Menambahkan Kategori

Raneto adalah basis pengetahuan sumber terbuka dan gratis, dibangun di atas Node.js yang mudah diatur dan digunakan, serta mudah diadministrasikan. Kategori dan halaman ditulis dalam Markdown, yang membuatnya mudah untuk diedit. Jika Penurunan harga bukan hal Anda, Raneto juga memungkinkan Anda untuk menggunakan HTML.

Prasyarat

• VPS dengan Ubuntu 17.10 diinstal.
• Akses SSH ke VPS Anda.
• Pemahaman dasar terminal Linux.

Masuk

Pertama, kita harus masuk ke server menggunakan SSH. Untuk melakukan ini, buka klien SSH favorit Anda.

ssh root@SERVER_IP

Setelah memasukkan kata sandi Anda (Anda bisa mendapatkannya dari dasbor Vultr) Anda akan masuk ke VPS Anda.

Menginstal Node.js & PM2

Raneto berjalan di Node.js, sebuah runtime dan kerangka kerja javascript. Dalam tutorial ini, kita akan menggunakan Node.js v8 karena dukungan jangka panjangnya. Mulai instalasi dengan mengetik perintah berikut.

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

Setelah skrip ini selesai berjalan, Anda dapat menjalankan instalasi utama.

sudo apt-get install -y nodejs

Setelah penginstal ini selesai, Anda akan memiliki salinan Node.js terbaru yang diinstal pada VPS Anda. Selanjutnya, kita akan menginstal PM2, manajer proses untuk Node.js yang membuat menjalankan Raneto (dan banyak aplikasi Node.js lainnya) lebih mudah.

npm install pm2 -g

Kami sekarang memiliki semua perangkat lunak yang kami perlukan untuk menginstal Raneto.

Menginstal Raneto

Kami akan menggunakan Git untuk mengkloning repositori Raneto ke server kami.

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

Ini akan membuat folder bernama Raneto. Masukkan folder.

cd Raneto

Pasang NPM.

npm install

Jalankan Gulp dengan mengetik berikut ini.

npm run gulp

Setelah Gulp selesai berjalan, kita dapat memulai aplikasi menggunakan salah satu dari dua perintah berikut.

npm start
# or
npm example/server.js

Anda sekarang dapat mengakses instalasi Raneto baru Anda dengan menavigasi ke SERVER_IP:3000. Sisa tutorial ini akan mengajarkan Anda cara mengkonfigurasi Raneto lebih lanjut, membuat halaman baru, menambahkan kategori, menyesuaikan penyortiran, menambahkan beranda khusus dan mengedit templat.

Konfigurasi Lebih Lanjut

Anda sekarang memiliki instalasi Raneto default yang dihosting di VPS Anda. Sebelum Anda mulai melakukan hal lain, saya sarankan Anda membuat beberapa perubahan pada konfigurasi dan pengaturan default.

Mari kita lihat config.default.js, yang terletak di examplefolder. File konfigurasi ini cukup panjang, tapi tolong jangan kewalahan, karena ini sangat dikomentari. Berikut adalah properti yang harus Anda edit:

• site_title - Ubah ini ke judul situs web Anda.
• base_url- Ini harus disetel ke URL situs Anda. Itu dapat digunakan sebagai variabel saat mengedit halaman.
• support_email- Ubah ini menjadi email yang valid. Ini akan ditampilkan di footer situs.
• copyright - Catatan kaki.
• analytics - Tambahkan kode pelacakan Google Analytics di sini.
• allow_editing - Apakah Anda ingin dapat mengedit file menggunakan editor web?
• authentication_for_read - Apakah Anda ingin orang masuk untuk melihat situs web?
• credentials - Tambahkan pengguna di sini jika login diaktifkan.
• locale - Bahasa.
• datetime_format - Format tanggal dan waktu.
• home_meta - Edit ini untuk mengubah informasi meta beranda Anda.
• table_of_content - Haruskah Raneto menampilkan daftar isi?

Menggunakan Editor Online

Raneto hadir dengan antarmuka online yang mudah digunakan untuk mengelola halaman, kategori, dan lainnya. Meskipun tidak memungkinkan Anda melakukan semuanya, tentu sangat membantu jika Anda perlu mengedit cepat saat bepergian.

Anda dapat mengaksesnya dengan mengaktifkan pengaturan di config.default.js(seperti yang disebutkan di atas) dan kemudian mengunjungi VPS Anda dan mengklik tombol masuk di sudut kanan atas. Masukkan nama pengguna dan kata sandi Anda (Anda dapat mengubahnya config.default.js) dan klik login. Cukup klik pada halaman yang perlu Anda edit, klik Actionstarik-turun dan pilih tindakan yang ingin Anda selesaikan. Anda dapat menambahkan halaman dengan menekan +tombol di sebelah nama kategori, dan Anda dapat membuat kategori menggunakan bidang input di sudut kiri atas.

Menambahkan Halaman

Menambahkan halaman semudah membuat .mddokumen Markdown ( ) baru di example/contentfolder.

Setelah Anda membuat file penurunan harga baru, penting bahwa Anda menambahkan beberapa informasi dasar ke bagian atas file. Buka file di editor teks favorit Anda. Kita perlu menambahkan yang berikut ke bagian atas file.

/*
 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
 */

Jika perlu, Anda juga dapat menggunakan variabel berikut di halaman Anda:

• %base_url% - Ini memungkinkan Anda menyebutkan URL situs web Anda.
• %image_url% - Ini memungkinkan Anda untuk mendapatkan URL dasar dari direktori gambar Anda.

Menambahkan Kategori

Anda dapat menambahkan kategori ke basis pengetahuan Anda dengan mudah. Cukup buat folder baru di example/contentdirektori dan letakkan halaman yang Anda inginkan dalam kategori itu di folder itu. Misalnya, kami ingin kategori yang disebut helpdengan halaman yang dipanggil contact, help-medan awesome. File akan terlihat seperti ini:

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

Anda dapat menambahkan sub-folder sebanyak yang Anda inginkan di dalam kategori.

Kategori juga dapat memiliki informasi meta. Buat file yang disebut metadi folder kategori. Atribut berikut ini didukung (semua opsional):

• Judul - Mengganti judul berdasarkan nama folder.
• Sortir - Memungkinkan Anda untuk mengurutkan urutan kategori, bekerja dengan cara yang sama seperti menyortir halaman.
• ShowOnHome - benar / salah.

Beranda Kustom

Jika Anda ingin menambahkan beranda khusus, yang perlu Anda lakukan adalah menambahkan file penurunan harga yang dipanggil index.mdke example/contentfolder Anda .

Halaman Sortasi

Raneto secara otomatis mengurutkan halaman berdasarkan abjad, tetapi Anda dapat menerapkan jenis manual dengan menambahkan Sortitem ke meta halaman. Nilai sortir harus bilangan bulat, misalnya:

Sort: 7

Halaman ini sekarang akan muncul sebelum halaman dengan nilai semacam 8 atau lebih, tetapi setelah halaman dengan nilai 6 atau kurang.

Mengubah Templat

Jika Anda terbiasa dengan HTML atau CSS, Anda dapat dengan mudah mengubah tampilan instalasi Raneto Anda. Raneto menggunakan Setang, bahasa templating JavaScript, yang memodulasi pengeditan HTML. Anda dapat menemukan file tema di themes/defaultfolder. Jika Anda ingin informasi lebih lanjut tentang mengedit template Renato, Anda dapat mengunjungi bagian bantuan mereka . Setelah selesai mengedit template, pastikan Anda me-restart aplikasi.