purelog-cli
Version:
Command line interface for Purelog
92 lines (51 loc) • 4.39 kB
Markdown
<!--
Title: 如何配置Purelog
ID: configure
Date: 2013-11-06 12:21:00
Status: publish
Type: post
Tags: 配置, 指南
Excerpt: Purelog是一个轻量快速的,完全基于Markdown的,可扩展的博客平台
-->
Purelog是一个高度可配置的博客,除了插件之外,它还支持很多配置,所以,你需要了解这些配置,才能让你的博客更好的工作。
配置文件位于你博客的安装目录下,例如你的博客放在`/var/www/purelog`下,那么安装的位置就在`/var/www/purelog/config.js`。
Purelog的配置采用JSON格式,一个标准的配置文件请参考[这里](https://gist.github.com/conis/7330792)
##blog
`blog`键用于配置博客的基本信息,包含作者、博客标题等
* title - 博客标题,默认为`Purelog`
* author - 作者姓名,默认为`Conis`
* host - 用于配置博客的域名,默认为`http://purelog.org`
* rss - 博客的rss订阅地址,默认为`http://purelog.org/rss/`
* port - 端口,默认为`13111`
* description - 博客的简单说明,一般建议一句话
* meta_keywork - meta中的keywrod
* meta_description - meta中的description
* page_size - 文章分页大小
##cache
`cache`键负责缓存的设置(功能暂未实现),这里的缓存是直接缓存html页,如果缓存,则下次请求的时候直接返回已经渲染的html,不需要再经模块渲染,如果你使用了nginx反向代理,并且代理开启了缓存,则不需要设置这里的缓存
* index - 是否缓存首页,默认为`true`
* article - 是否缓存文章页,默认为`true`
##optimize
`optimize`键负责优化相关的设置
* min_css - 是事最小化压缩css,默认为`true`
* min_js - 是否最小化压缩js,默认为`true`
##routes
`routes`负责处理路由规则,但优先级比插件中的路由要低,这就意味着,如果某个路由插件也处理了`/`这个路由,你的首页将会被这个插件接管。注意路由地址都要以`/`开始,`/make.html`是一个合法的路由,而`make.html`将会是404错误。
路由的地址可以是一个字符,也可以是一个数组,如果路由的地址是数组,也就意味着多个路由可能会返回同一个内容。
`make` - 重建索引的路由,如果这个网址被访问,会重新索引文章。如果你使用了`purelog-storage-git`这个插件,则会从新到git上pull下文章再建立索引。如果你使用了`purelog-storage-dropbox`,则会重新下载所有dropbox共享链接下的文章,并重新建立索引。默认为`/make.html`,为了安全,你可以改成其它你喜欢的地址,如`/66256d7cdf00b01edd69854649bd378b`
`index` - 首页及首页分页的路由,默认为`["/", "/page/:page/"]`,这是一个典型多路由指向同一个触发。
`article` - 文章页的路由,这里暂不支持多路由。默认为`/archive/:article.html`
##plugins
`plugins`是Purelog一个非常重要的配置项,`plugins`键下有四个子键,分别对应着Purelog四种不同类型的插件,除了`routes`可以是多选之外,其它的插件都只能使用一个。
`plugins`的子键有两个可选配置,一个是`package`配置插件的名字,另一个`options`根据不同的插件配置不同。
官方的插件配置,请参考文章最后。
###theme
`theme`负责主题插件的配置,如果你需要换主题,首先要用`npm install purelog-theme-name`,再将这里改为`purelog-theme-name`即可。
###routes
`routes`负责路由插件的配置,默认情况已经配置了`purelog-router-rss`这个插件,负责处理Purelog的rss输出。
###reduce
`reduce`负责处理数据整理的插件,默认情况下,安装了`purelog-reduce-cache`,`purelog-reduce-cache`会将数据全部放在内存中,如果你不希望文章被缓存在内存中,你可以使用其它存储在数据中的插件。
###storage
`storage`是负责存取数据的插件,默认情况,安装了·purelog-storage-local·的插件,这个插件将会在本地文件夹中读取文章。官方还提供`purelog-storage-dropbox`和`purelog-storage-git`两个插件,用于读取dropbox与git的文章,这两个插件默认是已经安装的,你可以根据自行选择替换。
##插件配置
请访问 [官方默认插件介绍及配置](http://purelog.org/archive/plugin-configure.html)