Skip to content

Commit f8a456d

Browse files
ashmaroliashmaroli
authored
Render HTML tables at /docs/permalinks/ using a data file (#9666)
Merge pull request 9666
1 parent 0f03b31 commit f8a456d

2 files changed

Lines changed: 164 additions & 343 deletions

File tree

‎docs/_data/permalinks.yml‎

Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
placeholders:
2+
- name: year
3+
desc: >-
4+
Year from the post's filename with four digits. May be overridden via the document's
5+
<code>date</code> front matter.
6+
- name: short_year
7+
desc: >-
8+
Year from the post's filename without the century. (00..99) May be overridden via the
9+
document's <code>date</code> front matter.
10+
- name: month
11+
desc: >-
12+
Month from the post's filename. (01..12) May be overridden via the document's
13+
<code>date</code> front matter.
14+
- name: i_month
15+
desc: >-
16+
Month without leading zeros from the post's filename. May be overridden via the document's
17+
<code>date</code> front matter.
18+
- name: short_month
19+
desc: >-
20+
Three-letter month abbreviation, e.g. "Jan".
21+
- name: long_month
22+
intro_ver: "4.0"
23+
desc: >-
24+
Full month name, e.g. "January".
25+
- name: day
26+
desc: >-
27+
Day of the month from the post's filename. (01..31) May be overridden via the document's
28+
<code>date</code> front matter.
29+
- name: i_day
30+
desc: >-
31+
Day of the month without leading zeros from the post's filename. May be overridden via the
32+
document's <code>date</code> front matter.
33+
- name: y_day
34+
desc: >-
35+
Ordinal day of the year from the post's filename, with leading zeros. (001..366)
36+
- name: w_year
37+
intro_ver: "4.0"
38+
desc: >-
39+
Week year which may differ from the month year for up to three days at the start of January
40+
and end of December
41+
- name: week
42+
intro_ver: "4.0"
43+
desc: >-
44+
Week number of the current year, starting with the first week having a majority of its days
45+
in January. (01..53)
46+
- name: w_day
47+
intro_ver: "4.0"
48+
desc: >-
49+
Day of the week, starting with Monday. (1..7)
50+
- name: short_day
51+
intro_ver: "4.0"
52+
desc: >-
53+
Three-letter weekday abbreviation, e.g. "Sun".
54+
- name: long_day
55+
intro_ver: "4.0"
56+
desc: >-
57+
Weekday name, e.g. "Sunday".
58+
- name: hour
59+
desc: >-
60+
Hour of the day, 24-hour clock, zero-padded from the post's <code>date</code> front matter. (00..23)
61+
- name: minute
62+
desc: >-
63+
Minute of the hour from the post's <code>date</code> front matter. (00..59)
64+
- name: second
65+
desc: >-
66+
Second of the minute from the post's <code>date</code> front matter. (00..59)
67+
- name: title
68+
desc: >-
69+
Title from the document's filename. May be overridden via the document's
70+
<code>slug</code> front matter. Preserves case from the source.
71+
- name: slug
72+
desc: >-
73+
Slugified title from the document's filename (any character except numbers and letters is
74+
replaced as hyphen). May be overridden via the document's <code>slug</code> front matter.
75+
- name: categories
76+
desc: >-
77+
The specified categories for this post. If a post has multiple categories, Jekyll will create
78+
a hierarchy (e.g. <code>/category1/category2</code>). Also Jekyll automatically parses out
79+
double slashes in the URLs, so if no categories are present, it will ignore this.
80+
- name: slugified_categories
81+
intro_ver: "4.1"
82+
desc: >-
83+
The specified categories for this post but <em>slugified</em>. If a category is a composite of
84+
multiple words, Jekyll will downcase all alphabets and replace any non-alphanumeric character
85+
with a hyphen. (e.g. <code>"Work 2 Progress"</code> will be converted into
86+
<code>"work-2-progress"</code>). If a post has multiple categories, Jekyll will create
87+
a hierarchy (e.g. <code>/work-2-progress/category2</code>). Also Jekyll automatically parses
88+
out double slashes in the URLs, so if no categories are present, it will ignore this.
89+
- name: output_ext
90+
desc: >-
91+
Extension of the output file. (Included by default and usually unnecessary.)
92+
93+
builtin_formats:
94+
- name: date
95+
format: "/:categories/:year/:month/:day/:title:output_ext"
96+
- name: pretty
97+
format: "/:categories/:year/:month/:day/:title/"
98+
- name: ordinal
99+
format: "/:categories/:year/:y_day/:title:output_ext"
100+
- name: weekdate
101+
intro_ver: "4.0"
102+
format: "/:categories/:year/W:week/:short_day/:title:output_ext"
103+
note: "<code>W</code> will be prefixed to the value of <code>:week</code>"
104+
- name: none
105+
format: "/:categories/:title:output_ext"
106+
107+
types:
108+
documents:
109+
- name: collection
110+
desc: >-
111+
Label of the containing collection.
112+
- name: path
113+
desc: >-
114+
Path to the document relative to the collection's directory, including base filename of the document.
115+
However, does not include the file extension.
116+
- name: name
117+
desc: >-
118+
The document's base filename but slugified: downcased and every sequence of non-alphanumeric character
119+
(including spaces) replaced by a hyphen.
120+
- name: title
121+
desc: >-
122+
Takes on the value of front matter key <code>slug</code> if defined for the document. Otherwise takes
123+
on the string value generated from the document's base filename by piping through the <code>slugify</code>
124+
filter method with <code>pretty</code> option.<br/>
125+
Regardless of the value taken, the case of the alphabets are preserved instead of being replaced with
126+
lowercase counterparts.
127+
- name: output_ext
128+
desc: >-
129+
Extension of the output file. (Included by default and usually unnecessary.)
130+
pages:
131+
- name: path
132+
desc: >-
133+
Path between the source directory and the base filename of the page.
134+
- name: basename
135+
desc: >-
136+
The page's base filename.
137+
- name: output_ext
138+
desc: >-
139+
Extension of the output file. (Included by default and usually unnecessary.)

0 commit comments

Comments
 (0)