By default, content is laid out into the target publishdir (public) namespace matching its layout within the contentdir hierarchy. The permalinks site configuration option allows you to adjust this on a per-section basis. This will change where the files are written to and will change the page’s internal “canonical” location, such that template references to .RelPermalink will honour the adjustments made as a result of the mappings in this option.

For instance, if one of your sections is called post, and you want to adjust the canonical path to be hierarchical based on the year and month, then you might use:

permalinks:
post: /:year/:month/:title/


Only the content under post/ will be so rewritten. A file named content/post/sample-entry which contains a line date: 2013-11-18T19:20:00-05:00 might end up with the rendered page appearing at public/2013/11/sample-entry/index.html and be reachable via the URL http://yoursite.example.com/2013/11/sample-entry/.

The following is a list of values that can be used in a permalink definition. All references to time are dependent on the content’s date.

• :year 四碼數字的年份。 the 4-digit year
• :month 兩碼數字的月份。 the 2-digit month
• :monthname 月份的英文名。 the name of the month
• :day 兩碼數字的日期。 the 2-digit day
• :weekday 一碼數字的星期（如：Sunday = 0）。 the 1-digit day of the week (Sunday = 0)
• :weekdayname 星期的英文名。 the name of the day of the week
• :yearday 一至三碼的數字，一年當中的第幾日。 the 1- to 3-digit day of the year
• :section 內容的部分（content/"section"）。 the content’s section
• :title 內容的標題。 the content’s title
• :slug the content’s slug (or title if no slug)
• :filename 內容的檔名（不含副檔名）。 the content’s filename (without extension)