如何在Ubuntu 17.10上安装Raneto

• 先决条件
• 在登录
• 安装Node.js和PM2
• 安装Raneto
• 进一步配置
• 添加页面
• 添加类别

Raneto是一个基于Node.js的免费开放源码知识库，该知识库易于设置和使用以及易于管理。类别和页面是用Markdown编写的，这使编辑变得容易。如果Markdown不是您的事，Raneto还允许您使用HTML。

先决条件

• 安装了Ubuntu 17.10的VPS。
• 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

安装程序完成后，您将在VPS上安装Node.js的最新副本。接下来，我们将安装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，创建新页面，添加类别，调整排序，添加自定义首页和编辑模板。

进一步配置

现在，您的VPS上托管了默认的Raneto安装。在开始执行其他操作之前，建议您对默认配置和设置进行一些更改。

让我们看一下config.default.js位于example文件夹中的。此配置文件很长，但是请注意，因为它已被大量评论。这是您应编辑的属性：

• site_title -将此更改为您的网站标题。
• base_url-应将其设置为您网站的URL。编辑页面时，可以将其用作变量。
• support_email-将此更改为有效的电子邮件。它将显示在网站的页脚中。
• copyright -页脚文字。
• analytics -在此处添加Google Analytics（分析）跟踪代码。
• allow_editing -您是否希望能够使用网络编辑器来编辑文件？
• authentication_for_read -您是否希望人们登录以查看网站？
• 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% -这可以让您提及您网站的网址。
• %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-是/否。

自定义首页

如果要添加自定义主页，只需将名为markdown的文件添加index.md到example/content文件夹中即可。

排序页面

Raneto会自动按字母顺序对页面进行排序，但是您可以通过将一项添加Sort到页面元中来应用手动排序。sort的值必须是整数，例如：

Sort: 7

现在，此页面将出现在排序值为8或更大的页面之前，但出现在值为6或更小的页面之后。

更改模板

如果您熟悉HTML或CSS，则可以轻松更改Raneto安装的外观。Raneto使用Handlebars（一种JavaScript模板语言）对HTML编辑进行模块化。您可以在文件themes/default夹中找到主题文件。如果您想了解有关编辑Renato模板的更多信息，请访问其帮助部分。完成模板编辑后，请确保重新启动应用程序。