🚀一款简洁高效的VuePress知识管理&博客(blog)主题

Overview

logo

CI baiduPush License npm GitHub stars

vuepress-theme-vdoing

介绍

  1. 这个主题的初衷是打造一个好用的、面向程序员的知识管理工具
  2. 轻松构建一个结构化的知识库,让你的知识海洋像一本本书一样清晰易读。
  3. 博客功能提供一种知识的碎片化形态,并支持个性化博客配置。
  4. 简洁高效,以 Markdown 为中心的项目结构。内置自动化工具,以更少的配置完成更多的事。配合多维索引快速定位每个知识点。

更新日志

这个主题可以做什么?

快速上手

# clone the project
git clone https://github.com/xugaoyi/vuepress-theme-vdoing.git

# enter the project directory
cd vuepress-theme-vdoing

# install dependency
npm install # or yarn install

# develop
npm run dev # or yarn dev

⚡️ 未来...

VuePress-next (VuePress v2.0)

VuePress-next with the power of Vue 3.0 and TypeScript

VitePress

  • Uses Vue 3.
  • Uses vite under the hood:
  • Vue 3 tree-shaking + Rollup code splitting

VuePress' little brother, built on top of vite. It's currently under a different name so that we don't over commit to the compatibility with the current VuePress ecosystem (mostly themes and plugins). We'll see how close we can get without compromising the design goals listed above. But the overall idea is that VitePress will have a drastically more minimal theming API (preferring JavaScript APIs instead of file layout conventions) and likely no plugins (all customization is done in themes).

期待 VuePress v2.0 以及 VitePress 的正式发布...

届时,VuePress 1.x 编译慢的缺点将得到极大的改善。我将会视情况把主题升级至 VuePress v2.0 或 VitePress,也可能两个都升级。目前(2020.10.29)来看还需要一段时间才能让大家使用上基于它们的新版本,还希望大家多多 💖 支持 哟,持续关注吧~

💖 支持这个项目

如果你正在使用这个项目并感觉良好,或只是想要支持我继续开发,你可以通过如下任意 方式支持我:

  1. Star 并 分享这个项目 🚀
  2. 保留主题 footer(页脚) 的主题链接 :D
  3. 购买前端学习类 电子书 Ⓤⓟ 💯
  4. 轻轻点击一次页面广告
  5. 通过以下二维码 一次性捐款。 我多半会买一杯 咖啡 茶。 🍵

谢谢! ❤️

微信赞赏 微信 支付宝
赞赏码 Wechat QRcode Alipay QRcode

二维码没有正常显示?点 这里 😎

致谢

❤️ 感谢支持这个项目的朋友

❤️ 感谢为这个项目贡献代码的朋友 → Contributors

Vdoing官方交流群

群号:694387113

群号:694387113

许可证

MIT

Copyright (c) 2019-present Evan Xu

Issues
  • 「评论」解决百度无法收录搭建在GitHub上的个人博客的问题

    「评论」解决百度无法收录搭建在GitHub上的个人博客的问题

    页面:https://xugaoyi.com/pages/41f87d890d0a02af/

    41f87d890d0a02af Comment Gitalk 
    opened by xugaoyi 36
  • 「评论」关于

    「评论」关于

    页面:https://xugaoyi.com/about/

    /about Comment Gitalk 
    opened by xugaoyi 23
  • 老哥你的markdown玩的不够六啊

    老哥你的markdown玩的不够六啊

    以下纯markdown打出来的,猜猜怎么打的?

    ::: cardList
    ```yaml
    - name: 麋鹿鲁哟
      desc: 大道至简,知易行难
      avatar: https://cdn.jsdelivr.net/gh/xugaoyi/image_store/blog/20200122153807.jpg # 可选
      link: https://www.cnblogs.com/miluluyo/ # 可选
      bgColor: '#CBEAFA' # 可选,默认var(--bodyBg)。颜色值有#号时请添加单引号
      textColor: '#6854A1' # 可选,默认var(--textColor)
    - name: XAOXUU
      desc: '#IOS #Volantis主题作者'
      avatar: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/avatar/avatar.png
      link: https://xaoxuu.com
      bgColor: '#718971'
      textColor: '#fff'
    - name: 平凡的你我
      desc: 理想成为大牛的小陈同学
      avatar: https://reinness.com/avatar.png
      link: https://reinness.com
      bgColor: '#FCDBA0'
      textColor: '#A05F2C'
    ```
    :::
    
    opened by Mister-Hope 17
  • 「评论」友情链接

    「评论」友情链接

    页面:https://xugaoyi.com/friends/

    /friends Comment Gitalk 
    opened by xugaoyi 13
  • 黑暗主题下存在bug

    黑暗主题下存在bug

    鼠标在页面中滑动的时候会出现别的背景色,侧边栏会有抖动,有很多地方都有些小问题

    opened by Gyang18 8
  • 添加文章后打包失败

    添加文章后打包失败

    您好 首先非常喜欢您的这个主题,但是这里打包运行npm run build时报错了,如下所示,望提点一下问题所在,感谢!

    PS C:\Users\Administrator\Desktop\vue\vuepress-theme-vdoing-master> npm run build
    
    > [email protected] build C:\Users\Administrator\Desktop\vue\vuepress-theme-vdoing-master
    > vuepress build docs
    
    wait Extracting site metadata...
    tip add sidebar data. 侧边栏数据成功生成。
    tip Apply theme vuepress-theme-index ...
    tip Apply plugin container (i.e. "vuepress-plugin-container") ...
    tip Apply plugin @vuepress/register-components (i.e. "@vuepress/plugin-register-components") ...
    tip Apply plugin @vuepress/active-header-links (i.e. "@vuepress/plugin-active-header-links") ...
    tip Apply plugin @vuepress/search (i.e. "@vuepress/plugin-search") ...
    tip Apply plugin @vuepress/nprogress (i.e. "@vuepress/plugin-nprogress") ...
    tip Apply plugin thirdparty-search (i.e. "vuepress-plugin-thirdparty-search") ...
    tip Apply plugin baidu-autopush (i.e. "vuepress-plugin-baidu-autopush") ...
    tip Apply plugin one-click-copy (i.e. "vuepress-plugin-one-click-copy") ...
    tip Apply plugin demo-block (i.e. "vuepress-plugin-demo-block") ...
    tip Apply plugin zooming (i.e. "vuepress-plugin-zooming") ...
    tip Apply plugin baidu-tongji (i.e. "vuepress-plugin-baidu-tongji") ...
    tip Apply plugin comment (i.e. "vuepress-plugin-comment") ...
    tip Apply plugin @vuepress/last-updated (i.e. "@vuepress/plugin-last-updated") ...
    
    √ Client
      Compiled successfully in 2.36m
    
    √ Server
      Compiled successfully in 1.57m
    
    Language does not exist: chart
    Language does not exist: mermaid
    Language does not exist: mermaid
    Language does not exist: mermaid
    wait Rendering static HTML...
    How to use ""gitalk"" in [email protected]: https://github.com/dongyuanxin/vuepress-plugin-comment#readme
    [Vue warn]: Error in render: "URIError: URI malformed"
    
    found in
    
    ---> <Anonymous>
           <GlobalLayout>
             <Root>
    [Vue warn]: Error in render: "URIError: URI malformed"
    
    found in
    
    ---> <Anonymous>
           <GlobalLayout>
             <Root>
    error Error rendering /pages/10324/: false
    undefined
    error Error rendering /pages/bd56bb/: false
    undefined
    URIError: URI malformed
        at decodeURI (<anonymous>)
        at normalize (theme-vdoing/util/index.js:7:9)
        at resolvePage (theme-vdoing/util/index.js:66:15)
        at resolveItem (theme-vdoing/util/index.js:221:25)
        at server-bundle.js:1124:14
        at Array.map (<anonymous>)
        at resolveSidebarItems (theme-vdoing/util/index.js:142:15)
        at Proxy.sidebarItems (theme-vdoing/layouts/Layout.vue:149:0)
        at Proxy.computedGetter (C:\Users\Administrator\Desktop\vue\vuepress-theme-vdoing-master\node_modules\vue\dist\vue.runtime.common.dev.js:4831:15)
        at Proxy.shouldShowSidebar (theme-vdoing/layouts/Layout.vue:143:0)
        at Proxy.computedGetter (C:\Users\Administrator\Desktop\vue\vuepress-theme-vdoing-master\node_modules\vue\dist\vue.runtime.common.dev.js:4831:15)
        at Proxy.pageClasses (theme-vdoing/layouts/Layout.vue:163:0)
        at Proxy.computedGetter (C:\Users\Administrator\Desktop\vue\vuepress-theme-vdoing-master\node_modules\vue\dist\vue.runtime.common.dev.js:4831:15)
        at Proxy.render (theme-vdoing/layouts/Layout.vue?edb8:1:106)
        at VueComponent.Vue._render (C:\Users\Administrator\Desktop\vue\vuepress-theme-vdoing-master\node_modules\vue\dist\vue.runtime.common.dev.js:3538:22)
        at resolve (C:\Users\Administrator\Desktop\vue\vuepress-theme-vdoing-master\node_modules\vue-server-renderer\build.dev.js:8415:27)
    npm ERR! code ELIFECYCLE
    npm ERR! errno 1
    npm ERR! [email protected] build: `vuepress build docs`
    npm ERR! Exit status 1
    npm ERR!
    npm ERR! Failed at the [email protected] build script.
    npm ERR! This is probably not a problem with npm. There is likely additional logging output above.
    
    npm ERR! A complete log of this run can be found in:
    npm ERR!     C:\Users\Administrator\AppData\Roaming\npm-cache\_logs\2020-10-14T01_35_46_360Z-debug.log
    PS C:\Users\Administrator\Desktop\vue\vuepress-theme-vdoing-master>
    
    opened by summerking1 8
  • 有高亮行的代码块的一个小bug:无法拖动与选择

    有高亮行的代码块的一个小bug:无法拖动与选择

    当代码块加入高亮某些行后,这个代码块变得无法手动复制(甚至无法选择),无法左右滑动(窄屏)。

    2

    https://user-images.githubusercontent.com/44738481/102611424-d83a4100-4169-11eb-8acb-5d836570392d.mp4


    另外我有个小疑惑,我每次更新一个文档(比如仅是增删内容),“上次更新时间”都是全部页面都变动,我怎么做才能只让我更新的那个文档更新而别的文档更新时间不动?


    另外加个牌面:deepin的文档用了vdoing主题,我说看着那么眼熟,拉到下面一看果然233

    opened by northword 7
  • 能否支持在文章页面内显示章节?

    能否支持在文章页面内显示章节?

    似乎没有发现在文章页面内显示章节的功能(原生的vuepress也没有,都是混合在侧边栏),有做这个的计划吗?

    opened by yx91490 6
  • 部署问题

    部署问题

    请问,我想部署在自己的云服务器上并且自己push代码到github上就自动打包更新,大佬有什么推荐方法吗?

    opened by ytppp 6
  • Update README.MD

    Update README.MD

    opened by resetmylife 1
  • Update index.js

    Update index.js

    修改replace方法的Bug

    opened by resetmylife 1
  • 摘要内容中含有代码块儿的样式问题

    摘要内容中含有代码块儿的样式问题

    当摘要内容中含有代码块儿,而且代码块儿内容比较长是,就会出现如下情况:

    image

    opened by eryajf 4
  • 【需求】:希望增加文章摘要默认文字数以及图片样式

    【需求】:希望增加文章摘要默认文字数以及图片样式

    两周前开始入坑vuepress-vdoing,没想到很快百度就有了收录,但是文章简介的地方看起来就有点尴尬了,如下图:

    EC3B55A62930F45D4CCB722B1A4E9A4D

    于是想到应该每篇文章没有摘要内容所致!

    现在文章摘要是通过more标签为每篇文章自定义,这样会带来一个问题是,不同的文章摘要长短不一,图片的样式也不统一,使得文章区域就显得不够好看。

    因此建议:有一个总开关控制,如果true,那么就默认取文章前n个(或支持自定义)字作为摘要描述,默认取对应文章首图作为图片,如果文章内没有图片,则会有几张默认图片随机展示。

    取原来WordPress示例如下,图片统一大小在左,摘要再右:

    1A5B92993938D50CECE1742E1D897B35

    这种统一风格的样式在百度收录之后显得也比较好看:

    5454408D51B94D4286E2DF55AADE1944

    opened by eryajf 0
  • 需求: article设为true的非文章页,依旧可以通过分类和标签搜索到

    需求: article设为true的非文章页,依旧可以通过分类和标签搜索到

    一些技术笔记,我不希望出现首页的文章列表里,但希望仍然可以通过分类和标签快速搜索到

    现状:article设为true后,首页文章列表不出现,分类和标签不收录,搜索不到

    需求:article设为true后,首页文章列表不出现,分类和标签可以搜索到,或许可以加个front matte属性控制是否记录分类和标签

    opened by suweite 0
  • 修改配置项目,增加live2d cat

    修改配置项目,增加live2d cat

    想着做一个类别单一的知识库,不需要用到组件mainlayout,这个时候如果单纯去掉左边的postList以及右边blogger,在样式上会有些许奇怪,主要是与footer的间隔会变得很大,所以改成可选的,默认为true,如果不想要的情况下直接把themeConfig中的hasMainLayout的注释打开就可以了。

    opened by noransu 3
  • 关于使用Actions部署后,文章的最近更新时间存在时区差别的问题

    关于使用Actions部署后,文章的最近更新时间存在时区差别的问题

    .github/workflows/ci.yml文件设置正确的时区即可,如:

    env:
      TZ: Asia/Shanghai # 时区
    
    opened by xugaoyi 0
  • 关于 Actions 中栈溢出的问题

    关于 Actions 中栈溢出的问题

    出现此问题可尝试将.github/workflows/ci.yml文件中的node版本升级到v12以上

    opened by xugaoyi 0
  • 关于上次更新时间全都是最后一次git提交时间的问题

    关于上次更新时间全都是最后一次git提交时间的问题

    出现此问题有可能是因为actions里用了checkout v2,它会导致获取的git时间都是最后一次提交的时间,换成checkout v1或给v2加参数 fetch-deep: 0 即可,供参考。

     steps:
              - name: Checkout
                uses: actions/[email protected]
                with:
                    fetch-depth: 0
    
    opened by xugaoyi 0
  • 申请加入文档站案例页

    申请加入文档站案例页

    欢迎使用Vdoing主题的小伙伴在这个Issue留下你的站点信息,你的站点将有机会出现在Vdoing主题文档站的 案例 页面里。

    站点要求:

    • 使用Vdoing主题
    • 有10篇以上文章
    • 保留 footer 的主题推荐链接

    留言格式:

    名称:站点名称
    简介:站点简介
    链接:站点链接
    截图:站点截图链接
    作者:作者名称
    头像:作者头像链接
    
    备注(可选): 知识库兼博客 | 社区 | 知识库 | 博客 | 文档站
    
    opened by xugaoyi 27
Releases(v1.8.3)
Owner
Evan Xu
前端界的小学生
Evan Xu
💥 A simple and beautiful vuepress Blog & Doc theme.

?? A simple and beautiful vuepress Blog & Doc theme.

vuepress-reco 1.3k Jul 22, 2021
Tailwind CSS Button Components built with Vite, Vue, and Tailwind JIT

This is a blog post/tutorial for creating button components using Tailwind CSS. As a bonus we'll leverage some modern tools like Vite and Tailwind's new JIT feature which makes local developement with Tailwind CSS blazing fast.

Andy Leverenz 5 Jun 18, 2021