你可以在 markdown
(或 mdx
)文件中导入静态资源。相对路径和绝对路径都是支持的,例如,如果在 markdown 同级目录有一张图片,你可以像这样引用它:
![](./island.png)
当然,在 mdx
文件中你也可以直接使用 img 标签:
<img src="./island.png" />
Island.js 将会根据 mdx 路径和图片路径,自动找到图片并响应给浏览器。
另一方面,也可以使用绝对路径导入静态资源。这样,Island.js 将会先后在两个地方查找文件:
island dev docs
,那么根目录就是 docs
public
文件夹例如,如果根目录是 docs
并且你有一个文件 docs/public/island.png
,你可以像这样引用它:
![](/island.png)
同时,如果你有一个文件 docs/assets/island.png
,你可以像这样引用它:
![](/assets/island.png)
上文提到过,你可以把你的静态资源放在 public
目录中,Island.js 将自动在 public
目录寻找资源。在生产环境中,
Island.js 会将 public
目录中的所有文件复制到产物目录(dist
)。
比如:
docs
├── public
│ └── island.png
在生产环境构建后,Island.js 将会在 dist
目录下生成 island.png
文件:
docs
├── public
│ └── island.png
├── .island
│ └── dist
│ └── island.png
│ └── index.html
│ └── ...