一款功能齐全的、现代化的、简洁优雅的静态博客,基于vitepress;主要记录✍️我的博客、笔记。
每周末/周六如有更新release一次,文章发布以及网站修改会记录在release中,欢迎star/watch(custom->release)关注最新动态~
简体中文 | English Docs
| 功能特点 | 说明 |
|---|---|
| 白/夜切换使用不同主题色 | 蓝/黄 |
| 集成giscus评论 | 适配深色模式 |
| 自动生成RSS订阅文件 | 链接 |
| 短链接生成 | 为语义化中文URL生成易于社交分享的链接,如justin3go.com/s?u=590f2bc50aa |
| 首页自动生成最近文章目录 | -- |
| 首页视频背景播放 | 移动端会降级显示为图片 |
| github action监听push操作,自动部署至github page | 点击链接查看详情 |
| github action自动生成Changelog | Changelog |
| 集成google analytic 与 google adsense | 为提高体验,google adsense已删除,可以在该commit中查看如何新增它 |
| 社交分享优化 | 链接自动生成twitter卡片 |
| 全局图片大图预览 | 基于TDesign |
以下链接为笔者建站过程中的一些博客记录,也许对您有所帮助:
- vitepress中引入Tdesign并全局增加大图预览
- vitepress中增加twitter/x卡片
- 给vitepress增加短链接生成功能
- vitepress博客里增加一个RSS订阅
- 简单优化下个人博客首页(迁移vitepress-beta版)
- 极简地给个人博客添加订阅功能
- 玩转vitepress
npm i -g pnpm
# 安装依赖
pnpm install
pnpm docs:dev值得注意的是,gitcus评论组件中的参数需要你自己生成,否则评论会出现在该仓库而非你的仓库,点击链接查看详情
分支介绍:
- master分支为正式分支,用于发布版本,自动监听Push发版
- online分支为线上分支,用于部署,自动监听Push部署
- 其他分支为功能分支,用于开发
由于本项目并没有做过多的功能开发,更多使用的是vitepress本身自带的功能,仅仅只设计了一小部分,所以没有封装为主题,开源主要是提供一些思路参考,如果你想直接clone使用的话,并不能直接开箱即用,本仓库可能更适合一些比较喜欢折腾的朋友进行使用。
奔跑的狼
笔者的笔名为Justin3go,Justin为我的英文名,3go代表的go go go,同时也可以看作just in go go go。狼是我喜欢的动物,奔跑则与go go go相对应。
关于笔者
- 相关社交链接放在了首页这个部分,笔者认为这样更加直观,而且也不会影响阅读体验。只有RSS订阅放在了网站的全局右上角,因为RSS订阅更多的是与站点强相关的,过多的链接
icon放在右上角显得杂乱; - 增加了笔者技术栈的使用占比,毕竟作为一个技术博客网站,读者可以通过这个部分了解笔者的技术栈,从而更好的了解笔者的博客文章类型,以判断该博客网站是否适合自己;
- react由于是tsx\jsx后缀,好像分类为了ts/js,这是wakatime自动分类的,就这样吧;
最近发布
- 为什么不做分页以展示全部的文章,笔者理解读者更多只会查看最近几篇文章,就和google搜索出来的结果80%的人都不会点击第二页一样;
- 至于想要查看笔者以前的文章,则直接点击笔者的博客归档就可以了,侧边栏加内容加大纲的方式是笔者理解的一种非常好的阅读页面设置;
- 为什么不做摘要,只有题目:懒🤣;
留言板
为什么主页还有增加留言板,不是每篇文章都可以评论吗?留言板更多是对整个网站或者笔者进行留言,而非针对具体内容。
本仓库中所有后缀为.md的文件均采用以下协议进行许可:
Creative Commons Attribution 4.0 International License,本作品采用知识共享署名 4.0 国际许可协议进行许可。
您可以自由地共享和演绎本作品,但需遵循以下条件:署名:您必须给出适当的署名,提供指向本许可协议的链接,同时标明是否作出了修改。您可以用任何合理的方式来署名,但不得以任何方式暗示许可人为您或您的使用背书。
其余文件均为 MIT 协议,详细的许可证条款和条件可参见此链接
