summaryrefslogtreecommitdiff
path: root/wiki/features/single-page-parameters.md
blob: 0bf62b086adffa322a5ec5c75a9bfd491b353d97 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
---
title: "Single Page Parameters"
date: "2024-10-09"
summary: "Single Page Parameters parameters"
description: "Single Page Parameters parameters"
toc: false
readTime: false
autonumber: true
math: false
showTags: false
---

The following parameters apply to single pages, they are meant to be inserted in the `.md` files introductions, apart from the date format.

## Table of Contents

Show a table of contents at the beginning of the post.

```md
toc: true
```

## Sections Auto-numbering

Auto-number headings.

```md
autonumber: true
```

Note that headings should start from level two.

## Math Rendering

Enable math rendering.

```md
math: true
```

## Tags

Create tags associated with the post and decide to show them.

```md
tags: ["database", "java"]
showTags: false
```

## Display Read Time

Choose to display reading time.

```md
readTime: true
```

## Hide Back to Top

Choose to display back to top at the end of the page.

```md
hideBackToTop: true
```

## Hide Pagination Controls

Choose to display pagination controls at the end of the page.

```md
hidePagination: true
```

## Meta Description

You can specify the post meta description as follows: 

```md
description: "Your Description"
```

## Fediverse

You can include a [fediverse handle](https://blog.joinmastodon.org/2024/07/highlighting-journalism-on-mastodon/) in your posts.

```md
fediverse: "@username@instance.url"
```

## Date Format

You can decide the date format to apply to single posts by setting the following param in the toml file: 

```toml
[params]
singleDateFormat = '2 January 2006'
```