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" },
先下载一个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