Raneto部署

环境

ubuntu

项目地址

github: Raneto

安装

1.确保主机装好node.js环境

2.切换到你的项目文件目录下

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

4.cd Raneto

5.npm install（需要安装一段时间）

6.npm start

如果以上步骤没有意外，这时你的Raneto已经启动了, 可以访问http://localhost:3000来浏览一下。

配置

文件结构
themes
node_modules
logo
example
bin
app
package.json
其它文件

可以发现第一次浏览页面时的文章都是放在example->content内，然后看package.json

···
"scripts": {
    "start": "DEBUG=raneto node example/server.js",
    "start_win": "set DEBUG=raneto&&node example/server.js",
    "postinstall": "npm update && npm run gulp",
    "gulp": "gulp"
  }
···

所以我们新建一个文件夹： wiki
在wiki文件夹内新建content目录（顾名思义是放内容文件）
然后将example目录下的server.js package.json config.default.js复制到wiki目录下

再修改package.json

···
"scripts": {
    "start": "DEBUG=raneto node wiki/server.js",
    "start_win": "set DEBUG=raneto&&node wiki/server.js",
    "postinstall": "npm update && npm run gulp",
    "gulp": "gulp"
  }
···

现在你可以在wiki/content下放入想要的栏目和文章了。
最后你需要重启Raneto，可在命令行 Ctrl + C，不建议使用Ctrl + Z，然后再输入npm start(如果你希望在后台运行：nohup npm start，然后你就可以关掉命令行了。当你再次需要关闭Raneto时，需要ps -fe | node得到PID之后 kill PID)

再次刷新页面之后，你就会发现页面变了，是不是很简单 (^o^)/~

限制浏览

如果你不希望所有人都能浏览你的网站
这时候我们需要用到wiki/config.default.js这个配置文件（其它很多配置也是在这里，就不一一介绍了。）我们需要改一下这个地方：

···
  authentication : true,
  credentials    : {
    username : '你的用户名',
    password : '你的密码'
  },
  ···

暂时是不支持多用户的。
然后修改themes/default/templates目录下的layout.html
在<!DOCTYPE html>之前添加

{{#config.authentication}}
{{#loggedIn}}

在文档末尾添加

{{/loggedIn}}
{{^loggedIn}}
// 如果没有登陆则跳转至登陆页面
<script language="javascript" type="text/javascript">
  window.location.href='http://localhost:3000/login';
</script>
{{/loggedIn}}
{{/config.authentication}}

接下来你只需要再重启一遍Raneto就行了。

在线编辑

依然是修改wiki/config.default.js 只要改一下这个位置就搞定了：

allow_editing : true,

汉化界面

在app/translations目录下复制一个en.json重命名为zh.json然后汉化内容，注意别改掉key,只改value，还有这个位置不需要改动：

  "api": {
    "loginSuccessful"   : "Login Successful",
    "invalidCredentials": "Invalid Username/Password Combination",
    "pageSaved"         : "Page Saved",
    "pageDeleted"       : "Page Deleted",
    "categoryCreated"   : "Category Created",
    "pageCreated"       : "Page Created"
  },

解决不能搜索中文的BUG

先下载一个lunr.js，链接：https://github.com/codepiano/lunr.js，解压并将文件夹命名为lunr，接下来进入node_modules目录，找到里面的lunr重命名为lunr2（不建议删除），然后再将刚下载的lunr复制进去。
还要改一个地方，进入node_modules/raneto-core/node_modules目录，刚上面那个是一样的，将这里的lunr重命名为lunr2，再将刚下载的lunr复制进去。
再次重启，这里重启的时候可能会出现error，原因是node.js少了一些库，仔细看缺了哪些库，然后npm install ****