IkeqIkeq

The whole problem with the world is that fools and fanatics are always so certain of themselves, but wiser people so full of doubts.

6Archives4Categories14Tags

Inside Theme — Content Configuration

Jun 21, 2019

Table of Contents (TOC)

The TOC appears on the right side of article pages, listing all headings for quick navigation.

1
2
3
4
5
6
7
toc:
  # Maximum heading depth to include (1–4, default: 3)
  depth: 3

  # Show numeric prefixes like "1.1", "1.2" before each heading
  # Default: true. Set false to hide.
  index: true

To disable TOC for a specific post or page, use front-matter:

1
2
3
---
toc: false
---

Reading Time

Display estimated reading time at the top of each post:

1
2
3
4
5
6
7
post:
  reading_time:
    # Words per minute. Default: 150
    wpm: 150

    # Display template. Variables: :words (word count), :minutes (estimated minutes)
    text: ":words words · :minutes min read"

To disable reading time globally:

1
2
post:
  reading_time: false

Or disable it per post:

1
2
3
---
reading_time: false
---

Pagination

Control how many items appear per page on list views:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# Homepage post list
index_generator:
  path: ''
  per_page: 5
  order_by: -date

# Archive pages
archive:
  per_page: 10

# Tag pages
tag:
  per_page: 10

# Category pages
category:
  per_page: 10

Set per_page: 0 to disable pagination entirely on any list type.

Reward (Tip Jar)

Enable a “buy me a coffee” section at the bottom of posts:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
reward:
  # Heading text
  text: "Enjoyed this post? Buy me a coffee ☕"

  # Payment methods — qrcode, url, and text are mutually exclusive
  # For wechat, alipay, paypal, bitcoin: icon is auto-provided
  methods:
    - name: paypal
      url: https://paypal.me/username
      text: PayPal.me link

    - name: wechat
      qrcode: /images/wechat-qrcode.jpg
      color: '#09bb07'

    - name: alipay
      qrcode: /images/alipay-qrcode.jpg
      color: '#1677ff'

    # Custom payment with no built-in icon
    - name: kofi
      url: https://ko-fi.com/username
      text: Support on Ko-fi

Enable reward for all posts by default, and override per post via front-matter:

1
2
post:
  reward: true

Add a copyright block at the bottom of each post:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
copyright:
  # Show author's name. Default: true
  author: true

  # Show post URL. Default: true
  link: true

  # License text. Set to false to hide.
  license: |
    <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/"
       rel="external nofollow noopener" target="_blank">
      CC BY-NC-SA 4.0
    </a>

  # Show publish date. Default: false
  published: true

  # Show last-updated date. Default: false
  updated: true

  # Override all above with custom HTML
  # custom: "No reproduction without permission."

Override per post via front-matter:

1
2
3
4
5
6
7
---
copyright: false              # Disable entirely
copyright:                   # Or customize
  author: false
  license: false
  custom: "All rights reserved."
---

Disabling Features Per Post

All of the above can be controlled per-post via front-matter, overriding the global config:

1
2
3
4
5
6
7
---
title: My Post
date: 2026-03-28 12:00:00
toc: false          # No TOC for this post
reward: false      # No tip jar
copyright: false   # No copyright block
---

Next Steps

Buy me a cup of milk 🥛.

支
Table of Contents (TOC)
Reading Time
Pagination
Reward (Tip Jar)
Copyright Notice
Disabling Features Per Post
Next Steps