(#1098) Add docs about escape option in post_link & asset_link helpers

[dailyrandomphoto]

Check List

Please read and check followings before submitting a PR.

• I want to publish my theme on Hexo official website.
  • I have read the theme publishing doc.
  • link URL is correct.
  • preview URL is correct.
  • preview URL web site is rendered correctly.
  • Add a screenshot to source/themes/screenshots.
  • Screenshot filename is same as value of name.
  • Screenshot size is 800 * 500.
  • Screenshot file format is png.
• I want to publish my plugin on Hexo official website.
  • I have read the plugin publishing doc.
  • link URL is correct.
• Others (Update, fix, translation, etc...)

Closes #1098
Related hexojs/hexo#3704

[curbengh]

PR LGTM. But somehow How to use <b> tag in title is not escaped, maybe need to clear the netlify cache.

[curbengh]

need workaround

[dailyrandomphoto]

@curbengh
When I generate hexojs/site project on my local, I found it takes a long time than before.
check this issue please.
hexojs/hexo#3758

[curbengh]

😕 command = "npm install && npm run build" doesn't seem to work.

Removing package-lock.json (as what you did) looks like a good approach. But instead of removing it in every build, you can add package-lock=false line to .npmrc file. For now, it's ok to remove it, so that it's removed from the cache (cross finger on this).

Let's try .npmrc and the original netlify command = "npm run build"

[curbengh]

command = "npm run build" still doesn't work, even with .npmrc 😞

@dailyrandomphoto
I think that's it for now, we've already caused too much inconvenience to you for debugging netlify. We'll try again with one of the functional workaround attempted here, in a separate PR. I do want to retain the .npmrc.

[dailyrandomphoto]

Ok. thank you.

"hexo": "hexojs/hexo#commit-hash"

I think this is a reliable and reasonable approach. So we can control the version of that we want.

[curbengh]

I'm wary of that approach as it introduce additional maintenance work.

I just had another idea,

Switch to "^4.0.0" (after its release, of course) for a while, then switch back to "hexojs/hexo".