1.Raneto Docs简说明

  a
Raneto是一个根据Markdown的开源之node.js知识库平台,它应用Markdown文件来囤积知识库,Raneto我们也得将该叫”静态网站生成器”,因为它不需要数据库存储数据,所有的情节都是储存在Markdown(.md)文件被,他有着以下几个特色(官方介绍)

    a.1 简单
 我们得以下好爱的文本编辑器来创建及治本一个完好的学问平台。

    a.2 Flat   Raneto是一个”flat
file” CMS,意味着系统并未数据库,没有Mysql查询,没有另外东西。

    a.3 Fast  
Raneto轻量级,不利用数据库,使该访问速度也颇之飞跃。

  b Raneto官网:http://raneto.com/

  c 学习文档:http://docs.raneto.com/

  d 源码: https://github.com/gilbitron/Raneto

  e 那么归结,Raneto的用途到底是呀也?个人觉得它们的用处就是被铺或者组织成立一个知识库平台,将(知识,规范(编码规范、操作规范)、技术等等)分享至端,可以有效的减沟通时,当然她吗可据此来开发个人网站门户网站等,完全没开发量,但是优缺点太明显,故而使用与否在公的控制限制中。

  f
我们集团大气底动了此事物,因为安排简单,团队里的一些作业为非便民去企业的Wiki上去写(各位懂得),故而我们发出恢宏之利用,故而将它分享给大家,希望大家会好。

2.备工作

  a
通过者简单的介绍下咱们就了解了Raneto到底是干什么的,那么连下去我们虽得以Linux下搭建它以安排使用它。

  b
从点我们清楚Raneto是依据nodejs的,故而在Linux系统下面为运行Raneto,我们首先用设置nodejs,接下去当安装Raneto。

  c
nodejs下载包地址:http://nodejs.cn/download/

  d
Raneto下充斥地址:https://github.com/gilbitron/Raneto/releases

  e 操作需要的软件和系统如下:虚拟机(Vmware),虚拟机中装置之Centos系统,Xshell,Xftp,nodejs包,raneto包。

3.Nodejs安装

  a
通过上面简单的预备干活之后,现在我们曾有所了可装的包以及公布之条件,如果没有,请参见上面的文章,自行下载准备。

  b
因为Raneto是因nodejs的,所以我们先是得给linux安装nodejs,那么怎样设置也?请继续为下看

  c
使用XShell连接Centos,连接成功后采取命令跳反至local下面创建好之文书夹kencery,在这个文件夹下面创建nodejs文件夹,命令如下:

    c.1  (1):cd usr/local/  
 (2):mkdir kencery    (3):cd kencery/   (4):mkdir nodejs  (5):cd
nodejs/

  d
然后使Xftp将于点下载的nodejs包复制到nodejs文件夹里面。

  e
将上传的node-v6.2.0-linux-x64.tar.gz包解压,解压之后命名也:node,如图所示:

    e.1 tar
-zxvf node-v6.2.0-linux-x64.tar.gz

    e.2
mv node-v6.2.0-linux-x64.tar.gz node

     json 1 

  f 编辑文件添加环境变量

    f.1 vim /etc/profile

    f.2
在文件末添加如下命令并且保留,确认上加是:

      #(/usr/local/kencery/nodejs/node此路径是nodejs的解压的门径)

         
    export NODE_HOME=/usr/local/kencery/nodejs/node

           
  export PATH=$PATH:$NODE_HOME/bin

           
  export NODE_PATH=$NODE_HOME/lib/node_modules

    f.3
输入如下命令使刚刚修改的文件生效   source /etc/profile

  g
所有方面的操作完成以后,我们输入如下命令查看nodejs的版本,如果出现版本则证明安装成功,否则则是设置失败,请检查流程

    g.1  node -v

4.Raneto安装

  a
通过上面简答的准备干活之后,我们已拥有了足装的保及颁布之条件又也装成功了nodejs,如果地方没有准备充分,请自行准备。

  b 使用XShell连接Centos,连接成后以命令跳反到local下面创建自己之文书夹kencery,在这文件夹下面创建raneto文件夹,命令如下:
    b.1  (1):cd usr/local/  
 (2):mkdir kencery    (3):cd kencery/  
(4):mkdir raneto(5):cd raneto/

  c
然后用Xftp将于上头下载的raneto包(Raneto-0.9.0.tar.gz)复制到raneto文件夹里面,并且以包解压,解压之后命名为raneto,如图所示:

    c.1 tar -zxvf Raneto-0.9.0.tar.gz

    c.2 mv Raneto-0.9.0 raneto

    json 2

  d
解压下过反至raneto下实行安装命令,命令如下:

    d.1  (1):cd raneto/    
 (2):npm install(时间未是相似的哦长)    (3):npm start

  e
 如果以上命令执行没有意外,这时候说明您的raneto已经起步了,这时候在安的本机上一度好采用http://localhost:3000来访问了,但是如果想在自己的机器上访问,则需要给linux下开放3000端口,并且重启防火墙。

  f
 安装好之后采用自己本地电脑访问(http://192.168.37.133:3000/),但是当加载成功的时我们页面是混之,监控看了瞬间,发现里头有一个lib文件夹没有,为什么没有也?(只能说我委不明白,不过我怀疑是给堵了,所以于执行命令的时刻没有下载下来,但是来纪念源码中下载下来便该包含呀,但是的确并未),不过未根本,找到这lib文件夹(themes/default/public/)并且放入到安装的路下即可。页面乱如图所示:

    f.1
lib文件下充斥地址:http://pan.baidu.com/s/1pK81Gan  

    json 3

  g
 最后再启Raneto(Ctrl+C关闭),使用命令npm
start(如果您期望于后台运行nohup npm start,然后您就好合命令执行了。当你再次索要关闭Raneto时,需要ps -fe | node得到PID之后 kill PID))重新开动,访问发现页面变得死去活来整齐,很规整。

5.Raneto布置好以后的文书结构说明

  a
当Raneto安装到位后,在攻使用它之前,先简单看一下她的文书结构为咱们本着其发出只大概的刺探,截图如下:

    json 4

    a.1
如图所示,大部分文件夹和文件我们无待了解,也未待配备,我们任重而道远了解example和package.json这半单布局文件即可,example为默认系统面临的页面内容,package.json为布局启动哪一个文本夹作为系统采用的内容。

    a.2
至于其他文件我们召开简单询问,app应用程序的安排文件,bin安装文件,node_modules为raneto因的管内容(比如寻找引擎),themes为网站的主题信息。

    a.3
配置文件简单商讨这里吧,这种事物主要还是如动在实践中,故而我们开安排好的情。

6.Raneto安排好之网站数据

  a
输入路径((http://192.168.37.133:3000/),打开页面,发现系统就默认自带了讲解raneto的页面信息,但是相对来说这个对咱们无任何利用价值,我们用团结的事物,这时候要不怕得自己配置。原始的页面等消息不需要动。

  b
首先跳反到raneto的解压路径下,然后创建文件夹kencery,在kencery文件夹内新建content目录(顾名思义就是放内容文件),然后我们以将example目下之server.js、package.json、config.default.js复制到kencery目录下,最终部署好后如图所示:

    json 5

  c
当上面的布局好后咱们回来raneto的解压路径下,看到含一个package.json(不是kencery下之,而是主目录下的),打开她,我们找到节点scripts,如下如所示,修改我写起的红框里面的情节跟为我们创建的文本夹的称从此保存即可。

    json 6

  d
最后再启raneto,继续走访发现早已是造访我们配备的新的内容了,在此间我们安排就已经形成了,但是我们发现中间尚未页面,这时候我们按照example下之content的结构补加几单页面去测试,你就会见知道该怎么设置了。

7.Raneto在线编辑/排序/其它

  a
当上面给咱们协调安排成功自己的网站信息后,输入路径访问,发现内容很少,这时候我们就是得写副大量底网站消息到系统受到,但是发现于咱们走访的页面及默认是未可知展开在线编的,那么此时要我们尚去服务器上面去写多少的话,会造成操作比较缓慢,所以Raneto默认含有配置在线编的挑三拣四项,只是默认是匪启用的,我们以那个启用。

    a.1
首先我们开拓也我们温馨创造的公文夹(kencery),修改文件config.default.js
中的allow_editing的价为true,然后保留。

    a.2
重新开动raneto,打开页面,进入页面详细页面后,发现差不多矣片小+号和Actions,单击这些内容自动测试。

  b
如下图所显示,我们视了三只模块(首页、权限管理、添加),这时候我们只要想只要将权限管理排序在首先号该怎么做吗?

    b.1
打开kencery下的config.default.js文件被,我们发现来这么一个特性:page_sort_meta: ‘sort’。

    b.2
继而过反至content下的权能管理文件夹下,创建sort文件,在里边写入0,保存

    b.3
重新开动raneto,打开首页页面,发现排序已形成。

    json 7 

    b.4
备注:如果大家看首页这个情节还于,那是以首页是网默认的,如果未思那个排序在首先个,可以去除后创立首页文件,而休是置于content文件夹下,结构如图所示:

    json 8

  备注:可以详细看一下kencery下的config.default.js文件中之有着的属性,均产生备注,很爱懂,请大家自行测试,查看页面变化。

8.Raneto限制用户只能登陆才会访问信息

  a
按照地方的步调我们都创造了好多页面,但是及时是属于商家内部的物的,不愿意有人数还能够浏览我们的知识库,只想我们一个组织的食指来看,所以我们用吃网站配置登录信息(当然最好好布局在局域网内,不允许局域网外的人头拜访太好)。

  b
raneto暂时未支持配置多个用户名密码,也就是说只能配备一个用户名密码。

  c
首先我们找到kencery下的config.default.js配置文件中之authentication和credentials属性,启用权限,并且填写您协调的用户名密码,如图所示:

    json 9

  d.
然后回安装的路子下,条主电脑themes/default/templates目录下之layout.html,打开layout.html,

    d.1 在body标签开始之下添加

      {{#config.authentication}}

      {{#loggedIn}}

    d.2
在body标签了之前增长如图所示(跳转路径自己定义)

      json 10

  c.
保存上面的文本之后重新开动raneto,继续打开网站浏览,发现早已提醒我们需要跨越反到登录页面了,输入才设置的用户名密码,单击登录,跳反到主页。

9.针对性该展开汉化 

  a
综上得后,我们开辟网站,输入用户名密码进入系统以后,全部页面就完全展示,但是咱发现页面中除我们温馨录入的国语数据外,其它的全部都是英文,这时候我们的要求便是哪以唤起和页面静态信息汉化呢?下面我们就是来验证一下

    a.1
首先我们开辟kencery下的config.default.js文件,找到属性 locale:
‘en’,将那价值修改为’zh’,保存关闭。

    a.2
然后找到安装包路径下的app/translations,在底下看看含一个文件en.json,拷贝一卖命名也zh.json,打开后,按照模块去窜中的情节,如图所示(下面图片上本身只是简短修改了一点点,其他情节大家温馨去测试吧)

      json 11

    a.3
修改就之后保存,重新启航raneto,继续浏览页面发现曾就了汉化。

 

    每天一点点都是前进

       如果文章哪里有问题,欢迎大家指出来,我会以第一时间修改。

相关文章

网站地图xml地图