Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

【网页版文档相关】vuepress 深色模式支持 #803

Closed
188102836 opened this issue Aug 31, 2023 · 12 comments
Closed

【网页版文档相关】vuepress 深色模式支持 #803

188102836 opened this issue Aug 31, 2023 · 12 comments
Labels
文档/Document 文档格式内容修改及补充 想法/Idea 提供全新的观点

Comments

@188102836
Copy link
Contributor

No description provided.

@xiaoyv404 xiaoyv404 added the 想法/Idea 提供全新的观点 label Sep 1, 2023
@catlair
Copy link
Contributor

catlair commented Sep 1, 2023

vvuepress1 有官方的 dark 支持吗,好像没有

@188102836
Copy link
Contributor Author

vvuepress1 有官方的 dark 支持吗,好像没有

可以自己写组件吧,vuepress 支持自定义组件

@188102836
Copy link
Contributor Author

188102836 commented Sep 2, 2023

v1 应该不会集成 ( vuejs/vuepress#114 (comment) ),需要自己写,
可以参考 vuejs/vuepress#1865

v2 已经集成了,不过目前 v2 处于 beta 阶段

要从 v1 迁移的话,可以看官方文档

@catlair
Copy link
Contributor

catlair commented Sep 2, 2023

并不建议迁移至v2,v2属于脑热产物,现已烂尾

@catlair
Copy link
Contributor

catlair commented Sep 2, 2023

要从 v1 迁移的话,可以看官方文档

这是VuePress Theme Hope主题的文档,而非官方文档,不过这个主题有 dark

@188102836
Copy link
Contributor Author

这是VuePress Theme Hope主题的文档,而非官方文档,不过这个主题有 dark

是的,粘贴错了,官方文档在这
https://v2.vuepress.vuejs.org/zh/guide/migration.html

@catlair
Copy link
Contributor

catlair commented Sep 3, 2023

迁移的问题不在框架本身,主要两点

  1. 易姐是否同意
  2. 目前文档存在大量错误引用,包括锚点,链接和图片,在v1这些会被忽略,但是v2不会,这才是最难迁移的

@xiaoyv404
Copy link
Collaborator

@SocialSisterYi

迁移的问题不在框架本身,主要两点

1. 易姐是否同意

2. 目前文档存在大量错误引用,包括锚点,链接和图片,在v1这些会被忽略,但是v2不会,这才是最难迁移的

@catlair
Copy link
Contributor

catlair commented Sep 3, 2023

这里有个预览 https://catlair.github.io/bilibili-API-collect/

已完成:

  • 修复死链和错误链接
  • 修复错误的 </br> 标签
  • 修复多余或缺少的 details 标签
  • 迁移 Copyright footer
  • 删除不必要的 to top 插件

未完成:

  • nav 行为一致
  • 首页徽章样式一致
  • 修正 link icon 链接
  • CONTRIBUTING 中错误的 LICENSE 链接

@SocialSisterYi
Copy link
Owner

迁移的问题不在框架本身,主要两点

  1. 易姐是否同意
  2. 目前文档存在大量错误引用,包括锚点,链接和图片,在v1这些会被忽略,但是v2不会,这才是最难迁移的

目前不怎么希望迁移至 v2,主要还是考虑迁移工作量

但后面如使用 #604 中提到的 MarkLanguage 开新 branch(或重构),可以在它生成 md 后,尝试使用 v2 构建

@SocialSisterYi SocialSisterYi changed the title [网页相关] 深色模式支持 【网页版文档相关】vuepress 深色模式支持 Sep 3, 2023
This was referenced Sep 4, 2023
@catlair
Copy link
Contributor

catlair commented Sep 5, 2023

目前不怎么希望迁移至 v2,主要还是考虑迁移工作量

#806 已经完成文档中错误内容的修复。

只需要迁移配置文件和自定义的 footer 即可 #807

使用 v2 在 build 速度上有巨大提升

image

image

@xiaoyv404 xiaoyv404 added the 文档/Document 文档格式内容修改及补充 label Sep 6, 2023
@xiaoyv404
Copy link
Collaborator

Close by #807

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
文档/Document 文档格式内容修改及补充 想法/Idea 提供全新的观点
Projects
None yet
Development

No branches or pull requests

4 participants