環境
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 ****
