自定义扩展

Valaxy 以约定大于配置的方式提供了强大的扩展功能,如果你有一定开发经验,可以自定义控制站点的每一处细节。

以下内容无论对于用户还是主题开发者来说都同样适用。

提示

默认在用户站点根目录或主题根目录下操作。

如果你想要有所参考,你可以参见 valaxy-theme-yun

自动布局注册

基于 vite-plugin-vue-layouts-next,Valaxy 提供了布局功能。

新建 layouts 文件,书写 Vue 组件作为布局。

你可以在 Markdown 中如下使用它。

pages/album.md
md[object Promise]

同样,当存在同名布局时,覆盖顺序为 用户目录 -> 主题目录 -> Valaxy 客户端目录

自定义 index.html

新建 index.html,你可以在 <head></head><body></body> 全局地插入任意内容。

譬如:

index.html
html[object Promise]

扩展 Client 上下文

新建 setup/main.ts

setup/main.ts
ts[object Promise]

具体示例可参见 谷歌统计|第三方集成

多语言支持

新建 locales 文件夹。

  • zh-CN.yml: 中文翻译
  • en.yml: 英文翻译

譬如(请确保文件内容非空):

locales/en.yml
yaml[object Promise]
locales/zh-CN.yml
yaml[object Promise]

你可以如下方式使用它:

components/CustomButton.vue
vue[object Promise]

模版文件

新建某类布局 Markdown 文件的模版。(开发中)

新建 scaffolds 文件夹。

bash[object Promise]
  • layout: 默认为 post

新建 xxx.md,xxx 取决于你的布局名称。 譬如 album.md 代表 layout: album

bash[object Promise]

其他


To Be Continued.

贡献者