|
|
---
|
|
|
title: 页面变量
|
|
|
description: 每个页面所返回的变量
|
|
|
---
|
|
|
|
|
|
## 首页（index.ftl）
|
|
|
|
|
|
访问路径：`http://yourdomain`
|
|
|
|
|
|
### posts（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
[{
|
|
|
"content": [{
|
|
|
"categories": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2020-10-13T13:23:39.143Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaKeywords": "string",
|
|
|
"metas": {},
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "PUBLISHED",
|
|
|
"summary": "string",
|
|
|
"tags": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2020-10-13T13:23:39.143Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}],
|
|
|
"empty": true,
|
|
|
"first": true,
|
|
|
"last": true,
|
|
|
"number": 0,
|
|
|
"numberOfElements": 0,
|
|
|
"pageable": {
|
|
|
"page": 0,
|
|
|
"size": 0,
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"size": 0,
|
|
|
"sort": {
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"totalElements": 0,
|
|
|
"totalPages": 0
|
|
|
}]
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
遍历输出首页的文章：
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
<a href="${post.fullPath!}">${post.title!}</a>
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/archives/url1">title1</a>
|
|
|
<a href="http://localhost:8090/archives/url2">title2</a>
|
|
|
<a href="http://localhost:8090/archives/url3">title3</a>
|
|
|
```
|
|
|
|
|
|
## 文章页面（post.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，目前可以配置的有：
|
|
|
|
|
|
- `http://yourdomain/archives/{slug}`（默认）
|
|
|
- `http://yourdomain/1970/01/{slug}`
|
|
|
- `http://yourdomain/1970/01/01/{slug}`
|
|
|
- `http://yourdomain/?p={id}`
|
|
|
- `http://yourdomain/archives/{id}`
|
|
|
|
|
|
### post（Object）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
${post.attribute}
|
|
|
```
|
|
|
|
|
|
注：attribute 代表具体属性。
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"categories": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}
|
|
|
],
|
|
|
"categoryIds": [
|
|
|
0
|
|
|
],
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2021-02-25T13:15:58.589Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"formatContent": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaIds": [
|
|
|
0
|
|
|
],
|
|
|
"metaKeywords": "string",
|
|
|
"metas": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"id": 0,
|
|
|
"key": "string",
|
|
|
"postId": 0,
|
|
|
"value": "string"
|
|
|
}
|
|
|
],
|
|
|
"originalContent": "string",
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "DRAFT",
|
|
|
"summary": "string",
|
|
|
"tagIds": [
|
|
|
0
|
|
|
],
|
|
|
"tags": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}
|
|
|
],
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2021-02-25T13:15:58.589Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
获取文章标题：
|
|
|
|
|
|
```html
|
|
|
<span>${post.title!}</span>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<span>示例文章</span>
|
|
|
```
|
|
|
|
|
|
### prevPost（Object）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
${prevPost.attribute}
|
|
|
```
|
|
|
|
|
|
注：attribute 代表具体属性。
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"categories": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}
|
|
|
],
|
|
|
"categoryIds": [
|
|
|
0
|
|
|
],
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2021-02-25T13:15:58.589Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"formatContent": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaIds": [
|
|
|
0
|
|
|
],
|
|
|
"metaKeywords": "string",
|
|
|
"metas": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"id": 0,
|
|
|
"key": "string",
|
|
|
"postId": 0,
|
|
|
"value": "string"
|
|
|
}
|
|
|
],
|
|
|
"originalContent": "string",
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "DRAFT",
|
|
|
"summary": "string",
|
|
|
"tagIds": [
|
|
|
0
|
|
|
],
|
|
|
"tags": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}
|
|
|
],
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2021-02-25T13:15:58.589Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
获取上一篇文章的信息：
|
|
|
|
|
|
```html
|
|
|
<#if prevPost??>
|
|
|
<a href="${prevPost.fullPath!}">上一篇：${prevPost.title!}</a>
|
|
|
</#if>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/archives/url1">上一篇：title1</a>
|
|
|
```
|
|
|
|
|
|
### nextPost（Object）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
${nextPost.attribute}
|
|
|
```
|
|
|
|
|
|
注：attribute 代表具体属性。
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"categories": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}
|
|
|
],
|
|
|
"categoryIds": [
|
|
|
0
|
|
|
],
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2021-02-25T13:15:58.589Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"formatContent": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaIds": [
|
|
|
0
|
|
|
],
|
|
|
"metaKeywords": "string",
|
|
|
"metas": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"id": 0,
|
|
|
"key": "string",
|
|
|
"postId": 0,
|
|
|
"value": "string"
|
|
|
}
|
|
|
],
|
|
|
"originalContent": "string",
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "DRAFT",
|
|
|
"summary": "string",
|
|
|
"tagIds": [
|
|
|
0
|
|
|
],
|
|
|
"tags": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:15:58.589Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}
|
|
|
],
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2021-02-25T13:15:58.589Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
获取下一篇文章的信息：
|
|
|
|
|
|
```html
|
|
|
<#if nextPost??>
|
|
|
<a href="${nextPost.fullPath!}">下一篇：${nextPost.title!}</a>
|
|
|
</#if>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/archives/url3">下一篇：title3</a>
|
|
|
```
|
|
|
|
|
|
### categories（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list categories as category>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
[{
|
|
|
"createTime": "2021-02-25T13:32:11.189Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}]
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
获取文章的分类列表：
|
|
|
|
|
|
```html
|
|
|
<#list categories as category>
|
|
|
<a href="${category.fullPath!}">${category.name!}</a>
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/categories/url1">name1</a>
|
|
|
<a href="http://localhost:8090/categories/url2">name2</a>
|
|
|
```
|
|
|
|
|
|
### tags（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list tags as tag>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
[{
|
|
|
"createTime": "2021-02-25T13:34:48.779Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}]
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
获取文章的标签列表：
|
|
|
|
|
|
```html
|
|
|
<#list tags as tag>
|
|
|
<a href="${tag.fullPath!}">${tag.name!}</a>
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/tags/url1">name1</a>
|
|
|
<a href="http://localhost:8090/tags/url2">name2</a>
|
|
|
```
|
|
|
|
|
|
### metas（Object）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
${metas.key}
|
|
|
```
|
|
|
|
|
|
注：attribute 代表具体 key 值。
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
无
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
获取用户设置的音乐链接：
|
|
|
|
|
|
```html
|
|
|
<audio src="${metas.music_url}" controls="controls"></audio>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<audio src="/music.mp3" controls="controls"></audio>
|
|
|
```
|
|
|
|
|
|
## 自定义页面（sheet.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，默认为：`http://yourdomain/s/{slug}`
|
|
|
|
|
|
### sheet（Object）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
${sheet.attribute}
|
|
|
```
|
|
|
|
|
|
注：attribute 代表具体属性。
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2021-02-25T13:37:29.775Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2021-02-25T13:37:29.775Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"formatContent": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaIds": [
|
|
|
0
|
|
|
],
|
|
|
"metaKeywords": "string",
|
|
|
"metas": [
|
|
|
{
|
|
|
"createTime": "2021-02-25T13:37:29.775Z",
|
|
|
"id": 0,
|
|
|
"key": "string",
|
|
|
"postId": 0,
|
|
|
"value": "string"
|
|
|
}
|
|
|
],
|
|
|
"originalContent": "string",
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "DRAFT",
|
|
|
"summary": "string",
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2021-02-25T13:37:29.775Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
获取页面标题：
|
|
|
|
|
|
```html
|
|
|
<span>${sheet.title!}</span>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<span>示例页面</span>
|
|
|
```
|
|
|
|
|
|
### metas（Object）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
${metas.key}
|
|
|
```
|
|
|
|
|
|
注：attribute 代表具体 key 值。
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
无
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
获取用户设置的音乐链接：
|
|
|
|
|
|
```html
|
|
|
<audio src="${metas.music_url}" controls="controls"></audio>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<audio src="/music.mp3" controls="controls"></audio>
|
|
|
```
|
|
|
|
|
|
## 文章归档页面（archives.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，默认为：`http://yourdomain/archives`
|
|
|
|
|
|
### posts（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
[{
|
|
|
"content": [{
|
|
|
"categories": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2020-10-13T13:23:39.143Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaKeywords": "string",
|
|
|
"metas": {},
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "PUBLISHED",
|
|
|
"summary": "string",
|
|
|
"tags": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2020-10-13T13:23:39.143Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}],
|
|
|
"empty": true,
|
|
|
"first": true,
|
|
|
"last": true,
|
|
|
"number": 0,
|
|
|
"numberOfElements": 0,
|
|
|
"pageable": {
|
|
|
"page": 0,
|
|
|
"size": 0,
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"size": 0,
|
|
|
"sort": {
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"totalElements": 0,
|
|
|
"totalPages": 0
|
|
|
}]
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
遍历输出归档页面的文章（无年份分组）：
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
<a href="${post.fullPath!}">${post.title!}</a>
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/archives/url1">title1</a>
|
|
|
<a href="http://localhost:8090/archives/url2">title2</a>
|
|
|
<a href="http://localhost:8090/archives/url3">title3</a>
|
|
|
```
|
|
|
|
|
|
### archives（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list archives.content as archive>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"content": [{
|
|
|
"posts": [{
|
|
|
"categories": [{
|
|
|
"createTime": "2021-03-07T05:45:06.271Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2021-03-07T05:45:06.271Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2021-03-07T05:45:06.271Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaKeywords": "string",
|
|
|
"metas": {},
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "DRAFT",
|
|
|
"summary": "string",
|
|
|
"tags": [{
|
|
|
"createTime": "2021-03-07T05:45:06.271Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2021-03-07T05:45:06.271Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}],
|
|
|
"year": 0
|
|
|
}],
|
|
|
"hasContent": true,
|
|
|
"hasNext": true,
|
|
|
"hasPrevious": true,
|
|
|
"isEmpty": true,
|
|
|
"isFirst": true,
|
|
|
"page": 0,
|
|
|
"pages": 0,
|
|
|
"rpp": 0,
|
|
|
"total": 0
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
遍历输出归档页面的文章（有年份分组）：
|
|
|
|
|
|
```html
|
|
|
<#list archives.content as archive>
|
|
|
<h1>${archive.year?c}</h1>
|
|
|
<#list archive.posts as post>
|
|
|
<a href="${post.fullPath!}">${post.title!}</a>
|
|
|
</#list>
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<h1>2021</h1>
|
|
|
<a href="http://localhost:8090/archives/url1">title1</a>
|
|
|
<a href="http://localhost:8090/archives/url2">title2</a>
|
|
|
<a href="http://localhost:8090/archives/url3">title3</a>
|
|
|
<h1>2020</h1>
|
|
|
<a href="http://localhost:8090/archives/url4">title4</a>
|
|
|
<a href="http://localhost:8090/archives/url5">title5</a>
|
|
|
<a href="http://localhost:8090/archives/url6">title6</a>
|
|
|
```
|
|
|
|
|
|
## 分类目录页面（categories.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，默认为：`http://yourdomain/categories`
|
|
|
|
|
|
此页面无页面变量，可以使用 [模板标签](/developer-guide/theme/template-tag) 获取分类列表。
|
|
|
|
|
|
## 单个分类所属文章页面（category.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，默认为：`http://yourdomain/categories/{slug}`
|
|
|
|
|
|
### posts（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
[{
|
|
|
"content": [{
|
|
|
"categories": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2020-10-13T13:23:39.143Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaKeywords": "string",
|
|
|
"metas": {},
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "PUBLISHED",
|
|
|
"summary": "string",
|
|
|
"tags": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2020-10-13T13:23:39.143Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}],
|
|
|
"empty": true,
|
|
|
"first": true,
|
|
|
"last": true,
|
|
|
"number": 0,
|
|
|
"numberOfElements": 0,
|
|
|
"pageable": {
|
|
|
"page": 0,
|
|
|
"size": 0,
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"size": 0,
|
|
|
"sort": {
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"totalElements": 0,
|
|
|
"totalPages": 0
|
|
|
}]
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
遍历输出某个分类的文章：
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
<a href="${post.fullPath!}">${post.title!}</a>
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/archives/url1">title1</a>
|
|
|
<a href="http://localhost:8090/archives/url2">title2</a>
|
|
|
<a href="http://localhost:8090/archives/url3">title3</a>
|
|
|
```
|
|
|
|
|
|
### category（Object）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
${category.attribute}
|
|
|
```
|
|
|
|
|
|
注：attribute 代表具体属性。
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"createTime": "2020-10-11T05:59:40.622Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string",
|
|
|
"postCount": 0
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
```html
|
|
|
<a href="${category.fullPath!}">分类：${category.name!}</a>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/categories/url1">分类：name1</a>
|
|
|
```
|
|
|
|
|
|
## 标签页面（tags.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，默认为：`http://yourdomain/tags`
|
|
|
|
|
|
此页面无页面变量，可以使用 [模板标签](/developer-guide/theme/template-tag) 获取标签列表。
|
|
|
|
|
|
## 单个标签所属文章页面（tag.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，默认为：`http://yourdomain/tags/{slug}`
|
|
|
|
|
|
### posts（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
[{
|
|
|
"content": [{
|
|
|
"categories": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2020-10-13T13:23:39.143Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaKeywords": "string",
|
|
|
"metas": {},
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "PUBLISHED",
|
|
|
"summary": "string",
|
|
|
"tags": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2020-10-13T13:23:39.143Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}],
|
|
|
"empty": true,
|
|
|
"first": true,
|
|
|
"last": true,
|
|
|
"number": 0,
|
|
|
"numberOfElements": 0,
|
|
|
"pageable": {
|
|
|
"page": 0,
|
|
|
"size": 0,
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"size": 0,
|
|
|
"sort": {
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"totalElements": 0,
|
|
|
"totalPages": 0
|
|
|
}]
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
遍历输出某个标签的文章：
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
<a href="${post.fullPath!}">${post.title!}</a>
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/archives/url1">title1</a>
|
|
|
<a href="http://localhost:8090/archives/url2">title2</a>
|
|
|
<a href="http://localhost:8090/archives/url3">title3</a>
|
|
|
```
|
|
|
|
|
|
### tag（Object）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
${tag.attribute}
|
|
|
```
|
|
|
|
|
|
注：attribute 代表具体属性。
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"createTime": "2020-10-11T06:14:30.595Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
```html
|
|
|
<a href="${tag.fullPath!}">标签：${tag.name!}</a>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/tags/url1">标签：name1</a>
|
|
|
```
|
|
|
|
|
|
## 文章搜索结果页面（search.ftl）
|
|
|
|
|
|
访问路径：`http://yourdomain/search?keyword=keyword`
|
|
|
|
|
|
### keyword（String）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
${keyword!}
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
无
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
```html
|
|
|
搜索关键字为：${keyword!}
|
|
|
```
|
|
|
|
|
|
### posts（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
[{
|
|
|
"content": [{
|
|
|
"categories": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"description": "string",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"parentId": 0,
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"commentCount": 0,
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"disallowComment": true,
|
|
|
"editTime": "2020-10-13T13:23:39.143Z",
|
|
|
"editorType": "MARKDOWN",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"metaDescription": "string",
|
|
|
"metaKeywords": "string",
|
|
|
"metas": {},
|
|
|
"password": "string",
|
|
|
"slug": "string",
|
|
|
"status": "PUBLISHED",
|
|
|
"summary": "string",
|
|
|
"tags": [{
|
|
|
"createTime": "2020-10-13T13:23:39.143Z",
|
|
|
"fullPath": "string",
|
|
|
"id": 0,
|
|
|
"name": "string",
|
|
|
"slug": "string",
|
|
|
"thumbnail": "string"
|
|
|
}],
|
|
|
"template": "string",
|
|
|
"thumbnail": "string",
|
|
|
"title": "string",
|
|
|
"topPriority": 0,
|
|
|
"topped": true,
|
|
|
"updateTime": "2020-10-13T13:23:39.143Z",
|
|
|
"visits": 0,
|
|
|
"wordCount": 0
|
|
|
}],
|
|
|
"empty": true,
|
|
|
"first": true,
|
|
|
"last": true,
|
|
|
"number": 0,
|
|
|
"numberOfElements": 0,
|
|
|
"pageable": {
|
|
|
"page": 0,
|
|
|
"size": 0,
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"size": 0,
|
|
|
"sort": {
|
|
|
"sort": [
|
|
|
"string"
|
|
|
]
|
|
|
},
|
|
|
"totalElements": 0,
|
|
|
"totalPages": 0
|
|
|
}]
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
遍历输出某个搜索结果的文章：
|
|
|
|
|
|
```html
|
|
|
<#list posts.content as post>
|
|
|
<a href="${post.fullPath!}">${post.title!}</a>
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<a href="http://localhost:8090/archives/url1">title1</a>
|
|
|
<a href="http://localhost:8090/archives/url2">title2</a>
|
|
|
<a href="http://localhost:8090/archives/url3">title3</a>
|
|
|
```
|
|
|
|
|
|
## 友情链接页面（links.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，默认为：`http://yourdomain/links`
|
|
|
|
|
|
此页面无页面变量，可以使用 [模板标签](/developer-guide/theme/template-tag) 获取友情链接列表。
|
|
|
|
|
|
## 图库页面（photos.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，默认为：`http://yourdomain/photos`
|
|
|
|
|
|
### photos（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list photos.content as photo>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"content": [{
|
|
|
"description": "string",
|
|
|
"id": 0,
|
|
|
"location": "string",
|
|
|
"name": "string",
|
|
|
"takeTime": "2021-03-07T05:28:12.352Z",
|
|
|
"team": "string",
|
|
|
"thumbnail": "string",
|
|
|
"url": "string"
|
|
|
}],
|
|
|
"hasContent": true,
|
|
|
"hasNext": true,
|
|
|
"hasPrevious": true,
|
|
|
"isEmpty": true,
|
|
|
"isFirst": true,
|
|
|
"page": 0,
|
|
|
"pages": 0,
|
|
|
"rpp": 0,
|
|
|
"total": 0
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
```html
|
|
|
<#list photos.content as photo>
|
|
|
<img alt="${photo.description!}" src="${photo.url!}"/>
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<img alt="山川" src="https://youdomain.com/upload/2021/01/1.png"/>
|
|
|
<img alt="河流" src="https://youdomain.com/upload/2021/01/2.png"/>
|
|
|
<img alt="绿树" src="https://youdomain.com/upload/2021/01/3.png"/>
|
|
|
```
|
|
|
|
|
|
## 日志页面（journals.ftl）
|
|
|
|
|
|
访问路径不固定，视固定链接配置而定，默认为：`http://yourdomain/journals`
|
|
|
|
|
|
### journals（List）
|
|
|
|
|
|
#### 语法
|
|
|
|
|
|
```html
|
|
|
<#list journals.content as journal>
|
|
|
// do something
|
|
|
</#list>
|
|
|
```
|
|
|
|
|
|
#### 参数
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"content": [{
|
|
|
"commentCount": 0,
|
|
|
"content": "string",
|
|
|
"createTime": "2021-03-07T05:32:06.365Z",
|
|
|
"id": 0,
|
|
|
"likes": 0,
|
|
|
"sourceContent": "string",
|
|
|
"type": "INTIMATE"
|
|
|
}],
|
|
|
"hasContent": true,
|
|
|
"hasNext": true,
|
|
|
"hasPrevious": true,
|
|
|
"isEmpty": true,
|
|
|
"isFirst": true,
|
|
|
"page": 0,
|
|
|
"pages": 0,
|
|
|
"rpp": 0,
|
|
|
"total": 0
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### 示例
|
|
|
|
|
|
```html
|
|
|
<ul>
|
|
|
<#list journals.content as journal>
|
|
|
<li>
|
|
|
${journal.createTime?string('yyyy年MM月dd日')}：${journal.content!}
|
|
|
</li>
|
|
|
</#list>
|
|
|
</ul>
|
|
|
```
|
|
|
|
|
|
输出：
|
|
|
|
|
|
```html
|
|
|
<ul>
|
|
|
<li>
|
|
|
2021年3月7日：内容1
|
|
|
</li>
|
|
|
<li>
|
|
|
2021年3月7日：内容2
|
|
|
</li>
|
|
|
</ul>
|
|
|
```
|
