如何安装配置程序 - lizheming/PMBlog GitHub Wiki

##如何安装

编辑config.php文件完成程序配置，修改对应的单引号包括的内容并保存。（如果不明白各个变量的意义可以看文末的详细解释。）
浏览器打开http://localhost/pmblog/index.php（假设你的目录结构是这样的），程序运行完毕会自动跳转到静态文件目录。

##关于程序的原理

目前有些人会对静态文件存放目录（即SITE_DIR）和网站目录（即$config['base_url'])这两个变量混淆。这里要说明一下，程序的原理是通过读取用户的日志文件并将其替换掉模板中的相应变量，比如我写了一篇日志：

hello.md

# Hello World

你好世界

程序会自动解析得到文章的slug是hello, 标题是Hello World, 文章内容是你好世界。并读取文章模板（即主题的post.html文件），替换掉相应的变量，生成一个hello.html文件存放在文章存放文件夹post文件夹下。

总的来说PMBLOG的最终作用是生成一个相互关联的静态文件（即每一个html文件都是相关联的，一个文件可以通过地址跳转到另一个文件去）博客系统。SITE_DIR变量只是为程序定义一个静态文件需要输出的目录，最终用户在Web上访问的地址需要$config['base_url']去决定。

##关于程序的一点小技巧

也许有些人喜欢将程序直接上传到虚拟主机上，比如我。

假设你的根URL是http://abc.com（即abc.com对应你的public_html文件夹）。同时假设你的PMBLOG路径为public_html/pmblog。那么按照默认设置，你最终访问博客的网址为http://abc.com/pmblog/html。网址后面的html非常的让人讨厌。如何设置才能使得访问http://abc.com/pmblog就是网站呢？

只要按照如下目录存放文件：

|-public_html
	|-pmblog
		|-admin
			|-config.php
			|-index.php
			|-lib
			|-md
			|-tmp

同时将config.php中的相应变量做如下修改

define(SITE_DIR, '../');

即将静态文件存放目录设置成了父文件夹，这样就可以实现我们的目标。

##config.php中各变量的详细解释

$config['site_title']

博客的标题

$config['base_url']

博客的URL，即用户访问地址。假设你定义的URL是http://abc.com（即abc.com对应你的public_html文件夹）。那么你之后需要将SITE_DIR中的文件上传到public_html这个目录下。

$config['theme']

博客使用主题文件夹，需要确保tmp下该主题文件夹存在，否则会造成错误。

$config['date+format']

博客默认时间格式，这是一个默认的格式,当你在模板中调用显示评论日期方法时, 如果没有指定日期格式, 将按照此格式输出.具体写法请参考PHP日期格式写法.

CONTENTS_DIR

用户日志存放文件夹，可以填写相对路径。

SITE_DIR

静态文件生成文件夹，可以填写相对路径。只对程序有意义，并非博客最终的访问地址。

THEMES_DIR

主题文件存放位置

PLUGINS_DIR

插件文件存放位置

$config['posts_per_page']

每页文章数目。此数目用于指定文章归档输出时每页显示的文章数目。

$config['post_router']

自定义文章页存放位置，可用参数: {category} 日志分类, {year} 年, {month} 月, {day} 日

文章存放位置即文章的访问地址的一部分，选择一种合适的文章路径风格, 使得你的网站链接更加友好.

一旦你选择了某种链接风格请不要轻易修改它.

$config['page_router']

自定义页面存放位置，可用参数：{year} 年, {month} 月, {day} 日。

####为PHP初学者友情提示：$site['title']对应的就是$site = array('title' => 'PMBLOG');项，具体可以查看Array数组