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.

19Archives5Categories27Tags

Inside Theme — Front-Matter

Jun 21, 2019

Front-matter is the YAML block at the top of every Markdown file. It controls how Hexo and Inside render that specific piece of content.

Hexo Standard Fields

These are understood by Hexo itself, regardless of theme:

1
2
3
4
5
6
7
8
9
10
11
12
13
---
title: "Post Title"           # Display title (auto-extracted from filename if omitted)
date: 2026-03-28 12:00:00      # Publish date
updated: 2026-03-28 14:00:00   # Last modified date
comments: true                 # Enable/disable comments (default: true)
tags:                          # List of tags
  - web
  - javascript
categories:                    # List of categories
  - 技术
permalink: /custom-url/        # Override the auto-generated URL slug
layout: post                   # Layout type (post / page)
---

Inside Post-Specific Fields

These fields apply only to posts (files in source/_posts/):

Thumbnail

The thumbnail appears in post cards on the list page and as the header image on the post itself.

1
2
3
4
5
6
7
8
---
# Single value = image path or URL
thumbnail: landscape.jpg
thumbnail: https://example.com/cover.jpg

# Image + background color fallback
thumbnail: 'landscape.jpg #111'
---

The image path is resolved relative to source/. Place image files in source/images/ and reference them as images/filename.jpg.

Sticky

Pin a post to the top of the archive list:

1
2
3
---
sticky: 1   # Higher numbers sort higher. Default: 0 (no sticky).
---

Posts are sorted by sticky descending, then by date descending.

Visible

Exclude a post from site search and sitemap while still publishing it:

1
2
3
---
visible: false   # Hidden from list pages and sitemap (default: true)
---

Per-Page Feature Overrides

These fields work on both posts and pages. They override the global theme config for that specific item:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
# Table of contents for this page
toc: false          # Default: true (from theme config)

# Reward/tip jar for this post
reward: true        # Default: false

# Copyright block for this post
copyright: false    # Default: false

# Copyright with custom text (overrides global settings)
copyright:
  author: false
  license: false
  custom: "All rights reserved. No reproduction."
---

Content Flags

1
2
3
4
5
6
7
8
9
10
11
---
# Drop cap: enlarge the first letter of the article
dropcap: true

# Hide this page from search engine indexing
# (renders a <meta name="robots" content="noindex"> in <head>)
 robots: noindex

# Use a different layout template
layout: page    # Use the "page" layout instead of "post"
---

Metadata Display

Control what meta information appears below the title:

1
2
3
4
5
6
7
8
9
10
---
# Show date, author, reading time below the title (pages only)
meta: true      # Default: true for pages, false for posts

# Show author name
author: Ikeq

# Hide the date on this post
date: false
---

Encrypted Content

Password-protect a post so only readers with the correct code can read it:

1
2
3
4
5
---
secret: my-secret-password
---

The encrypted content goes here.

The reader will see a password prompt instead of the article body. This uses Inside’s built-in cipher plugin. See Tag Plugins → for partial encryption (encrypting only a section of content).

Complete Post Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
---
title: "Practical LLM Tool Use"
date: 2026-03-28 10:50:00
author: Ikeq
thumbnail: https://images.unsplash.com/photo-1555949963.jpg
tags:
  - AI
  - LLM
  - engineering
categories:
  - 技术
toc: true
reward: false
copyright: true
sticky: 0
visible: true
---

Your post content here.

<!-- more -->

Rest of the article...

Complete Page Example

1
2
3
4
5
6
7
8
---
title: About
date: 2017-08-07 15:21:18
meta: true
toc: false
---

Page content here...

Next Steps

Buy me a cup of milk 🥛.

支
Hexo Standard Fields
Inside Post-Specific Fields
Thumbnail
Sticky
Visible
Per-Page Feature Overrides
Content Flags
Metadata Display
Encrypted Content
Complete Post Example
Complete Page Example
Next Steps