feat: array_to_sentence_string and number_of_words filters from Jekyll, #443

docs/source/_data/sidebar.yml

@@ -26,6 +26,7 @@ tutorials:
     contribution_guidelines: contribution-guidelines.html
 
 filters:
+  array_to_sentence_string: array_to_sentence_string.html
   overview: overview.html
   abs: abs.html
   append: append.html
@@ -63,6 +64,7 @@ filters:
   modulo: modulo.html
   newline_to_br: newline_to_br.html
   normalize_whitespace: normalize_whitespace.html
+  number_of_words: number_of_words.html
   plus: plus.html
   pop: pop.html
   push: push.html

docs/source/filters/array_to_sentence_string.md

@@ -0,0 +1,27 @@
+---
+title: array_to_sentence_string
+---
+
+{% since %}v10.13.0{% endsince %}
+
+Convert an array into a sentence. Useful for listing tags. Optional argument for connector.
+
+Input
+```liquid
+{{ "foo,bar,baz" | split: "," | array_to_sentence_string }}
+```
+
+Output
+```text
+foo, bar, and baz
+```
+
+Input
+```liquid
+{{ "foo,bar,baz" | split: "," | array_to_sentence_string: "or" }}
+```
+
+Output
+```text
+foo, bar, or baz
+```

docs/source/filters/number_of_words.md

@@ -0,0 +1,49 @@
+---
+title: number_of_words
+---
+
+{% since %}v10.13.0{% endsince %}
+
+Count the number of words in some text. This filter takes an optional argument to control the handling of Chinese-Japanese-Korean (CJK) characters in the input string:
+- Passing 'cjk' as the argument will count every CJK character detected as one word irrespective of being separated by whitespace.
+- Passing 'auto' (auto-detect) works similar to 'cjk' but is more performant if the filter is used on a variable string that may or may not contain CJK chars.
+
+Input
+```liquid
+{{ "Hello world!" | number_of_words }}
+```
+
+Output
+```text
+2
+```
+
+Input
+```liquid
+{{ "你好hello世界world" | number_of_words }}
+```
+
+Output
+```text
+1
+```
+
+Input
+```liquid
+{{ "你好hello世界world" | number_of_words: "cjk" }}
+```
+
+Output
+```text
+6
+```
+
+Input
+```liquid
+{{ "你好hello世界world" | number_of_words: "auto" }}
+```
+
+Output
+```text
+6
+```

docs/source/filters/overview.md

@@ -10,7 +10,7 @@ There's 40+ filters supported by LiquidJS. These filters can be categorized into
 Categories | Filters
 --- | ---
 Math | plus, minus, modulo, times, floor, ceil, round, divided_by, abs, at_least, at_most
-String | append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, replace_last,remove, remove_first, remove_last, truncate, truncatewords, normalize_whitespace
+String | append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, replace_last,remove, remove_first, remove_last, truncate, truncatewords, normalize_whitespace, number_of_words, array_to_sentence_string
 HTML/URI | escape, escape_once, url_encode, url_decode, strip_html, newline_to_br, xml_escape, cgi_escape, uri_escape
 Array | slice, map, sort, sort_natural, uniq, where, where_exp, group_by, group_by_exp, find, find_exp, first, last, join, reverse, concat, compact, size, push, pop, shift, unshift
 Date | date, date_to_xmlschema, date_to_rfc822, date_to_string, date_to_long_string

docs/source/zh-cn/filters/array_to_sentence_string.md

@@ -0,0 +1,27 @@
+---
+title: array_to_sentence_string
+---
+
+{% since %}v10.13.0{% endsince %}
+
+把数组转化为句子，用于做标签列表。有一个可选的连接词参数。
+
+输入
+```liquid
+{{ "foo,bar,baz" | split: "," | array_to_sentence_string }}
+```
+
+输出
+```text
+foo, bar, and baz
+```
+
+输入
+```liquid
+{{ "foo,bar,baz" | split: "," | array_to_sentence_string: "or" }}
+```
+
+输出
+```text
+foo, bar, or baz
+```

docs/source/zh-cn/filters/number_of_words.md

@@ -0,0 +1,49 @@
+---
+title: number_of_words
+---
+
+{% since %}v10.13.0{% endsince %}
+
+计算文本中的单词数。此过滤器接受一个可选参数，用于控制输入字符串中汉字-日语-韩语（CJK）字符的处理方式：
+- 将 'cjk' 作为参数传递将会将每个检测到的 CJK 字符计为一个单词，无论是否由空格分隔。
+- 将 'auto' （自动检测）作为参数传递与 'cjk' 类似，但如果过滤器用于可能包含或不包含 CJK 字符的字符串，则性能更好。
+
+Input
+```liquid
+{{ "Hello world!" | number_of_words }}
+```
+
+Output
+```text
+2
+```
+
+Input
+```liquid
+{{ "你好hello世界world" | number_of_words }}
+```
+
+Output
+```text
+1
+```
+
+Input
+```liquid
+{{ "你好hello世界world" | number_of_words: "cjk" }}
+```
+
+Output
+```text
+6
+```
+
+Input
+```liquid
+{{ "你好hello世界world" | number_of_words: "auto" }}
+```
+
+Output
+```text
+6
+```

docs/source/zh-cn/filters/overview.md

@@ -10,7 +10,7 @@ LiquidJS 共支持 40+ 个过滤器，可以分为如下几类：
 类别 | 过滤器
 --- | ---
 数学 | plus, minus, modulo, times, floor, ceil, round, divided_by, abs, at_least, at_most
-字符串 | append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, replace_last, remove, remove_first, remove_last, truncate, truncatewords, normalize_whitespace
+字符串 | append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, replace_last, remove, remove_first, remove_last, truncate, truncatewords, normalize_whitespace, number_of_words, array_to_sentence_string
 HTML/URI | escape, escape_once, url_encode, url_decode, strip_html, newline_to_br, xml_escape, cgi_escape, uri_escape
 数组 | slice, map, sort, sort_natural, uniq, where, where_exp, group_by, group_by_exp, find, find_exp, first, last, join, reverse, concat, compact, size, push, pop, shift, unshift
 日期 | date, date_to_xmlschema, date_to_rfc822, date_to_string, date_to_long_string