Cara Memasang Raneto di Ubuntu 17.10

• Prasyarat
• Melog masuk
• Memasang Node.js & PM2
• Memasang Raneto
• Konfigurasi Lebih Lanjut
• Menambah Halaman
• Menambah Kategori

Raneto adalah pangkalan pengetahuan percuma dan sumber terbuka, dibina di atas Node.js yang mudah diatur dan digunakan, serta mudah untuk mentadbir. Kategori dan halaman ditulis dalam Markdown, yang menjadikannya mudah untuk diedit. Jika Markdown bukan perkara anda, Raneto juga membolehkan anda menggunakan HTML.

Prasyarat

• A VPS dengan Ubuntu 17.10 dipasang.
• Akses SSH ke VPS anda.
• Pemahaman asas terminal Linux.

Pembalakan Dalam

Pertama, kita perlu log masuk ke pelayan kami menggunakan SSH. Untuk melakukan ini, buka klien SSH kegemaran anda.

ssh root@SERVER_IP

Setelah memasukkan kata laluan anda (anda boleh mendapatkannya dari papan pemuka Vultr), anda akan masuk ke VPS anda.

Memasang Node.js & PM2

Raneto berjalan pada Node.js, runtime javascript dan rangka kerja. Dalam tutorial ini, kami akan menggunakan Node.js v8 kerana sokongan jangka panjangnya. Mulakan pemasangan dengan menaip arahan berikut.

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

Setelah skrip ini selesai dijalankan, anda boleh menjalankan pemasangan utama.

sudo apt-get install -y nodejs

Setelah pemasang ini selesai, anda akan mempunyai salinan terkini Node.js yang dipasang pada VPS anda. Seterusnya, kita akan memasang PM2, pengurus proses untuk Node.js yang menjadikan menjalankan Raneto (dan banyak aplikasi Node.js lain) lebih mudah.

npm install pm2 -g

Kini kami mendapat semua perisian yang kami perlukan untuk memasang Raneto.

Memasang Raneto

Kami akan menggunakan Git untuk mengklon semula repositori Raneto ke pelayan kami.

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

Ini akan membuat folder dipanggil Raneto. Masukkan folder.

cd Raneto

Pasang NPM.

npm install

Jalankan Gulp dengan menaip perkara berikut.

npm run gulp

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

npm start
# or
npm example/server.js

Anda kini dapat mengakses pemasangan Raneto baharu anda dengan menavigasi ke SERVER_IP:3000. Selebihnya dari tutorial ini akan mengajar anda bagaimana mengkonfigurasi Raneto lebih jauh, membuat halaman baru, menambah kategori, menyesuaikan penyortiran, menambah beranda tersuai dan mengedit templat.

Konfigurasi Lebih Lanjut

Anda kini mempunyai pemasangan Raneto lalai yang dihoskan di VPS anda. Sebelum anda mula melakukan apa-apa lagi, saya cadangkan anda membuat beberapa perubahan pada konfigurasi dan penyetelan lalai.

Mari kita lihat config.default.js, yang terletak di examplefolder. Fail konfigurasi ini agak panjang, tetapi jangan menjadi kewalahan, kerana ia banyak mengulas. Berikut adalah sifat yang harus anda edit:

• site_title - Tukar ini ke tajuk laman web anda.
• base_url- Ini harus ditetapkan ke URL tapak anda. Ia boleh digunakan sebagai pemboleh ubah apabila mengedit halaman.
• support_email- Tukar ini ke e-mel yang sah. Ia akan dipaparkan di footer laman web ini.
• copyright - Teks Footer.
• analytics - Tambah kod Penjejakan Google Analytics di sini.
• allow_editing - Adakah anda mahu dapat mengedit fail menggunakan editor web?
• authentication_for_read - Adakah anda mahu orang masuk untuk melihat laman web?
• credentials - Tambah pengguna di sini jika login didayakan.
• locale - Bahasa.
• datetime_format - Format tarikh dan masa.
• home_meta - Edit ini untuk mengubah maklumat meta laman utama anda.
• table_of_content - Sekiranya Raneto memaparkan jadual kandungan?

Menggunakan Editor Dalam Talian

Raneto dilengkapi dengan antara muka dalam talian yang mudah digunakan untuk menguruskan halaman, kategori dan banyak lagi. Walaupun ia tidak membolehkan anda melakukan segala-galanya, ia pasti berguna jika anda perlu membuat edit pantas semasa dalam perjalanan.

Anda boleh mengaksesnya dengan mendayakan tetapan dalam config.default.js(seperti yang disebutkan di atas) dan kemudian melawat VPS anda dan mengklik butang log masuk di sudut kanan atas. Masukkan nama pengguna dan kata laluan anda (anda boleh menukarnya config.default.js) dan klik log masuk. Cukup klik pada halaman yang perlu anda edit, klik Actionsdrop-down dan pilih tindakan yang ingin anda selesaikan. Anda boleh menambah halaman dengan menekan +butang di sebelah nama kategori, dan anda boleh membuat kategori menggunakan medan input di penjuru kiri sebelah atas.

Menambah Halaman

Menambah halaman semudah membuat .mddokumen Markdown ( ) baru dalam example/contentfolder.

Setelah anda membuat fail Markdown yang baru, penting untuk anda menambahkan beberapa maklumat asas ke bahagian atas fail. Buka fail dalam editor teks kegemaran anda. Kita perlu menambahkan yang berikut di bahagian atas fail.

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

Sekiranya anda perlu, anda juga boleh menggunakan pembolehubah berikut dalam halaman anda:

• %base_url% - Ini membolehkan anda menyebutkan URL laman web anda.
• %image_url% - Ini membolehkan anda mendapatkan URL asas dari direktori gambar anda.

Menambah Kategori

Anda boleh menambah kategori ke pangkalan pengetahuan anda dengan mudah. Cukup buat folder baru dalam example/contentdirektori dan masukkan halaman yang anda mahu masuk dalam kategori tersebut dalam folder tersebut. Sebagai contoh, katakan kami mahu kategori dipanggil helpdengan halaman dipanggil contact, help-medan awesome. Fail akan kelihatan seperti ini:

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

Anda boleh menambah seberapa banyak sub-folder yang anda mahu dalam kategori.

Kategori juga boleh mempunyai maklumat meta. Buat fail yang dipanggil metadalam folder kategori. Atribut-atur berikut disokong (semua pilihan):

• Tajuk - Menggantikan tajuk berdasarkan nama folder.
• Susun - Membolehkan anda menyusun urutan kategori, berfungsi sama seperti menyusun halaman.
• ShowOnHome - benar / palsu.

Halaman Utama Tersuai

Jika anda ingin menambah halaman utama tersuai, semua yang perlu anda lakukan ialah menambahkan fail markdown yang dipanggil index.mdke example/contentfolder anda .

Halaman Penyusun

Raneto menyusun halaman secara automatik mengikut abjad, tetapi anda boleh menggunakan penguraian manual dengan menambahkan Sortitem ke meta halaman. Nilai jenis mestilah integer, contohnya:

Sort: 7

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

Menukar Templat

Jika anda biasa dengan HTML atau CSS, anda boleh mengubah rupa pemasangan Raneto anda dengan mudah. Raneto menggunakan Handlebars, bahasa templat JavaScript, yang memodulasi penyuntingan HTML. Anda boleh mencari fail tema dalam themes/defaultfolder. Sekiranya anda ingin maklumat lanjut mengenai menyunting templat Renato, anda boleh melawat bahagian bantuan mereka . Setelah selesai mengedit templat, pastikan anda memulakan semula aplikasi.