docs: introduce JS script to escape for Hexo, fixes #480

bin/build-apidoc.sh

@@ -11,8 +11,6 @@ for file in $(find docs/source/api -name "*.md"); do
         -e 's/\(\]([^_)]*\)\/_/\1\//g' \
         -e 's/\(\]([^)]*\.\)md/\1html/g' \
         -e 's/\](_/\](/g' \
-        -e 's/{%/{% raw %}{%{% endraw %}/g' \
-        -e 's/{{/{% raw %}{{{% endraw %}/g' \
         -e '1 s/"/\"/g' \
         -e '1 s/</\&lt;/g' \
         -e '1 s/>/\&gt;/g' \
@@ -20,9 +18,7 @@ for file in $(find docs/source/api -name "*.md"); do
         -e '1 s/^# \(.*\)/---\ntitle: "\1"\nauto: true\n---/' \
         $file
     target=${file/\/_/\/}
-    if [ "$file" != "$target" ]; then
-        mv $file $target
-    fi
+    cat $file | ./bin/escape-nunjucks.js > $target
 done
 
 cp -r docs/source/api docs/source/zh-cn/api

bin/escape-nunjucks.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+// In Hexo, content inside markdown code/code fences,
+// will not go through nunjucks.
+// So we're escaping special chars outside code only.
+let backTick = 0
+process.stdin.on('data', (buffer) => {
+  for (const c of buffer.toString()) {
+    if (c === '`') {
+      backTick++
+    }
+    const shouldEscape = '{%%}'.includes(c) && backTick % 2 === 0
+    if (shouldEscape) {
+      const code = c.charCodeAt(0).toString(16)
+      process.stdout.write(`&#x${code};`)
+    } else process.stdout.write(c)
+  }
+})