在 5DBlog SPE 0.6.0 版本之前,我们用 {ListLog} 来列出日志或显示详细内容。现在,系统提供了功能强大的类 XML 标记,可供用户任意设计列表效果。
5DBlog 高级标记使用<Blog:tag[ property]/> 这种类似于 XML 标记的写法。
大小写
所有的标记包括属性部分均不区分大小写。也就是说 {listlog} 和 {ListLog} 效果是一样的;<Blog:Log> 和 <blog:log> 也是一样的
目前可用的高级标记
<Blog:Log></Blog:Log>
<Blog:Log></Blog:Log>
<Blog:Log></Blog:Log> 的完整的格式如下:
<blog:Log PageSize="10">
<blog:Top></blog:Top>
<blog:ListHeader></blog:ListHeader>
<blog:ListEntry></blog:ListEntry>
<blog:ListSeparator></blog:ListSeparator>
<blog:ListFooter></blog:ListFooter>
<blog:DetailHeader></blog:DetailHeader>
<blog:DetailContent></blog:DetailContent>
<blog:DetailFooter></blog:DetailFooter>
<blog:CommentHeader></blog:CommentHeader>
<blog:CommentEntry></blog:CommentEntry>
<blog:CommentSeparator></blog:CommentSeparator>
<blog:CommentFooter></blog:CommentFooter>
<blog:Bottom></blog:Bottom>
</blog:Log>
|
格式说明:这个标记包含子多个子标记。除了蓝色的标记必须写在模板中,其他标记均可省略。标记的值放在 <xxxx></xxxx> 之间。属性(比如这里的 PageSize)与标记名称(比如这里的Blog:Log)必须用空白字符空开。可用的空白字符包括空格、TAB、换行符等字符。
标记的值与标记可以空开也可以写在一起。
各项属性、标记解释:
- <Blog:Log> 这是日志列表或显示内容页的标记,必须以</Blog:Log>收尾,功能上等同于基本标记 {ListLog}。
- PageSize 日志列表时每页显示的记录数,基本标记 {ListLog} 的 PageSize 取系统默认值(目前是10), 而在这里可以自行定义。
取值范围:1-99, 非法的 PageSize 将会使其取系统默认值。
- <Blog:Top> 列表和内容共同使用的头部。如果省略此标记,则输出空字符串""
此标记可访问的系统属性(和基本标记一样,它们用{}包围起来,以占位符的形式出现)
注意,以下几个属性是全局属性,可以在<Blog:Log>内部任何位置使用:
- {BlogTitle} Blog 的标题
- {BlogUrl} Blog 的地址(结合{BlogTitle}可以形成用户Blog的首页链接
- {BlogRemark} Blog 的说明
- {Page} 当前页面的页次(第几页)
- <ListHeader> 在日志列表前面显示的内容。如果省略此标记,则输出空字符串""
此标记可访问的属性,这几个属性是记录集属性:
- 所有的全局属性
- {PageSize} 每页的记录数
- {Count} 记录总数
- {ListCount} 当前页显示的记录数(在最后一页时可能会小于 PageSize)
- {PageNav} 分页导航
- <blog:ListEntry></blog:ListEntry> 列表中的每一条日志。这个标记不能省略
此标记可访问的属性,这些属性是日志属性:
- 所有的全局属性
- 所有的记录集属性
- {LogUrl} 日志的访问地址
- {LogTitle} 日志的标题
- {LogSummary} 日志的摘要
- {LogAuthor} 日志的作者
- {AuthorUrl} 日志的作者的链接地址(通常是Blog的首页)
- {ViewCount} 日志的浏览次数
- {CommentCount} 日志的评论次数
- {CommentUrl} 日志的评论地址
- {Class} 日志所在的分类
- {ClassUrl} 日志所在分类的地址
- {PublishTime Format="yyyy-mm-dd"} 日志发布时间,Format指定时间的输出格式,如果省略此属性,则使用缺省值"yyyy-mm-dd hh:nn"
可用的时间输出格式(其他的时间也使用此格式),以"2004-6-9 9:30:45" 为例:
- yyyy 4位年份,在这里就是 2004
- yy 2位年份,在这里就是 04
- mm 2位月份, 在这里就是 06
- m 1位月份(对于2位数的月份,仍然显示为2位数),在这里就是 4
- dd 2位天数,在这里就是 09
- d 1位天数(对于2位数的天数,仍然显示为2位数),在这里就是 9
- hh 2位小时数,在这里就是 09
- h 1位小时数(对于2位数的小时数,仍然显示为2位数),在这里就是 9
- nn 2位分钟数,在这里就是 30
- n 1位分钟数(对于2位数的分钟数,仍然显示为2位数),在这里就是 30
- ss 2位秒数,在这里就是 45
- s 1位秒数(对于2位数的秒数,仍然显示为2位数),在这里就是 45
- <blog:ListSeparator></blog:ListSeparator> 用来分隔每一条日志。如果省略此标记,则缺省地用"<p>"输出
此标记可访问的属性(不可访问日志属性):
- <blog:ListFooter></blog:ListFooter> 在日志列表结束后输出的内容。如果省略此标记,则输出空字符串""
此标记可访问的属性(不可访问日志属性):
- <blog:DetailHeader></blog:DetailHeader> 在日志详细内容前面显示的内容。如果省略此标记,则输出空字符串""
此标记可访问的属性,这几个属性是记录集属性:
- <blog:DetailContent></blog:DetailContent> 日志的详细内容。这个标记不能省略
此标记可访问的属性,这些属性是日志属性:
- 所有的全局属性
- 所有的记录集属性
- 所有的日志属性
- {LogContent} 日志内容
- {Icon} 日志作者的头像地址
- {NickName} 日志作者的昵称
- {Signature} 日志作者的签名(仅在日志中启用签名时有效)
- <blog:DetailFooter></blog:DetailFooter> 在日志内容结束后输出的内容。如果省略此标记,则输出空字符串""
此标记可访问的属性:
- <blog:CommentHeader></blog:CommentHeader> 在评论列表前面显示的内容。如果省略此标记,则输出空字符串""
此标记可访问的属性:
- <blog:CommentEntry></blog:CommentEntry> 日志评论列表中的每一条评论。这个标记不能省略
此标记可访问的属性,这些属性是评论属性:
- 所有的全局属性
- 所有的记录集属性
- {CommentAuthor} 评论者
- {CommentEmail} 评论者的 E-mail. 仅在可用时才会输出
- {CommentUrl} 评论者的主页地址. 仅在可用时才会输出
- {CommentIp} 评论者的 IP. 仅 Blog 发布者和管理员可见
- {CommentContent} 评论的内容
- {CommentTime Format="yyyy-mm-dd"} 评论时间。
Format 格式见 {PublishTime} 中关于 Format 的解释
- <blog:CommentSeparator></blog:CommentSeparator> 用来分隔每一条评论。如果省略此标记,则缺省地用"<p>"输出
此标记可访问的属性:
- <blog:CommentFooter></blog:CommentFooter> 在评论列中后面显示的内容。如果省略此标记,则输出空字符串""
此标记可访问的属性:
- <Blog:Bottom> 列表和内容共同使用的尾部。如果省略此标记,则输出空字符串""
|