Fix a markdown rendering difference warning.

Rust is going to change its Markdown rendering engine from hoedown to
pulldown-cmark. In pulldown, a table row starting with just whitespaces
will cause that whole cell disappeared. This causes rendering difference
between the two engines.

To fix this, we add leading and trailing `|` to the rows so that empty
cells are correctly rendered.
This commit is contained in:
kennytm 2018-01-22 02:25:40 +08:00
parent 232a0f1255
commit 8a6a99018a
No known key found for this signature in database
GPG Key ID: FEF6C8051D0E013C
1 changed files with 71 additions and 71 deletions

View File

@ -8,77 +8,77 @@
The following specifiers are available both to formatting and parsing. The following specifiers are available both to formatting and parsing.
Spec. | Example | Description | Spec. | Example | Description |
----- | ------------- | ----------- |-------|----------|----------------------------------------------------------------------------|
| | **DATE SPECIFIERS:** | | | **DATE SPECIFIERS:** |
`%Y` | `2001` | The full proleptic Gregorian year, zero-padded to 4 digits. [1] | `%Y` | `2001` | The full proleptic Gregorian year, zero-padded to 4 digits. [1] |
`%C` | `20` | The proleptic Gregorian year divided by 100, zero-padded to 2 digits. [2] | `%C` | `20` | The proleptic Gregorian year divided by 100, zero-padded to 2 digits. [2] |
`%y` | `01` | The proleptic Gregorian year modulo 100, zero-padded to 2 digits. [2] | `%y` | `01` | The proleptic Gregorian year modulo 100, zero-padded to 2 digits. [2] |
| | | | | |
`%m` | `07` | Month number (01--12), zero-padded to 2 digits. | `%m` | `07` | Month number (01--12), zero-padded to 2 digits. |
`%b` | `Jul` | Abbreviated month name. Always 3 letters. | `%b` | `Jul` | Abbreviated month name. Always 3 letters. |
`%B` | `July` | Full month name. Also accepts corresponding abbreviation in parsing. | `%B` | `July` | Full month name. Also accepts corresponding abbreviation in parsing. |
`%h` | `Jul` | Same to `%b`. | `%h` | `Jul` | Same to `%b`. |
| | | | | |
`%d` | `08` | Day number (01--31), zero-padded to 2 digits. | `%d` | `08` | Day number (01--31), zero-padded to 2 digits. |
`%e` | ` 8` | Same to `%d` but space-padded. Same to `%_d`. | `%e` | ` 8` | Same to `%d` but space-padded. Same to `%_d`. |
| | | | | |
`%a` | `Sun` | Abbreviated weekday name. Always 3 letters. | `%a` | `Sun` | Abbreviated weekday name. Always 3 letters. |
`%A` | `Sunday` | Full weekday name. Also accepts corresponding abbreviation in parsing. | `%A` | `Sunday` | Full weekday name. Also accepts corresponding abbreviation in parsing. |
`%w` | `0` | Sunday = 0, Monday = 1, ..., Saturday = 6. | `%w` | `0` | Sunday = 0, Monday = 1, ..., Saturday = 6. |
`%u` | `7` | Monday = 1, Tuesday = 2, ..., Sunday = 7. (ISO 8601) | `%u` | `7` | Monday = 1, Tuesday = 2, ..., Sunday = 7. (ISO 8601) |
| | | | | |
`%U` | `28` | Week number starting with Sunday (00--53), zero-padded to 2 digits. [3] | `%U` | `28` | Week number starting with Sunday (00--53), zero-padded to 2 digits. [3] |
`%W` | `27` | Same to `%U`, but week 1 starts with the first Monday in that year instead. | `%W` | `27` | Same to `%U`, but week 1 starts with the first Monday in that year instead.|
| | | | | |
`%G` | `2001` | Same to `%Y` but uses the year number in ISO 8601 week date. [4] | `%G` | `2001` | Same to `%Y` but uses the year number in ISO 8601 week date. [4] |
`%g` | `01` | Same to `%y` but uses the year number in ISO 8601 week date. [4] | `%g` | `01` | Same to `%y` but uses the year number in ISO 8601 week date. [4] |
`%V` | `27` | Same to `%U` but uses the week number in ISO 8601 week date (01--53). [4] | `%V` | `27` | Same to `%U` but uses the week number in ISO 8601 week date (01--53). [4] |
| | | | | |
`%j` | `189` | Day of the year (001--366), zero-padded to 3 digits. | `%j` | `189` | Day of the year (001--366), zero-padded to 3 digits. |
| | | | | |
`%D` | `07/08/01` | Month-day-year format. Same to `%m/%d/%y`. | `%D` | `07/08/01` | Month-day-year format. Same to `%m/%d/%y`. |
`%x` | `07/08/01` | Same to `%D`. | `%x` | `07/08/01` | Same to `%D`. |
`%F` | `2001-07-08` | Year-month-day format (ISO 8601). Same to `%Y-%m-%d`. | `%F` | `2001-07-08` | Year-month-day format (ISO 8601). Same to `%Y-%m-%d`. |
`%v` | ` 8-Jul-2001` | Day-month-year format. Same to `%e-%b-%Y`. | `%v` | ` 8-Jul-2001` | Day-month-year format. Same to `%e-%b-%Y`. |
| | | | | |
| | **TIME SPECIFIERS:** | | | **TIME SPECIFIERS:** |
`%H` | `00` | Hour number (00--23), zero-padded to 2 digits. | `%H` | `00` | Hour number (00--23), zero-padded to 2 digits. |
`%k` | ` 0` | Same to `%H` but space-padded. Same to `%_H`. | `%k` | ` 0` | Same to `%H` but space-padded. Same to `%_H`. |
`%I` | `12` | Hour number in 12-hour clocks (01--12), zero-padded to 2 digits. | `%I` | `12` | Hour number in 12-hour clocks (01--12), zero-padded to 2 digits. |
`%l` | `12` | Same to `%I` but space-padded. Same to `%_I`. | `%l` | `12` | Same to `%I` but space-padded. Same to `%_I`. |
| | | | | |
`%P` | `am` | `am` or `pm` in 12-hour clocks. | `%P` | `am` | `am` or `pm` in 12-hour clocks. |
`%p` | `AM` | `AM` or `PM` in 12-hour clocks. | `%p` | `AM` | `AM` or `PM` in 12-hour clocks. |
| | | | | |
`%M` | `34` | Minute number (00--59), zero-padded to 2 digits. | `%M` | `34` | Minute number (00--59), zero-padded to 2 digits. |
`%S` | `60` | Second number (00--60), zero-padded to 2 digits. [5] | `%S` | `60` | Second number (00--60), zero-padded to 2 digits. [5] |
`%f` | `026490000` | The fractional seconds (in nanoseconds) since last whole second. [8] | `%f` | `026490000` | The fractional seconds (in nanoseconds) since last whole second. [8] |
`%.f` | `.026490` | Similar to `.%f` but left-aligned. These all consume the leading dot. [8] | `%.f` | `.026490`| Similar to `.%f` but left-aligned. These all consume the leading dot. [8] |
`%.3f`| `.026` | Similar to `.%f` but left-aligned but fixed to a length of 3. [8] | `%.3f`| `.026` | Similar to `.%f` but left-aligned but fixed to a length of 3. [8] |
`%.6f`| `.026490` | Similar to `.%f` but left-aligned but fixed to a length of 6. [8] | `%.6f`| `.026490` | Similar to `.%f` but left-aligned but fixed to a length of 6. [8] |
`%.9f`| `.026490000` | Similar to `.%f` but left-aligned but fixed to a length of 9. [8] | `%.9f`| `.026490000` | Similar to `.%f` but left-aligned but fixed to a length of 9. [8] |
| | | | | |
`%R` | `00:34` | Hour-minute format. Same to `%H:%M`. | `%R` | `00:34` | Hour-minute format. Same to `%H:%M`. |
`%T` | `00:34:60` | Hour-minute-second format. Same to `%H:%M:%S`. | `%T` | `00:34:60` | Hour-minute-second format. Same to `%H:%M:%S`. |
`%X` | `00:34:60` | Same to `%T`. | `%X` | `00:34:60` | Same to `%T`. |
`%r` | `12:34:60 AM` | Hour-minute-second format in 12-hour clocks. Same to `%I:%M:%S %p`. | `%r` | `12:34:60 AM` | Hour-minute-second format in 12-hour clocks. Same to `%I:%M:%S %p`. |
| | | | | |
| | **TIME ZONE SPECIFIERS:** | | | **TIME ZONE SPECIFIERS:** |
`%Z` | `ACST` | *Formatting only:* Local time zone name. | `%Z` | `ACST` | *Formatting only:* Local time zone name. |
`%z` | `+0930` | Offset from the local time to UTC (with UTC being `+0000`). | `%z` | `+0930` | Offset from the local time to UTC (with UTC being `+0000`). |
`%:z` | `+09:30` | Same to `%z` but with a colon. | `%:z` | `+09:30` | Same to `%z` but with a colon. |
| | | | | |
| | **DATE & TIME SPECIFIERS:** | | | **DATE & TIME SPECIFIERS:** |
`%c` | `Sun Jul 8 00:34:60 2001` | `ctime` date & time format. Same to `%a %b %e %T %Y` sans `\n`. |`%c`|`Sun Jul 8 00:34:60 2001`|`ctime` date & time format. Same to `%a %b %e %T %Y` sans `\n`.|
`%+` | `2001-07-08T00:34:60.026490+09:30` | ISO 8601 / RFC 3339 date & time format. [6] | `%+` | `2001-07-08T00:34:60.026490+09:30` | ISO 8601 / RFC 3339 date & time format. [6] |
| | | | | |
`%s` | `994518299` | UNIX timestamp, the number of seconds since 1970-01-01 00:00 UTC. [7] | `%s` | `994518299` | UNIX timestamp, the number of seconds since 1970-01-01 00:00 UTC. [7] |
| | | | | |
| | **SPECIAL SPECIFIERS:** | | | **SPECIAL SPECIFIERS:** |
`%t` | | Literal tab (`\t`). | `%t` | | Literal tab (`\t`). |
`%n` | | Literal newline (`\n`). | `%n` | | Literal newline (`\n`). |
`%%` | | Literal percent sign. | `%%` | | Literal percent sign. |
It is possible to override the default padding behavior of numeric specifiers `%?`. It is possible to override the default padding behavior of numeric specifiers `%?`.
This is not allowed for other specifiers and will result in the `BAD_FORMAT` error. This is not allowed for other specifiers and will result in the `BAD_FORMAT` error.