环境
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来浏览一下。
配置
- 文件结构
themesnode_moduleslogoexamplebinapppackage.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 ****