# Permalinks

# Background

Prior to KduPress version 1.0.0, KduPress retrieved all Markdown files in the documents source directory and defined the page links based on the file hierarchy. For example, if you had the following file and directory structure:

├── package.json
└── source
    ├── _post
    │   └── intro-kdupress.md
    ├── index.md
    └── tags.md

You would then get the following pages:

/source/
/source/tags.html
/source/_post/intro-kdupress.html

But for blogs, a customized link of a post would be highly preferrable. KduPress version 1.0.0 introduced support for this feature, known as a permalink. With version 1.0.0 or newer, you instead get the following pages:

/source/
/source/tags/
/source/2018/4/1/intro-kdupress.html

This describes the beginning of how KduPress can be used for a blog!

# Permalinks

A permalink is a URL that is intended to remain unchanged for a long time, yielding a hyperlink that is less susceptible to what is known as link rot (opens new window). KduPress supports a flexible way to build permalinks, allowing you to use template variables.

The default permalink is /:regular.

# Configure Permalinks

You can enable permalinks globally for all pages:

// .kdupress/config.js
module.exports = {
  permalink: '/:year/:month/:day/:slug'
}

You can also set set a permalink for a single page only. This overrides the aforementioned global setting:

📝 hello.md:

---
title: Hello World
permalink: /hello-world
---

Hello!

# Template Variables