fcontex主题说明
===============

主题存放在themes目录中，每一个子目录是一套独立的fcontex主题，主题由模板文件和相关资源组成。
在后台点击左下角的设置图标，在弹出网站主题设置界面中可以更改网站主题。

特别要求
--------
在所有模板文件中要求以两个形如<!--left-->HTML内容<!--left-->的HTML注释标签来标示区域，这样做有两个作用：
1、让模板文件条理清晰、易读；
2、便于路由类型的插件解析页面。

全部注释标签的清单如下：
<!--header-->             页头区域
<!--search-->            搜索区域
<!--navi-->              导航区域
<!--container-->         全部页面区域
<!--position-->          当前页面位置显示区域
<!--center-->            居中的主内容显示区域
<!--left-->              主显示区域
<!--content-->           正文显示区域
<!--right-->             侧栏区域
<!--category-->          侧栏栏目显示区域
<!--tags-->              侧栏标签显示区域
<!--footer-->            页脚区域
<!--comment_js-->        评论JS代码
<!--comment-->           评论主内容区域
<!--comment_list-->      评论列表区域
<!--gbook_js-->          留言JS代码
<!--gbook-->             留言主内容区域
<!--gbook_form-->        留言表单
<!--gbook_list-->        留言列表区域
<!--count_js-->          正文页统计相关JS代码
<!--scrolltop_js-->      滚动到顶部JS代码
<!--highlight_js-->      代码高亮JS代码

具体参照系统自带主题目录下的各个模板文件


一套完整主题的组成
-------------------

theme.php       当前主题的属性文件
images          当前主题的图片及相关资源的存放目录

int.footer.php  公共页脚
int.header.php  公共页头
int.sider.php   公共侧栏

list.php        列表页    访问[主页]、文章[列表页]、标签搜索[结果页]、关键词搜索[结果页]时调用
read.php        正文页    访问[文章正文页]和[普通页面]（如“关于”）时调用
comment.php     评论页    以Ajax方式加载[评论]时调用
gbook.php       留言页    访问[留言页]时调用
404.php         404页
rss.php         RSS页     访问[RSS输出页]时调用


模板变量说明
============

公共变量
--------

在module/startup.php中定义的所有常量及变量都能在模板文件中访问，其中的对象变量所对应的类文件分别为：
$A  =>  module/system/library/cls.application.php
$U  =>  module/member/library/cls.member.php
$D  =>  module/system/library/cls.database.php
$T  =>  module/system/library/cls.template.php
$R  =>  module/system/library/cls.router.php
$P  =>  module/system/library/cls.plugin.php
$C  =>  module/content/library/cls.content.php
要了解这些对象有哪些属性及方法，可以打开这些文件查看。

$position       数组，包含了当前页面的位置信息，用于显示如“首页>栏目名称>”的位置导航。
                可以用foreach($position as $pos){}语法遍历，其中$pos也是一个数组，元素如下：
$pos['text']    位置名称
$pos['link']    位置链接

公共变量在以下所有页面都有效：


主页/列表页
-----------

$category['id']       当前栏目ID
$category['title']    当前栏目名称
$pager                翻页条对象
$turnner              翻页条

$items                数组，包含了当前栏目、当前分页的文章数据。
                      可以用foreach($items as $item){}语法遍历，其中$item是一个数组，主要元素如下：
$item['ct_id']            ID
$item['ct_uid']           作者ID
$item['ct_username']      作者
$item['ct_title']         标题
$item['ct_tags']          标签，以逗号分隔
$item['ct_summary']       导读
$item['ct_content']       正文
$item['ct_inserttime']    发布时间
$item['ct_cover']         封面路径
$item['ct_hits']          点击数
$item['ct_talks']         评论数


标签搜索结果页
--------------

$tag        当前搜索的标签
$items      和[列表页]的$items相同
$pager      翻页条对象
$turnner    翻页条


关键词搜索结果页
----------------

$keyw       当前搜索的关键词
$items      和[列表页]的$items相同
$pager      翻页条对象
$turnner    翻页条

正文页
------

$page    数组，包含的基本元素和[列表页]的$item数组相同，查找全部元素可以打开sqlite.sql搜索fc_content表，该表的所有字段都都可以调用。


评论页
------

$quiet       是否开启了评论

$comments    数组，包含当前分页的评论数据。
             可以用foreach($comments as $item){}语法遍历，其中$item也是一个数组，主要元素如下：
$item['cm_id']         评论ID
$item['cm_cid']        评论的文章的ID
$item['cm_ctitle']     评论的文章的标题
$item['cm_topid']      回复的评论ID，当前评论是回复时为非0值
$item['cm_name']       评论人姓名
$item['cm_content']    评论内容
$item['cm_time']       评论时间
查找全部元素可以打开sqlite.sql搜索fc_comment表，该表的所有字段都都可以调用。

$pager      翻页条对象
$turnner    翻页条


留言页
------

$quiet       是否开启了留言

$gbook    数组，包含当前分页的留言数据。
          可以用foreach($gbook as $item){}语法遍历，其中$item也是一个数组，主要元素如下：
$item['gb_id']         留言ID
$item['gb_cid']        留言的文章的ID
$item['gb_ctitle']     留言的文章的标题
$item['gb_topid']      回复的评论ID，当前留言是回复时为非0值
$item['gb_name']       留言人姓名
$item['gb_content']    留言内容
$item['gb_time']       留言时间
查找全部元素可以打开sqlite.sql搜索fc_gbook表，该表的所有字段都都可以调用。

$pager      翻页条对象
$turnner    翻页条
