# 資源文件夾
資源(Asset)代表 `source` 文件夾中除了文章以外的所有文件,例如圖片、CSS、JS 文件等。比方說,如果你的Hexo項目中只有少量圖片,那最簡單的方法就是將它們放在 `source/images` 文件夾中。然后通過類似于 `` 的方法訪問它們。
## 文章資源文件夾
對于那些想要更有規律地提供圖片和其他資源以及想要將他們的資源分布在各個文章上的人來說,Hexo也提供了更組織化的方式來管理資源。這個稍微有些復雜但是管理資源非常方便的功能可以通過將 `config.yml` 文件中的 `post_asset_folder` 選項設為 `true` 來打開。
```
post_asset_folder: true
```
當資源文件管理功能打開后,Hexo將會在你每一次通過 `hexo new [layout] <title>` 命令創建新文章時自動創建一個文件夾。這個資源文件夾將會有與這個 markdown 文件一樣的名字。將所有與你的文章有關的資源放在這個關聯文件夾中之后,你可以通過相對路徑來引用它們,這樣你就得到了一個更簡單而且方便得多的工作流。
## 相對路徑引用的標簽插件
通過常規的 markdown 語法和相對路徑來引用圖片和其它資源可能會導致它們在存檔頁或者主頁上顯示不正確。在Hexo 2時代,社區創建了很多插件來解決這個問題。但是,隨著Hexo 3 的發布,許多新的標簽插件被加入到了核心代碼中。這使得你可以更簡單地在文章中引用你的資源。
```
{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}
```
比如說:當你打開文章資源文件夾功能后,你把一個 `example.jpg` 圖片放在了你的資源文件夾中,如果通過使用相對路徑的常規 markdown 語法 `` ,它將 _不會_ 出現在首頁上。(但是它會在文章中按你期待的方式工作)
正確的引用圖片方式是使用下列的標簽插件而不是 markdown :
```
{% asset_img example.jpg This is an example image %}
```
通過這種方式,圖片將會同時出現在文章和主頁以及歸檔頁中。
- 文檔
- 開始使用
- 概述
- 建站
- 配置
- 指令
- 遷移
- 基本操作
- 寫作
- Front-matter
- 標簽插件(Tag Plugins)
- 資源文件夾
- 數據文件
- 服務器
- 生成文件
- 部署
- 自定義
- 永久鏈接(Permalinks)
- 主題
- 模版
- 變量
- 輔助函數(Helpers)
- 國際化(i18n)
- 插件
- 其他
- 問題解答
- 貢獻
- API
- 核心
- 概述
- 事件
- 局部變量
- 路由
- Box
- 渲染
- 文章
- 腳手架(Scaffold)
- 主題
- 擴展
- 控制臺(Console)
- 部署器(Deployer)
- 過濾器(Filter)
- 生成器(Generator)
- 輔助函數(Helper)
- 遷移器(Migrator)
- 處理器(Processor)
- 渲染引擎(Renderer)
- 標簽插件(Tag)