YunYouJun / valaxy

🌌 Next Generation Static Blog Framework (Beta) 下一代静态博客框架(支持页面/配置热重载)
https://valaxy.site
MIT License
713 stars 84 forks source link

是否有一个更简单的主题编写方法? #344

Closed gxres042 closed 7 months ago

gxres042 commented 7 months ago

导入

在朋友的推荐下,我计划从 VitePress 迁移到 Valaxy。但是目前的 starter 模板我研究的不是很明白。

我的预期

因为我的计划是 自己编写的这一个主题不发布到 NPM、不对外开源,所以 theme 的配置中的发布打包流程都可以忽略。

同时,在编写主题时,可以仅给出一个 App.vue 和布局(即首页和博客文章详情)实现方法即可。目前编写主题的文档和主题源码可以让我自行添加所需要的其它功能,如上下文章切换、分类、标签等。

YunYouJun commented 7 months ago

我理解就是区别于 starter 以博客为主体的定制模式。

(在过年,迟点我会提供一个模版

gxres042 commented 7 months ago

我理解就是区别于 starter 以博客为主体的定制模式。

(在过年,迟点我会提供一个模版

别急,过年我也没时间做(

gxres042 commented 7 months ago

我这边想了一下,示例应该是不用的。

如果我是从 App.vue 简单开始、按原本在 VitePress 上的写法的话,那迁移不会有什么问题。但考虑到 Valaxy 兼顾了标签、分类和上下文切换,我在迁移到 Valaxy 的时候必须要多兼顾到 layouts,以及上下文切换要怎么实现。

要不云游君别写示例了,提供一个 layouts 和上下文切换实现方法应该就可以了...?


对了,模板还是得给的,但 theme 里面就包含一个空的 App.vueindex.ts

YunYouJun commented 7 months ago

上下文切换是什么?

YunYouJun commented 7 months ago

我创建了一个 custom theme 的模版。https://github.com/YunYouJun/valaxy/tree/main/demo/custom

在本地引用主题即可。https://github.com/YunYouJun/valaxy/tree/main/demo/custom/valaxy-theme-custom

gxres042 commented 7 months ago

上下文切换是什么?

在文章详情的最下方快速切换至上一篇 / 下一篇文章。 脑子一冷就打出这五个字了。

YunYouJun commented 7 months ago

可参考 https://github.com/YunYouJun/valaxy/blob/main/packages/valaxy-theme-yun/components/YunPostNav.vue

<script lang="ts" setup>
import { usePrevNext } from 'valaxy'

const [prev, next] = usePrevNext()
</script>
gxres042 commented 7 months ago

多问一嘴,我想给主题的 @iconify-json 图标包换成 @iconify-json/ic,需要什么额外配置吗?

Big-Cake-jpg commented 7 months ago

多问一嘴,我想给主题的 @iconify-json 图标包换成 @iconify-json/ic,需要什么额外配置吗?

安装新的图标包,然后在 https://icones.js.org 上找到要用的图标,复制名称直接使用即可。