Ubuntu 17.10にRanetoをインストールする方法

• 前提条件
• ログイン
• Node.js＆PM2のインストール
• Ranetoのインストール
• さらなる構成
• ページを追加する
• カテゴリを追加する

Ranetoは、Node.jsをベースに構築された無料のオープンソースのナレッジベースであり、セットアップと使用が簡単で、管理も簡単です。カテゴリとページはMarkdownで記述されているため、編集が簡単です。Markdownを使用しない場合は、RanetoでHTMLを使用することもできます。

前提条件

• Ubuntu 17.10がインストールされたVPS。
• VPSへのSSHアクセス。
• Linuxターミナルの基本的な理解。

ログイン

まず、SSHを使用してサーバーにログインする必要があります。これを行うには、お気に入りのSSHクライアントを開きます。

ssh root@SERVER_IP

パスワードを入力すると（Vultrダッシュボードから取得できます）、VPSにログインします。

Node.js＆PM2のインストール

Ranetoは、JavaScriptランタイムおよびフレームワークであるNode.jsで実行されます。このチュートリアルでは、長期的なサポートのため、Node.js v8を使用します。次のコマンドを入力して、インストールを開始します。

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

このスクリプトの実行が終了したら、メインインストールを実行できます。

sudo apt-get install -y nodejs

このインストーラーが完了すると、VPSにインストールされているNode.jsの最新のコピーが作成されます。次に、PM2をインストールします。PM2は、Raneto（および他の多くのNode.jsアプリケーション）の実行を容易にする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の実行が終了したら、次の2つのコマンドのいずれかを使用してアプリケーションを起動できます。

npm start
# or
npm example/server.js

これで、に移動して、新しいRanetoインストールにアクセスできるようになりますSERVER_IP:3000。このチュートリアルの残りの部分では、Ranetoをさらに構成する方法、新しいページを作成する、カテゴリを追加する、並べ替えを調整する、カスタムホームページを追加する、およびテンプレートを編集する方法について説明します。

さらなる構成

これで、VPSでホストされているデフォルトのRanetoインストールがあります。他のことを始める前に、デフォルトの構成とセットアップにいくつかの変更を加えることをお勧めします。

フォルダにconfig.default.jsあるを見てみましょうexample。この設定ファイルは非常に長いですが、コメントが多いので、無理しないでください。編集する必要があるプロパティは次のとおりです。

• site_title -これをウェブサイトのタイトルに変更します。
• base_url-これはサイトのURLに設定する必要があります。ページの編集時に変数として使用できます。
• support_email-これを有効なメールに変更します。サイトのフッターに表示されます。
• copyright -フッターテキスト。
• analytics -ここにGoogle Analyticsトラッキングコードを追加します。
• allow_editing -Webエディターを使用してファイルを編集できるようにしますか？
• authentication_for_read -ログインしてWebサイトを表示しますか？
• credentials -ログインが有効になっている場合は、ここにユーザーを追加します。
• locale -言語。
• datetime_format -日付と時刻のフォーマット。
• home_meta -これを編集して、ホームページのメタ情報を変更します。
• table_of_content -Ranetoは目次を表示する必要がありますか？

オンラインエディターの使用

Ranetoには、ページ、カテゴリなどを管理するための使いやすいオンラインインターフェイスが付属しています。すべてを行うことはできませんが、外出先で簡単に編集する必要がある場合は確かに役立ちます。

config.default.js（上記のように）で設定を有効にしてからVPSにアクセスし、右上隅のログインボタンをクリックすることでアクセスできます。ユーザー名とパスワードを入力し（これらはで変更できconfig.default.jsます）、[ログイン]をクリックします。編集する必要のあるページをクリックし、Actionsドロップダウンをクリックして、実行するアクションを選択するだけです。+カテゴリ名の横にあるボタンを押すとページを追加でき、左上隅の入力フィールドを使用してカテゴリを作成できます。

ページを追加する

ページの追加は.md、example/contentフォルダに新しいMarkdown（）ドキュメントを作成するのと同じくらい簡単です。

新しい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ますが、ページメタにアイテムを追加することで手動並べ替えを適用できます。sortの値は整数でなければなりません。例えば：

Sort: 7

このページは、ソート値が8以上のページの前に表示されますが、値が6以下のページの後に表示されます。

テンプレートを変更する

HTMLまたはCSSに精通している場合は、Ranetoインストールの外観を簡単に変更できます。Ranetoは、HTML編集をモジュール化するJavaScriptテンプレート言語であるHandlebarsを使用します。テーマファイルはthemes/defaultフォルダー内にあります。Renatoテンプレートの編集の詳細については、テンプレートのヘルプセクションをご覧ください。テンプレートの編集が完了したら、必ずアプリケーションを再起動してください。