diff --git a/docs/scripts/tags.js b/docs/scripts/tags.js index c1abc1fcb..1d5d95712 100644 --- a/docs/scripts/tags.js +++ b/docs/scripts/tags.js @@ -2,7 +2,7 @@ 'use strict' -hexo.extend.tag.register('note', (args, content) => { +hexo.extend.tag.register('note', (args, text) => { const className = args.shift() let header = '' let result = '' @@ -12,8 +12,12 @@ hexo.extend.tag.register('note', (args, content) => { } result += `
${header}` - result += hexo.render.renderSync({ text: content, engine: 'markdown' }) + result += hexo.render.renderSync({ text, engine: 'markdown' }) result += '
' return result }, true) + +hexo.extend.tag.register('since', (args, text) => { + return `

Added in: ${text.trim()}

` +}, true) diff --git a/docs/source/filters/abs.md b/docs/source/filters/abs.md index 9c88ecadf..11bdba31d 100644 --- a/docs/source/filters/abs.md +++ b/docs/source/filters/abs.md @@ -2,6 +2,8 @@ title: abs --- +{% since %}v1.9.1{% endsince %} + Liquid filter that returns the absolute value of a number. Input diff --git a/docs/source/filters/append.md b/docs/source/filters/append.md index d44f4df4f..666e9b8a1 100644 --- a/docs/source/filters/append.md +++ b/docs/source/filters/append.md @@ -2,6 +2,8 @@ title: append --- +{% since %}v1.9.1{% endsince %} + Concatenates two strings and returns the concatenated value. Input diff --git a/docs/source/filters/at_least.md b/docs/source/filters/at_least.md index 456817024..4309ea90e 100644 --- a/docs/source/filters/at_least.md +++ b/docs/source/filters/at_least.md @@ -2,6 +2,8 @@ title: at_least --- +{% since %}v8.4.0{% endsince %} + Limits a number to a minimum value. Input diff --git a/docs/source/filters/at_most.md b/docs/source/filters/at_most.md index 13ae3e29a..bd6876fa3 100644 --- a/docs/source/filters/at_most.md +++ b/docs/source/filters/at_most.md @@ -2,6 +2,8 @@ title: at_most --- +{% since %}v8.4.0{% endsince %} + Limits a number to a maximum value. Input diff --git a/docs/source/filters/capitalize.md b/docs/source/filters/capitalize.md index bf81d7e7c..74d2ae4b1 100644 --- a/docs/source/filters/capitalize.md +++ b/docs/source/filters/capitalize.md @@ -2,6 +2,8 @@ title: capitalize --- +{% since %}v1.9.1{% endsince %} + Makes the first character of a string capitalized. Input diff --git a/docs/source/filters/ceil.md b/docs/source/filters/ceil.md index 43406aec5..a365e77a7 100644 --- a/docs/source/filters/ceil.md +++ b/docs/source/filters/ceil.md @@ -2,6 +2,8 @@ title: ceil --- +{% since %}v1.9.1{% endsince %} + Rounds the input up to the nearest whole number. LiquidJS tries to convert the input to a number before the filter is applied. Input diff --git a/docs/source/filters/compact.md b/docs/source/filters/compact.md index 0a1585412..fb642b818 100644 --- a/docs/source/filters/compact.md +++ b/docs/source/filters/compact.md @@ -2,6 +2,8 @@ title: compact --- +{% since %}v9.22.0{% endsince %} + Removes any `nil` values from an array. For this example, assume `site.pages` is an array of content pages for a website, and some of these pages have an attribute called `category` that specifies their content category. If we `map` those categories to an array, some of the array items might be `nil` if any pages do not have a `category` attribute. diff --git a/docs/source/filters/date.md b/docs/source/filters/date.md index 48097ff84..1ca16935f 100644 --- a/docs/source/filters/date.md +++ b/docs/source/filters/date.md @@ -2,6 +2,8 @@ title: date --- +{% since %}v1.9.1{% endsince %} + Converts a timestamp into another date format. LiquidJS tries to be conformant with Shopify/Liquid which is using Ruby's core [Time#strftime(string)](http://www.ruby-doc.org/core/Time.html#method-i-strftime). The input is firstly converted to `Date` object via [new Date()][newDate]. Input diff --git a/docs/source/filters/default.md b/docs/source/filters/default.md index 6a580697a..40fa6a986 100644 --- a/docs/source/filters/default.md +++ b/docs/source/filters/default.md @@ -2,6 +2,8 @@ title: default --- +{% since %}v1.9.1{% endsince %} + Allows you to specify a fallback in case a value doesn't exist. `default` will show its value if the left side is [falsy][falsy] or empty (`string` or `Array`). In this example, `product_price` is not defined, so the default value is used. diff --git a/docs/source/filters/divided_by.md b/docs/source/filters/divided_by.md index 82753e7b1..88038f748 100644 --- a/docs/source/filters/divided_by.md +++ b/docs/source/filters/divided_by.md @@ -2,6 +2,8 @@ title: divided_by --- +{% since %}v1.9.1{% endsince %} + Divides a number by another number. The result is the string obtained by JavaScript `.toString()` of the result number. Input diff --git a/docs/source/filters/downcase.md b/docs/source/filters/downcase.md index 292a44c09..445298e5b 100644 --- a/docs/source/filters/downcase.md +++ b/docs/source/filters/downcase.md @@ -2,6 +2,8 @@ title: downcase --- +{% since %}v1.9.1{% endsince %} + Makes each character in a string lowercase. It has no effect on strings which are already all lowercase. Input diff --git a/docs/source/filters/escape.md b/docs/source/filters/escape.md index 68e466223..3ca701c9c 100644 --- a/docs/source/filters/escape.md +++ b/docs/source/filters/escape.md @@ -2,6 +2,8 @@ title: escape --- +{% since %}v1.9.1{% endsince %} + Escapes a string by replacing HTML special characters with escape sequences. It doesn't change strings that don't have anything to escape. Input diff --git a/docs/source/filters/escape_once.md b/docs/source/filters/escape_once.md index 0e38ac23a..7b7fe13fc 100644 --- a/docs/source/filters/escape_once.md +++ b/docs/source/filters/escape_once.md @@ -2,6 +2,8 @@ title: escape_once --- +{% since %}v1.9.1{% endsince %} + Escapes a string without changing existing escaped entities. It doesn't change strings that don't have anything to escape. Input diff --git a/docs/source/filters/first.md b/docs/source/filters/first.md index 79fe18db9..5e9db34ae 100644 --- a/docs/source/filters/first.md +++ b/docs/source/filters/first.md @@ -2,6 +2,8 @@ title: first --- +{% since %}v1.9.1{% endsince %} + Returns the first item of an array. Input diff --git a/docs/source/filters/floor.md b/docs/source/filters/floor.md index 410cd17f7..26660574f 100644 --- a/docs/source/filters/floor.md +++ b/docs/source/filters/floor.md @@ -2,6 +2,8 @@ title: floor --- +{% since %}v1.9.1{% endsince %} + Rounds the input down to the nearest whole number. LiquidJS tries to convert the input to a number before the filter is applied. Input diff --git a/docs/source/filters/join.md b/docs/source/filters/join.md index 50f968e18..11074ead2 100644 --- a/docs/source/filters/join.md +++ b/docs/source/filters/join.md @@ -2,6 +2,8 @@ title: join --- +{% since %}v1.9.1{% endsince %} + Combines the items in an array into a single string using the argument as a separator. Input diff --git a/docs/source/filters/json.md b/docs/source/filters/json.md index 652670db8..f7908298f 100644 --- a/docs/source/filters/json.md +++ b/docs/source/filters/json.md @@ -2,6 +2,8 @@ title: json --- +{% since %}v9.10.0{% endsince %} + Convert values to string via `JSON.stringify()`, for debug purpose. Input diff --git a/docs/source/filters/last.md b/docs/source/filters/last.md index 9f4c77125..98f7d91f8 100644 --- a/docs/source/filters/last.md +++ b/docs/source/filters/last.md @@ -2,6 +2,8 @@ title: last --- +{% since %}v1.9.1{% endsince %} + Returns the last item of an array. Input diff --git a/docs/source/filters/lstrip.md b/docs/source/filters/lstrip.md index 0bb8e3496..f24dc3a09 100644 --- a/docs/source/filters/lstrip.md +++ b/docs/source/filters/lstrip.md @@ -2,6 +2,8 @@ title: lstrip --- +{% since %}v1.9.1{% endsince %} + Removes all whitespace (tabs, spaces, and newlines) from the left side of a string. It does not affect spaces between words. Input diff --git a/docs/source/filters/map.md b/docs/source/filters/map.md index 3996829fe..6f7092f72 100644 --- a/docs/source/filters/map.md +++ b/docs/source/filters/map.md @@ -2,6 +2,8 @@ title: map --- +{% since %}v1.9.1{% endsince %} + Creates an array of values by extracting the values of a named property from another object. In this example, assume the object `site.pages` contains all the metadata for a website. Using `assign` with the `map` filter creates a variable that contains only the values of the `category` properties of everything in the `site.pages` object. diff --git a/docs/source/filters/minus.md b/docs/source/filters/minus.md index 4cfaf3a9e..f163a55de 100644 --- a/docs/source/filters/minus.md +++ b/docs/source/filters/minus.md @@ -2,6 +2,8 @@ title: minus --- +{% since %}v1.9.1{% endsince %} + Subtracts a number from another number. Input diff --git a/docs/source/filters/modulo.md b/docs/source/filters/modulo.md index d81c1a9a0..40d22d8a2 100644 --- a/docs/source/filters/modulo.md +++ b/docs/source/filters/modulo.md @@ -2,6 +2,8 @@ title: modulo --- +{% since %}v1.9.1{% endsince %} + Returns the remainder of a division operation. Input diff --git a/docs/source/filters/newline_to_br.md b/docs/source/filters/newline_to_br.md index 76449be92..852598f52 100644 --- a/docs/source/filters/newline_to_br.md +++ b/docs/source/filters/newline_to_br.md @@ -2,6 +2,8 @@ title: newline_to_br --- +{% since %}v1.9.1{% endsince %} + Replaces every newline (`\n`) in a string with an HTML line break (`
`). Input diff --git a/docs/source/filters/plus.md b/docs/source/filters/plus.md index 2438118e1..7fcc12c7f 100644 --- a/docs/source/filters/plus.md +++ b/docs/source/filters/plus.md @@ -2,6 +2,8 @@ title: plus --- +{% since %}v1.9.1{% endsince %} + Adds a number to another number. Input diff --git a/docs/source/filters/prepend.md b/docs/source/filters/prepend.md index a738a60f5..82b0161dc 100644 --- a/docs/source/filters/prepend.md +++ b/docs/source/filters/prepend.md @@ -2,6 +2,8 @@ title: prepend --- +{% since %}v1.9.1{% endsince %} + Adds the specified string to the beginning of another string. Input diff --git a/docs/source/filters/remove.md b/docs/source/filters/remove.md index 3f4a55fdd..54189dfe4 100644 --- a/docs/source/filters/remove.md +++ b/docs/source/filters/remove.md @@ -2,6 +2,8 @@ title: remove --- +{% since %}v1.9.1{% endsince %} + Removes every occurrence of the specified substring from a string. Input diff --git a/docs/source/filters/remove_first.md b/docs/source/filters/remove_first.md index 920733eb6..f495824a0 100644 --- a/docs/source/filters/remove_first.md +++ b/docs/source/filters/remove_first.md @@ -2,6 +2,8 @@ title: remove_first --- +{% since %}v1.9.1{% endsince %} + Removes only the first occurrence of the specified substring from a string. Input diff --git a/docs/source/filters/replace.md b/docs/source/filters/replace.md index dc137c700..00ef7b538 100644 --- a/docs/source/filters/replace.md +++ b/docs/source/filters/replace.md @@ -2,6 +2,8 @@ title: replace --- +{% since %}v1.9.1{% endsince %} + Replaces every occurrence of the first argument in a string with the second argument. Input diff --git a/docs/source/filters/replace_first.md b/docs/source/filters/replace_first.md index e27811d30..f2750d38a 100644 --- a/docs/source/filters/replace_first.md +++ b/docs/source/filters/replace_first.md @@ -2,6 +2,8 @@ title: replace_first --- +{% since %}v1.9.1{% endsince %} + Replaces only the first occurrence of the first argument in a string with the second argument. Input diff --git a/docs/source/filters/reverse.md b/docs/source/filters/reverse.md index face31ce2..a0521941c 100644 --- a/docs/source/filters/reverse.md +++ b/docs/source/filters/reverse.md @@ -2,6 +2,8 @@ title: reverse --- +{% since %}v1.9.1{% endsince %} + Reverses the order of the items in an array. `reverse` cannot reverse a string. Input diff --git a/docs/source/filters/round.md b/docs/source/filters/round.md index ee948b34e..5995da50a 100644 --- a/docs/source/filters/round.md +++ b/docs/source/filters/round.md @@ -2,6 +2,8 @@ title: round --- +{% since %}v1.9.1{% endsince %} + Rounds a number to the nearest integer or, if a number is passed as an argument, to that number of decimal places. Input diff --git a/docs/source/filters/rstrip.md b/docs/source/filters/rstrip.md index 1ea9b0855..f99a506cb 100644 --- a/docs/source/filters/rstrip.md +++ b/docs/source/filters/rstrip.md @@ -2,6 +2,8 @@ title: rstrip --- +{% since %}v1.9.1{% endsince %} + Removes all whitespace (tabs, spaces, and newlines) from the right side of a string. It does not affect spaces between words. Input diff --git a/docs/source/filters/size.md b/docs/source/filters/size.md index c5b781424..04f71c0e9 100644 --- a/docs/source/filters/size.md +++ b/docs/source/filters/size.md @@ -2,6 +2,8 @@ title: size --- +{% since %}v1.9.1{% endsince %} + Returns the number of characters in a string or the number of items in an array. Input diff --git a/docs/source/filters/slice.md b/docs/source/filters/slice.md index e7624d602..4764d86cb 100644 --- a/docs/source/filters/slice.md +++ b/docs/source/filters/slice.md @@ -2,6 +2,8 @@ title: slice --- +{% since %}v1.9.1{% endsince %} + Returns a substring of 1 character beginning at the index specified by the first argument. An optional second argument specifies the length of the substring to be returned. String indices are numbered starting from 0. diff --git a/docs/source/filters/sort.md b/docs/source/filters/sort.md index 5ed79fa36..5e69af7ff 100644 --- a/docs/source/filters/sort.md +++ b/docs/source/filters/sort.md @@ -2,6 +2,8 @@ title: sort --- +{% since %}v1.9.1{% endsince %} + Sorts items in an array in case-sensitive order. Input diff --git a/docs/source/filters/sort_natural.md b/docs/source/filters/sort_natural.md index eb9ef4848..4bece69f3 100644 --- a/docs/source/filters/sort_natural.md +++ b/docs/source/filters/sort_natural.md @@ -2,6 +2,8 @@ title: sort_natural --- +{% since %}v8.4.0{% endsince %} + Sorts items in an array in case-insensitive order. Input diff --git a/docs/source/filters/split.md b/docs/source/filters/split.md index 773572f66..f9c048292 100644 --- a/docs/source/filters/split.md +++ b/docs/source/filters/split.md @@ -2,6 +2,8 @@ title: split --- +{% since %}v1.9.1{% endsince %} + Divides a string into an array using the argument as a separator. `split` is commonly used to convert comma-separated items from a string to an array. Input diff --git a/docs/source/filters/strip.md b/docs/source/filters/strip.md index cf666b9b6..23a16bcc1 100644 --- a/docs/source/filters/strip.md +++ b/docs/source/filters/strip.md @@ -2,6 +2,8 @@ title: strip --- +{% since %}v1.9.1{% endsince %} + Removes all whitespace (tabs, spaces, and newlines) from both the left and right sides of a string. It does not affect spaces between words. Input diff --git a/docs/source/filters/strip_html.md b/docs/source/filters/strip_html.md index 5b5eae0e6..86248716b 100644 --- a/docs/source/filters/strip_html.md +++ b/docs/source/filters/strip_html.md @@ -2,6 +2,8 @@ title: strip_html --- +{% since %}v1.9.1{% endsince %} + Removes any HTML tags from a string. Input diff --git a/docs/source/filters/strip_newlines.md b/docs/source/filters/strip_newlines.md index bf8bbecd8..a713ea8b6 100644 --- a/docs/source/filters/strip_newlines.md +++ b/docs/source/filters/strip_newlines.md @@ -2,6 +2,8 @@ title: strip_newlines --- +{% since %}v1.9.1{% endsince %} + Removes any newline characters (line breaks) from a string. Input diff --git a/docs/source/filters/times.md b/docs/source/filters/times.md index 590147d3c..1187e20f2 100644 --- a/docs/source/filters/times.md +++ b/docs/source/filters/times.md @@ -2,6 +2,8 @@ title: times --- +{% since %}v1.9.1{% endsince %} + Multiplies a number by another number. Input diff --git a/docs/source/filters/truncate.md b/docs/source/filters/truncate.md index c9caed8f4..a3cf7cb3c 100644 --- a/docs/source/filters/truncate.md +++ b/docs/source/filters/truncate.md @@ -2,6 +2,8 @@ title: truncate --- +{% since %}v1.9.1{% endsince %} + Shortens a string down to the number of characters passed as an argument. If the specified number of characters is less than the length of the string, an ellipsis (...) is appended to the string and is included in the character count. ## Basic Usage diff --git a/docs/source/filters/truncatewords.md b/docs/source/filters/truncatewords.md index 1bc991c68..6a98bc114 100644 --- a/docs/source/filters/truncatewords.md +++ b/docs/source/filters/truncatewords.md @@ -2,6 +2,8 @@ title: truncatewords --- +{% since %}v1.9.1{% endsince %} + Shortens a string down to the number of words passed as an argument. If the specified number of words is less than the number of words in the string, an ellipsis (...) is appended to the string. Input diff --git a/docs/source/filters/uniq.md b/docs/source/filters/uniq.md index b89927093..f56d886f5 100644 --- a/docs/source/filters/uniq.md +++ b/docs/source/filters/uniq.md @@ -2,6 +2,8 @@ title: uniq --- +{% since %}v1.9.1{% endsince %} + Removes any duplicate elements in an array. Input diff --git a/docs/source/filters/upcase.md b/docs/source/filters/upcase.md index 63144b258..b7fe6bfcb 100644 --- a/docs/source/filters/upcase.md +++ b/docs/source/filters/upcase.md @@ -2,6 +2,8 @@ title: upcase --- +{% since %}v1.9.1{% endsince %} + Makes each character in a string uppercase. It has no effect on strings which are already all uppercase. Input diff --git a/docs/source/filters/url_decode.md b/docs/source/filters/url_decode.md index 66c659640..9b8920215 100644 --- a/docs/source/filters/url_decode.md +++ b/docs/source/filters/url_decode.md @@ -2,6 +2,8 @@ title: url_decode --- +{% since %}v6.1.0{% endsince %} + Decodes a string that has been encoded as a URL. Input diff --git a/docs/source/filters/url_encode.md b/docs/source/filters/url_encode.md index c22378d0d..88b7f31e1 100644 --- a/docs/source/filters/url_encode.md +++ b/docs/source/filters/url_encode.md @@ -2,6 +2,8 @@ title: url_encode --- +{% since %}v1.9.1{% endsince %} + Converts any URL-unsafe characters in a string into percent-encoded characters. Input diff --git a/docs/source/filters/where.md b/docs/source/filters/where.md index 6dae5dd20..b2bc16495 100644 --- a/docs/source/filters/where.md +++ b/docs/source/filters/where.md @@ -2,6 +2,8 @@ title: where --- +{% since %}v8.1.0{% endsince %} + Creates an array including only the objects with a given property value, or any [truthy][truthy] value by default. In this example, assume you have a list of products and you want to show your kitchen products separately. Using `where`, you can create an array containing only the products that have a `"type"` of `"kitchen"`. diff --git a/docs/source/tags/assign.md b/docs/source/tags/assign.md index 2244fc22e..abe7e57fa 100644 --- a/docs/source/tags/assign.md +++ b/docs/source/tags/assign.md @@ -2,6 +2,8 @@ title: Assign --- +{% since %}v1.9.1{% endsince %} + Creates a new variable. Input diff --git a/docs/source/tags/capture.md b/docs/source/tags/capture.md index 75731c85a..d78aa5ecd 100644 --- a/docs/source/tags/capture.md +++ b/docs/source/tags/capture.md @@ -2,6 +2,8 @@ title: capture --- +{% since %}v1.9.1{% endsince %} + Captures the string inside of the opening and closing tags and assigns it to a variable. Variables created through `capture` are strings. Input diff --git a/docs/source/tags/case.md b/docs/source/tags/case.md index dd45d150b..89864def2 100644 --- a/docs/source/tags/case.md +++ b/docs/source/tags/case.md @@ -2,6 +2,8 @@ title: case --- +{% since %}v1.9.1{% endsince %} + Creates a switch statement to compare a variable with different values. `case` initializes the switch statement, and `when` compares its values. Input diff --git a/docs/source/tags/comment.md b/docs/source/tags/comment.md index cebb62eb4..943db07f8 100644 --- a/docs/source/tags/comment.md +++ b/docs/source/tags/comment.md @@ -2,6 +2,8 @@ title: Comment --- +{% since %}v1.9.1{% endsince %} + Allows you to leave un-rendered code inside a Liquid template. Any text within the opening and closing `comment` blocks will not be printed, and any Liquid code within will not be executed. Input diff --git a/docs/source/tags/cycle.md b/docs/source/tags/cycle.md index e20048be2..79ccc562a 100644 --- a/docs/source/tags/cycle.md +++ b/docs/source/tags/cycle.md @@ -2,6 +2,8 @@ title: cycle --- +{% since %}v1.9.1{% endsince %} + Loops through a group of strings and prints them in the order that they were passed as arguments. Each time `cycle` is called, the next string argument is printed. ## Basic Usage diff --git a/docs/source/tags/decrement.md b/docs/source/tags/decrement.md index 086dfc6e2..fdcfce9c3 100644 --- a/docs/source/tags/decrement.md +++ b/docs/source/tags/decrement.md @@ -2,6 +2,8 @@ title: Decrement --- +{% since %}v1.9.1{% endsince %} + Creates a new number variable, and decreases its value by one every time it is called. The first value is `-1`. Input diff --git a/docs/source/tags/for.md b/docs/source/tags/for.md index 26eae804f..0accd6ca0 100644 --- a/docs/source/tags/for.md +++ b/docs/source/tags/for.md @@ -2,6 +2,8 @@ title: For --- +{% since %}v1.9.1{% endsince %} + Iteration tags run blocks of code repeatedly. ## Basic Usage diff --git a/docs/source/tags/if.md b/docs/source/tags/if.md index 6f0dfbee2..2e3b8063e 100644 --- a/docs/source/tags/if.md +++ b/docs/source/tags/if.md @@ -2,6 +2,8 @@ title: If --- +{% since %}v1.9.1{% endsince %} + Executes a block of code only if a certain condition is `true`. ## if diff --git a/docs/source/tags/include.md b/docs/source/tags/include.md index 2c36d23d9..b9a298e4c 100644 --- a/docs/source/tags/include.md +++ b/docs/source/tags/include.md @@ -2,6 +2,8 @@ title: Include --- +{% since %}v1.9.1{% endsince %} + {% note warn Deprecated %} This tag is deprecated, use render tag instead for better encapsulation. {% endnote %} diff --git a/docs/source/tags/increment.md b/docs/source/tags/increment.md index 63c2a7eb4..6e8b7e416 100644 --- a/docs/source/tags/increment.md +++ b/docs/source/tags/increment.md @@ -2,6 +2,8 @@ title: Increment --- +{% since %}v1.9.1{% endsince %} + Creates a new number variable, and increases its value by one every time it is called. The first value is `0`. Input diff --git a/docs/source/tags/layout.md b/docs/source/tags/layout.md index c77b95b0c..ae39120eb 100644 --- a/docs/source/tags/layout.md +++ b/docs/source/tags/layout.md @@ -2,6 +2,8 @@ title: Layout --- +{% since %}v1.9.1{% endsince %} + ## Using a Layout Template Renders current template inside a layout template from the template [roots][root]. diff --git a/docs/source/tags/raw.md b/docs/source/tags/raw.md index 2de7b8dd5..70698dd16 100644 --- a/docs/source/tags/raw.md +++ b/docs/source/tags/raw.md @@ -2,6 +2,8 @@ title: Raw --- +{% since %}v1.9.1{% endsince %} + Raw temporarily disables tag processing. This is useful for generating content (eg, Mustache, Handlebars) which uses conflicting syntax. diff --git a/docs/source/tags/render.md b/docs/source/tags/render.md index 2c0c764bd..537ffc284 100644 --- a/docs/source/tags/render.md +++ b/docs/source/tags/render.md @@ -2,6 +2,8 @@ title: Render --- +{% since %}v9.2.0{% endsince %} + ## Basic Usage ### Render a Template diff --git a/docs/source/tags/tablerow.md b/docs/source/tags/tablerow.md index 68c7de600..f33a8ca09 100644 --- a/docs/source/tags/tablerow.md +++ b/docs/source/tags/tablerow.md @@ -2,6 +2,8 @@ title: Table Row --- +{% since %}v1.9.1{% endsince %} + Generates an HTML table. Must be wrapped in opening `` and closing `
` HTML tags. ## Basic Usage diff --git a/docs/source/tags/unless.md b/docs/source/tags/unless.md index 34b72f07d..e2632aed8 100644 --- a/docs/source/tags/unless.md +++ b/docs/source/tags/unless.md @@ -2,6 +2,8 @@ title: Unless --- +{% since %}v1.9.1{% endsince %} + The opposite of `if` – executes a block of code only if a certain condition is **not** met. Input diff --git a/docs/source/zh-cn/filters/abs.md b/docs/source/zh-cn/filters/abs.md index ed7b1691c..84483954a 100644 --- a/docs/source/zh-cn/filters/abs.md +++ b/docs/source/zh-cn/filters/abs.md @@ -2,6 +2,8 @@ title: abs --- +{% since %}v1.9.1{% endsince %} + 返回数字的绝对值。 输入 diff --git a/docs/source/zh-cn/filters/append.md b/docs/source/zh-cn/filters/append.md index 36d2b7f79..7fa4cca10 100644 --- a/docs/source/zh-cn/filters/append.md +++ b/docs/source/zh-cn/filters/append.md @@ -2,6 +2,8 @@ title: append --- +{% since %}v1.9.1{% endsince %} + 连接两个字符串并返回结果。 输入 diff --git a/docs/source/zh-cn/filters/at_least.md b/docs/source/zh-cn/filters/at_least.md index 9f80245d1..0a1f2e85e 100644 --- a/docs/source/zh-cn/filters/at_least.md +++ b/docs/source/zh-cn/filters/at_least.md @@ -2,6 +2,8 @@ title: at_least --- +{% since %}v8.4.0{% endsince %} + 限制数字到某个最小值。 输入 diff --git a/docs/source/zh-cn/filters/at_most.md b/docs/source/zh-cn/filters/at_most.md index 735f16f55..7410c1d06 100644 --- a/docs/source/zh-cn/filters/at_most.md +++ b/docs/source/zh-cn/filters/at_most.md @@ -2,6 +2,8 @@ title: at_most --- +{% since %}v8.4.0{% endsince %} + 限制数字到某个最大值。 输入 diff --git a/docs/source/zh-cn/filters/capitalize.md b/docs/source/zh-cn/filters/capitalize.md index d29acef90..5e7562931 100644 --- a/docs/source/zh-cn/filters/capitalize.md +++ b/docs/source/zh-cn/filters/capitalize.md @@ -2,6 +2,8 @@ title: capitalize --- +{% since %}v1.9.1{% endsince %} + 把字符串首字母改为大写。 输入 diff --git a/docs/source/zh-cn/filters/ceil.md b/docs/source/zh-cn/filters/ceil.md index 667240352..5217227d0 100644 --- a/docs/source/zh-cn/filters/ceil.md +++ b/docs/source/zh-cn/filters/ceil.md @@ -2,6 +2,8 @@ title: ceil --- +{% since %}v1.9.1{% endsince %} + 向上取整，取整前 LiquidJS 会首先把输入转换为数字。 输入 diff --git a/docs/source/zh-cn/filters/compact.md b/docs/source/zh-cn/filters/compact.md index 2f2580ab0..6760b62a4 100644 --- a/docs/source/zh-cn/filters/compact.md +++ b/docs/source/zh-cn/filters/compact.md @@ -2,6 +2,8 @@ title: compact --- +{% since %}v9.22.0{% endsince %} + 从数组里移除任何 `null` 和 `undefined` 值。 假设 `site.pages` 是网页列表，有些网页包含 `category` 属性用来标明类别。如果把它们 `map` 到数组里，那么对于没有 `category` 属性的元素就会是 `undefined`。 diff --git a/docs/source/zh-cn/filters/date.md b/docs/source/zh-cn/filters/date.md index 2fb6926b5..cb8b7558e 100644 --- a/docs/source/zh-cn/filters/date.md +++ b/docs/source/zh-cn/filters/date.md @@ -2,6 +2,8 @@ title: date --- +{% since %}v1.9.1{% endsince %} + 把时间戳转换为字符串。LiquidJS 尝试跟 Shopify/Liquid 保持一致，它用的是 Ruby 核心的 [Time#strftime(string)](http://www.ruby-doc.org/core/Time.html#method-i-strftime)。此外 LiquidJS 会先通过 [new Date()][newDate] 尝试把输入转换为 Date 对象。 输入 diff --git a/docs/source/zh-cn/filters/default.md b/docs/source/zh-cn/filters/default.md index 6ab58b6b4..7ef9e9d35 100644 --- a/docs/source/zh-cn/filters/default.md +++ b/docs/source/zh-cn/filters/default.md @@ -2,6 +2,8 @@ title: default --- +{% since %}v1.9.1{% endsince %} + 在值不存在时给一个默认值，如果左侧是 [falsy][falsy] 或空（`string` 或 `Array`）就会使用这个默认值。下面的例子中 `product_price` 没有定义，因此使用了默认值。 输入 diff --git a/docs/source/zh-cn/filters/divided_by.md b/docs/source/zh-cn/filters/divided_by.md index 3f1ff3d71..aedc2a20a 100644 --- a/docs/source/zh-cn/filters/divided_by.md +++ b/docs/source/zh-cn/filters/divided_by.md @@ -2,6 +2,8 @@ title: divided_by --- +{% since %}v1.9.1{% endsince %} + 两数相除返回商，返回结果数字在 JavaScript 中 `.toString()` 得到的字符串。 输入 diff --git a/docs/source/zh-cn/filters/downcase.md b/docs/source/zh-cn/filters/downcase.md index eda1769a9..4fb4cdbb9 100644 --- a/docs/source/zh-cn/filters/downcase.md +++ b/docs/source/zh-cn/filters/downcase.md @@ -2,6 +2,8 @@ title: downcase --- +{% since %}v1.9.1{% endsince %} + 字符串中每个字符都转为小写，对已经是小写的字符没有影响。 输入 diff --git a/docs/source/zh-cn/filters/escape.md b/docs/source/zh-cn/filters/escape.md index 80b5c63ac..02e5c781e 100644 --- a/docs/source/zh-cn/filters/escape.md +++ b/docs/source/zh-cn/filters/escape.md @@ -2,6 +2,8 @@ title: escape --- +{% since %}v1.9.1{% endsince %} + 把字符串中的 HTML 特殊字符转义，对不需要转义的字符串不会产生影响。 输入 diff --git a/docs/source/zh-cn/filters/escape_once.md b/docs/source/zh-cn/filters/escape_once.md index 47eb78f0d..14a2f2e8f 100644 --- a/docs/source/zh-cn/filters/escape_once.md +++ b/docs/source/zh-cn/filters/escape_once.md @@ -2,6 +2,8 @@ title: escape_once --- +{% since %}v1.9.1{% endsince %} + 把字符串中的特殊字符转义得到可用在 URL 里的字符串，对已经转义过的字符串和不需要转义的字符串不会产生影响。 输入 diff --git a/docs/source/zh-cn/filters/first.md b/docs/source/zh-cn/filters/first.md index 523b4a335..fd98ba7ea 100644 --- a/docs/source/zh-cn/filters/first.md +++ b/docs/source/zh-cn/filters/first.md @@ -2,6 +2,8 @@ title: first --- +{% since %}v1.9.1{% endsince %} + 返回数组的第一个元素。 输入 diff --git a/docs/source/zh-cn/filters/floor.md b/docs/source/zh-cn/filters/floor.md index e71615cdf..3401b52a6 100644 --- a/docs/source/zh-cn/filters/floor.md +++ b/docs/source/zh-cn/filters/floor.md @@ -2,6 +2,8 @@ title: floor --- +{% since %}v1.9.1{% endsince %} + 数字下取整，LiquidJS 会尝试把输入转换为数字再做下取整操作。 输入 diff --git a/docs/source/zh-cn/filters/join.md b/docs/source/zh-cn/filters/join.md index 20be18736..cfda7ffb8 100644 --- a/docs/source/zh-cn/filters/join.md +++ b/docs/source/zh-cn/filters/join.md @@ -2,6 +2,8 @@ title: join --- +{% since %}v1.9.1{% endsince %} + 把数组中的元素连接成为一个字符串，以传入的参数作为分隔符。 输入 diff --git a/docs/source/zh-cn/filters/json.md b/docs/source/zh-cn/filters/json.md index fb040d1bc..7089b46f2 100644 --- a/docs/source/zh-cn/filters/json.md +++ b/docs/source/zh-cn/filters/json.md @@ -2,6 +2,8 @@ title: json --- +{% since %}v9.10.0{% endsince %} + 通过 `JSON.stringify()` 把值转换为字符串，多用于调试用途。 输入 diff --git a/docs/source/zh-cn/filters/last.md b/docs/source/zh-cn/filters/last.md index bb065e4cc..971acb5a2 100644 --- a/docs/source/zh-cn/filters/last.md +++ b/docs/source/zh-cn/filters/last.md @@ -2,6 +2,8 @@ title: last --- +{% since %}v1.9.1{% endsince %} + 返回数组的最后一个元素。 输入 diff --git a/docs/source/zh-cn/filters/lstrip.md b/docs/source/zh-cn/filters/lstrip.md index 33c15fa6a..f7e07a85e 100644 --- a/docs/source/zh-cn/filters/lstrip.md +++ b/docs/source/zh-cn/filters/lstrip.md @@ -2,6 +2,8 @@ title: lstrip --- +{% since %}v1.9.1{% endsince %} + 移除字符串左侧的空白字符（制表符、空格、换行），不影响词之间的空格。 输入 diff --git a/docs/source/zh-cn/filters/map.md b/docs/source/zh-cn/filters/map.md index 85b5af571..5686e8c8a 100644 --- a/docs/source/zh-cn/filters/map.md +++ b/docs/source/zh-cn/filters/map.md @@ -2,6 +2,8 @@ title: map --- +{% since %}v1.9.1{% endsince %} + 按照属性名提取对象的属性形成另一个数组并返回。 下面的例子中假设 `site.pages` 包含了站点的所有网页元信息。使用 `assign` 加 `map` 过滤器创建了一个 `site.pages` 中所有对象的 `category` 属性的值构成的数组。 diff --git a/docs/source/zh-cn/filters/minus.md b/docs/source/zh-cn/filters/minus.md index 393dff2bf..8c7c45a04 100644 --- a/docs/source/zh-cn/filters/minus.md +++ b/docs/source/zh-cn/filters/minus.md @@ -2,6 +2,8 @@ title: minus --- +{% since %}v1.9.1{% endsince %} + 两数相减。 输入 diff --git a/docs/source/zh-cn/filters/modulo.md b/docs/source/zh-cn/filters/modulo.md index 276ce3be1..037502bc4 100644 --- a/docs/source/zh-cn/filters/modulo.md +++ b/docs/source/zh-cn/filters/modulo.md @@ -2,6 +2,8 @@ title: modulo --- +{% since %}v1.9.1{% endsince %} + 返回两数相除的余数。 输入 diff --git a/docs/source/zh-cn/filters/newline_to_br.md b/docs/source/zh-cn/filters/newline_to_br.md index 7f0b215fc..8c60e7725 100644 --- a/docs/source/zh-cn/filters/newline_to_br.md +++ b/docs/source/zh-cn/filters/newline_to_br.md @@ -2,6 +2,8 @@ title: newline_to_br --- +{% since %}v1.9.1{% endsince %} + 把字符串里的所有换行符（`\n`）替换为 HTML 换行（`
`）。 输入 diff --git a/docs/source/zh-cn/filters/plus.md b/docs/source/zh-cn/filters/plus.md index 62e5543ac..a44740656 100644 --- a/docs/source/zh-cn/filters/plus.md +++ b/docs/source/zh-cn/filters/plus.md @@ -2,6 +2,8 @@ title: plus --- +{% since %}v1.9.1{% endsince %} + 两数相加。 输入 diff --git a/docs/source/zh-cn/filters/prepend.md b/docs/source/zh-cn/filters/prepend.md index 560e263a9..fa0cb9e22 100644 --- a/docs/source/zh-cn/filters/prepend.md +++ b/docs/source/zh-cn/filters/prepend.md @@ -2,6 +2,8 @@ title: prepend --- +{% since %}v1.9.1{% endsince %} + 在字符串开头添加另一个字符串。 输入 diff --git a/docs/source/zh-cn/filters/remove.md b/docs/source/zh-cn/filters/remove.md index 85bbdc969..3489e6d4a 100644 --- a/docs/source/zh-cn/filters/remove.md +++ b/docs/source/zh-cn/filters/remove.md @@ -2,6 +2,8 @@ title: remove --- +{% since %}v1.9.1{% endsince %} + 移除字符串中出现的所有指定子字符串。 输入 diff --git a/docs/source/zh-cn/filters/remove_first.md b/docs/source/zh-cn/filters/remove_first.md index 84915abf2..cc3400f04 100644 --- a/docs/source/zh-cn/filters/remove_first.md +++ b/docs/source/zh-cn/filters/remove_first.md @@ -2,6 +2,8 @@ title: remove_first --- +{% since %}v1.9.1{% endsince %} + 移除字符串中出现的第一个指定子字符串。 输入 diff --git a/docs/source/zh-cn/filters/replace.md b/docs/source/zh-cn/filters/replace.md index d106076e3..c7109f9cc 100644 --- a/docs/source/zh-cn/filters/replace.md +++ b/docs/source/zh-cn/filters/replace.md @@ -2,6 +2,8 @@ title: replace --- +{% since %}v1.9.1{% endsince %} + 把字符串中出现的每一个指定子字符串替换为另一个字符串。 输入 diff --git a/docs/source/zh-cn/filters/replace_first.md b/docs/source/zh-cn/filters/replace_first.md index 9a63e6570..6636db913 100644 --- a/docs/source/zh-cn/filters/replace_first.md +++ b/docs/source/zh-cn/filters/replace_first.md @@ -2,6 +2,8 @@ title: replace_first --- +{% since %}v1.9.1{% endsince %} + 把字符串中出现的第一个指定子字符串替换为另一个字符串。 输入 diff --git a/docs/source/zh-cn/filters/reverse.md b/docs/source/zh-cn/filters/reverse.md index 46ce224b3..0ebef2698 100644 --- a/docs/source/zh-cn/filters/reverse.md +++ b/docs/source/zh-cn/filters/reverse.md @@ -2,6 +2,8 @@ title: reverse --- +{% since %}v1.9.1{% endsince %} + 反转数组的所有元素，不可用于字符串。 输入 diff --git a/docs/source/zh-cn/filters/round.md b/docs/source/zh-cn/filters/round.md index 7af7cdd3a..9f013db75 100644 --- a/docs/source/zh-cn/filters/round.md +++ b/docs/source/zh-cn/filters/round.md @@ -2,6 +2,8 @@ title: round --- +{% since %}v1.9.1{% endsince %} + 数字四舍五入取整，如果传入小数位数作为参数。 输入 diff --git a/docs/source/zh-cn/filters/rstrip.md b/docs/source/zh-cn/filters/rstrip.md index 63b8c76a0..a717a7ed6 100644 --- a/docs/source/zh-cn/filters/rstrip.md +++ b/docs/source/zh-cn/filters/rstrip.md @@ -2,6 +2,8 @@ title: rstrip --- +{% since %}v1.9.1{% endsince %} + 移除字符串右侧的空白字符（制表符、空格、换行），不影响词之间的空格。 输入 diff --git a/docs/source/zh-cn/filters/size.md b/docs/source/zh-cn/filters/size.md index d9d5d8956..661273b0e 100644 --- a/docs/source/zh-cn/filters/size.md +++ b/docs/source/zh-cn/filters/size.md @@ -2,6 +2,8 @@ title: size --- +{% since %}v1.9.1{% endsince %} + 返回字符串的字符个数或者数组的元素个数。 输入 diff --git a/docs/source/zh-cn/filters/slice.md b/docs/source/zh-cn/filters/slice.md index ecd9a41c4..a3f2a4df7 100644 --- a/docs/source/zh-cn/filters/slice.md +++ b/docs/source/zh-cn/filters/slice.md @@ -2,6 +2,8 @@ title: slice --- +{% since %}v1.9.1{% endsince %} + 返回第一个参数为下标位置的一个字符，如果指定了第二个参数会被解释为子字符串的长度。字符串下标从零开始。 输入 diff --git a/docs/source/zh-cn/filters/sort.md b/docs/source/zh-cn/filters/sort.md index 9231809d6..705c7ca9f 100644 --- a/docs/source/zh-cn/filters/sort.md +++ b/docs/source/zh-cn/filters/sort.md @@ -2,6 +2,8 @@ title: sort --- +{% since %}v1.9.1{% endsince %} + 对数组中的元素排序，排序方式为 JavaScript `Array.prototype.sort()`。 输入 diff --git a/docs/source/zh-cn/filters/sort_natural.md b/docs/source/zh-cn/filters/sort_natural.md index fae38d7af..dc097d025 100644 --- a/docs/source/zh-cn/filters/sort_natural.md +++ b/docs/source/zh-cn/filters/sort_natural.md @@ -2,6 +2,8 @@ title: sort_natural --- +{% since %}v8.4.0{% endsince %} + 大小写不敏感地对数组元素排序。 输入 diff --git a/docs/source/zh-cn/filters/split.md b/docs/source/zh-cn/filters/split.md index 2fd47fea8..328600213 100644 --- a/docs/source/zh-cn/filters/split.md +++ b/docs/source/zh-cn/filters/split.md @@ -2,6 +2,8 @@ title: split --- +{% since %}v1.9.1{% endsince %} + 把字符串按照指定的分隔符进行分割，`split` 通常用于把逗号分隔的字符串转换为数组。 输入 diff --git a/docs/source/zh-cn/filters/strip.md b/docs/source/zh-cn/filters/strip.md index df708e450..08dd4d3dc 100644 --- a/docs/source/zh-cn/filters/strip.md +++ b/docs/source/zh-cn/filters/strip.md @@ -2,6 +2,8 @@ title: strip --- +{% since %}v1.9.1{% endsince %} + 移除字符串两侧的空白字符（制表符、空格、换行），不影响词之间的空格。 输入 diff --git a/docs/source/zh-cn/filters/strip_html.md b/docs/source/zh-cn/filters/strip_html.md index f081886e0..ac907c911 100644 --- a/docs/source/zh-cn/filters/strip_html.md +++ b/docs/source/zh-cn/filters/strip_html.md @@ -2,6 +2,8 @@ title: strip_html --- +{% since %}v1.9.1{% endsince %} + 移除字符串中的 HTML 标签。 输入 diff --git a/docs/source/zh-cn/filters/strip_newlines.md b/docs/source/zh-cn/filters/strip_newlines.md index 3b17f7f6f..ca9eefe9a 100644 --- a/docs/source/zh-cn/filters/strip_newlines.md +++ b/docs/source/zh-cn/filters/strip_newlines.md @@ -2,6 +2,8 @@ title: strip_newlines --- +{% since %}v1.9.1{% endsince %} + 移除字符串中的换行符。 输入 diff --git a/docs/source/zh-cn/filters/times.md b/docs/source/zh-cn/filters/times.md index 70cf6f862..ea0d8adaf 100644 --- a/docs/source/zh-cn/filters/times.md +++ b/docs/source/zh-cn/filters/times.md @@ -2,6 +2,8 @@ title: times --- +{% since %}v1.9.1{% endsince %} + 两数相乘。 输入 diff --git a/docs/source/zh-cn/filters/truncate.md b/docs/source/zh-cn/filters/truncate.md index f103591f2..0ae5fa5e6 100644 --- a/docs/source/zh-cn/filters/truncate.md +++ b/docs/source/zh-cn/filters/truncate.md @@ -2,6 +2,8 @@ title: truncate --- +{% since %}v1.9.1{% endsince %} + 把字符串截断为指定长度，可以指定一个数字表示截断到多少长度。最后会添加一个省略号（...）且记在长度里。 ## 基本使用 diff --git a/docs/source/zh-cn/filters/truncatewords.md b/docs/source/zh-cn/filters/truncatewords.md index 1ef4068c3..62ae88215 100644 --- a/docs/source/zh-cn/filters/truncatewords.md +++ b/docs/source/zh-cn/filters/truncatewords.md @@ -2,6 +2,8 @@ title: truncatewords --- +{% since %}v1.9.1{% endsince %} + 把字符串截断为指定个数的单词，可以指定一个数字表示截断到多少个单词。最后会添加一个省略号（...）。 ## 基本使用 diff --git a/docs/source/zh-cn/filters/uniq.md b/docs/source/zh-cn/filters/uniq.md index 38328c2c2..85cff1466 100644 --- a/docs/source/zh-cn/filters/uniq.md +++ b/docs/source/zh-cn/filters/uniq.md @@ -2,6 +2,8 @@ title: uniq --- +{% since %}v1.9.1{% endsince %} + 移除数组中的重复元素。 输入 diff --git a/docs/source/zh-cn/filters/upcase.md b/docs/source/zh-cn/filters/upcase.md index 836c9bb58..945111949 100644 --- a/docs/source/zh-cn/filters/upcase.md +++ b/docs/source/zh-cn/filters/upcase.md @@ -2,6 +2,8 @@ title: upcase --- +{% since %}v1.9.1{% endsince %} + 字符串中每个字符都转为大写，对已经是小写的字符没有影响。 输入 diff --git a/docs/source/zh-cn/filters/url_decode.md b/docs/source/zh-cn/filters/url_decode.md index f99764cd3..8bfa63db5 100644 --- a/docs/source/zh-cn/filters/url_decode.md +++ b/docs/source/zh-cn/filters/url_decode.md @@ -2,6 +2,8 @@ title: url_decode --- +{% since %}v6.1.0{% endsince %} + 把 URL 编码的字符串解码。 输入 diff --git a/docs/source/zh-cn/filters/url_encode.md b/docs/source/zh-cn/filters/url_encode.md index bc3565f5d..3817d8743 100644 --- a/docs/source/zh-cn/filters/url_encode.md +++ b/docs/source/zh-cn/filters/url_encode.md @@ -2,6 +2,8 @@ title: url_encode --- +{% since %}v1.9.1{% endsince %} + 把字符串中 URL 不安全的字符转义为百分号编码。 输入 diff --git a/docs/source/zh-cn/filters/where.md b/docs/source/zh-cn/filters/where.md index df961f6a1..592ff5822 100644 --- a/docs/source/zh-cn/filters/where.md +++ b/docs/source/zh-cn/filters/where.md @@ -2,6 +2,8 @@ title: where --- +{% since %}v8.1.0{% endsince %} + 按照数组中对象的属性值来过滤得到新数组，如果未指定第二个参数（属性值）则过滤得到所有属性值为 [truthy][truthy] 的对象。 下面的例子中，假设你有一个 `products` 列表并且希望展示其中的厨房产品。使用 `where` 过滤器可以得到一个只包含 `"type"` 属性值为 `"kitchen"` 的元素的数组。 diff --git a/docs/source/zh-cn/tags/assign.md b/docs/source/zh-cn/tags/assign.md index 90d94c280..3b7382bfe 100644 --- a/docs/source/zh-cn/tags/assign.md +++ b/docs/source/zh-cn/tags/assign.md @@ -2,6 +2,8 @@ title: Assign --- +{% since %}v1.9.1{% endsince %} + 创建一个新变量。 输入 diff --git a/docs/source/zh-cn/tags/capture.md b/docs/source/zh-cn/tags/capture.md index a6731ec9b..0d6927bff 100644 --- a/docs/source/zh-cn/tags/capture.md +++ b/docs/source/zh-cn/tags/capture.md @@ -2,6 +2,8 @@ title: capture --- +{% since %}v1.9.1{% endsince %} + 把 `capture` 开闭标签之间的内容渲染后赋值给一个变量，这个变量的类型总是字符串。 输入 diff --git a/docs/source/zh-cn/tags/case.md b/docs/source/zh-cn/tags/case.md index 461bdbf6c..80d8a3cc0 100644 --- a/docs/source/zh-cn/tags/case.md +++ b/docs/source/zh-cn/tags/case.md @@ -2,6 +2,8 @@ title: case --- +{% since %}v1.9.1{% endsince %} + 创建一个 switch 语句，把变量跟不同的值比较。`case` 创建 switch 语句，`when` 比较它的值。 输入 diff --git a/docs/source/zh-cn/tags/comment.md b/docs/source/zh-cn/tags/comment.md index 1a8834729..7b9da4faa 100644 --- a/docs/source/zh-cn/tags/comment.md +++ b/docs/source/zh-cn/tags/comment.md @@ -2,6 +2,8 @@ title: Comment --- +{% since %}v1.9.1{% endsince %} + 让 Liquid 模板里一段代码不渲染。处于 `comment` 开闭标签之间的文本都不会输出，Liquid 代码都不会执行。 输入 diff --git a/docs/source/zh-cn/tags/cycle.md b/docs/source/zh-cn/tags/cycle.md index ba8405628..931b027ca 100644 --- a/docs/source/zh-cn/tags/cycle.md +++ b/docs/source/zh-cn/tags/cycle.md @@ -2,6 +2,8 @@ title: cycle --- +{% since %}v1.9.1{% endsince %} + 循环一组字符串按照它们传入的顺序打印出来。每次调用 `cycle` 打印下一个参数。 ## 基本使用 diff --git a/docs/source/zh-cn/tags/decrement.md b/docs/source/zh-cn/tags/decrement.md index 22235da56..dafa6f12d 100644 --- a/docs/source/zh-cn/tags/decrement.md +++ b/docs/source/zh-cn/tags/decrement.md @@ -2,6 +2,8 @@ title: Decrement --- +{% since %}v1.9.1{% endsince %} + 创建一个新的数字类型的变量，每次调用都把它的值减一。第一次是 `-1`。 输入 diff --git a/docs/source/zh-cn/tags/for.md b/docs/source/zh-cn/tags/for.md index 5343582b1..84e9d40ee 100644 --- a/docs/source/zh-cn/tags/for.md +++ b/docs/source/zh-cn/tags/for.md @@ -2,6 +2,8 @@ title: For --- +{% since %}v1.9.1{% endsince %} + 重复执行代码块的迭代标签。 ## 基本使用 diff --git a/docs/source/zh-cn/tags/if.md b/docs/source/zh-cn/tags/if.md index f3ca53022..264f9e10a 100644 --- a/docs/source/zh-cn/tags/if.md +++ b/docs/source/zh-cn/tags/if.md @@ -2,6 +2,8 @@ title: If --- +{% since %}v1.9.1{% endsince %} + 条件为 `true` 时执行某个代码块。 ## if diff --git a/docs/source/zh-cn/tags/include.md b/docs/source/zh-cn/tags/include.md index ea1dc6574..f62babcbc 100644 --- a/docs/source/zh-cn/tags/include.md +++ b/docs/source/zh-cn/tags/include.md @@ -2,6 +2,8 @@ title: Include --- +{% since %}v1.9.1{% endsince %} + {% note warn 已废弃 %} 这个标签已经废弃，请使用封装更好的 render 标签。 {% endnote %} diff --git a/docs/source/zh-cn/tags/increment.md b/docs/source/zh-cn/tags/increment.md index 983f311ff..721491f29 100644 --- a/docs/source/zh-cn/tags/increment.md +++ b/docs/source/zh-cn/tags/increment.md @@ -2,6 +2,8 @@ title: Increment --- +{% since %}v1.9.1{% endsince %} + 创建一个新的数字类型的变量，每次调用都把它的值加一。第一次为 `0`。 输入 diff --git a/docs/source/zh-cn/tags/layout.md b/docs/source/zh-cn/tags/layout.md index 97260bdea..120db9e2c 100644 --- a/docs/source/zh-cn/tags/layout.md +++ b/docs/source/zh-cn/tags/layout.md @@ -2,6 +2,8 @@ title: Layout --- +{% since %}v1.9.1{% endsince %} + ## 使用布局模板 套用模板 [根路径][root] 下的某个布局模板中。 diff --git a/docs/source/zh-cn/tags/raw.md b/docs/source/zh-cn/tags/raw.md index be9d3a599..71f7c4599 100644 --- a/docs/source/zh-cn/tags/raw.md +++ b/docs/source/zh-cn/tags/raw.md @@ -2,6 +2,8 @@ title: Raw --- +{% since %}v1.9.1{% endsince %} + `raw` 标签可以暂时禁用 LiquidJS 的语法。生成和 Liquid 冲突的语言（比如 Nunjucks、Handlebars）时很有用。 输入 diff --git a/docs/source/zh-cn/tags/render.md b/docs/source/zh-cn/tags/render.md index f4457857f..f1622be86 100644 --- a/docs/source/zh-cn/tags/render.md +++ b/docs/source/zh-cn/tags/render.md @@ -2,6 +2,8 @@ title: Render --- +{% since %}v9.2.0{% endsince %} + ## 基本使用 ### 渲染一个模板 diff --git a/docs/source/zh-cn/tags/tablerow.md b/docs/source/zh-cn/tags/tablerow.md index e924dc5c4..282223afb 100644 --- a/docs/source/zh-cn/tags/tablerow.md +++ b/docs/source/zh-cn/tags/tablerow.md @@ -2,6 +2,8 @@ title: Table Row --- +{% since %}v1.9.1{% endsince %} + 生成一个 HTML 表示，上下必须用 `` 和 `
` HTML 标签包裹起来。 ## 基本使用 diff --git a/docs/source/zh-cn/tags/unless.md b/docs/source/zh-cn/tags/unless.md index 50c5bfa37..a76ed3121 100644 --- a/docs/source/zh-cn/tags/unless.md +++ b/docs/source/zh-cn/tags/unless.md @@ -2,6 +2,8 @@ title: Unless --- +{% since %}v1.9.1{% endsince %} + 和 `if` 相反 —— 条件 **不满足** 时执行代码块。 输入 diff --git a/docs/themes/navy/layout/partial/all-contributors.swig b/docs/themes/navy/layout/partial/all-contributors.swig index 68b4fd6c5..4120bdb51 100644 --- a/docs/themes/navy/layout/partial/all-contributors.swig +++ b/docs/themes/navy/layout/partial/all-contributors.swig @@ -39,6 +39,7 @@ amit777 Steffen Schuldenzucker Pixcell + Jason Etcovitch diff --git a/docs/themes/navy/source/css/_partial/page.styl b/docs/themes/navy/source/css/_partial/page.styl index d234192a7..169948231 100644 --- a/docs/themes/navy/source/css/_partial/page.styl +++ b/docs/themes/navy/source/css/_partial/page.styl @@ -193,6 +193,9 @@ note-warn = hsl(0, 100%, 50%) border-left-color: note-info &.warn border-left-color: note-warn + .since + margin-top: 0; + font-style: italic; .note-title margin: 1em 0 0.5em display: block