資源(Asset)代表 source
文件夾中除了文章以外的所有文件,例如圖片、CSS、JS 文件等。比方說,如果你的Hexo項目中只有少量圖片,那最簡單的方法就是將它們放在 source/images
文件夾中。然后通過類似于 
的方法訪問它們。
對于那些想要更有規(guī)律地提供圖片和其他資源以及想要將他們的資源分布在各個文章上的人來說,Hexo也提供了更組織化的方式來管理資源。這個稍微有些復雜但是管理資源非常方便的功能可以通過將 config.yml
文件中的 post_asset_folder
選項設為 true
來打開。
post_asset_folder: true
當資源文件管理功能打開后,Hexo將會在你每一次通過 hexo new [layout] <title>
命令創(chuàng)建新文章時自動創(chuàng)建一個文件夾。這個資源文件夾將會有與這個文章文件一樣的名字。將所有與你的文章有關的資源放在這個關聯(lián)文件夾中之后,你可以通過相對路徑來引用它們,這樣你就得到了一個更簡單而且方便得多的工作流。
通過常規(guī)的 markdown 語法和相對路徑來引用圖片和其它資源可能會導致它們在存檔頁或者主頁上顯示不正確。在Hexo 2時代,社區(qū)創(chuàng)建了很多插件來解決這個問題。但是,隨著Hexo 3 的發(fā)布,許多新的標簽插件被加入到了核心代碼中。這使得你可以更簡單地在文章中引用你的資源。
{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}
比如說:當你打開文章資源文件夾功能后,你把一個 example.jpg
圖片放在了你的資源文件夾中,如果通過使用相對路徑的常規(guī) markdown 語法 
,它將 不會 出現(xiàn)在首頁上。(但是它會在文章中按你期待的方式工作)
正確的引用圖片方式是使用下列的標簽插件而不是 markdown :
{% asset_img example.jpg This is an example image %}
通過這種方式,圖片將會同時出現(xiàn)在文章和主頁以及歸檔頁中。
hexo-renderer-marked 3.1.0 introduced a new option that allows you to embed an image in markdown without using asset_img
tag
plugin.
To enable:
_config.ymlpost_asset_folder: true
marked:
prependRoot: true
postAsset: true
Once enabled, an asset image will be automatically resolved to its corresponding post’s path. For example, “image.jpg” is located at “/2020/01/02/foo/image.jpg”, meaning it is an asset image of “/2020/01/02/foo/“ post, 
will
be rendered as <img src="/2020/01/02/foo/image.jpg">
.
更多建議: