每一个程序员都应该有写博客:使用VuePress搭建一个博客系统

你好啊,我是大阳。一个撸码近十年的程序员。

不知道你是否有这样的职场困惑:职场三年没有任何进步;学了很多,毛用没有;学了,过了一年全都忘记了,更不知道怎么把已经学到的知识迁移到其他领域或者行业。

也就是搬砖多年,一直都没有在自己的专业上建立完备的知识体系

时间和知识的碎片化、工作996、职场pua都在阻止我们系统化地学习、更别说沉淀为知识体系啦。

为了能够对抗这些外部因素,我建议你写博客。强制输出倒逼输入、随时记录学习历程夯实脚步、不断实践形成技能树。

而作为一个程序员,形成个人知识体系,对抗危机和忧虑,可以使用下面的方法:

  • 建立自己的技能树
  • 技术分享
  • 技术博客
  • 建立自己的代码库
  • 开源项目贡献
tixi.png

下面我们来使用VuePress来搭建一个博客系统。我这里使用的是vuepress社区主题vuepress-theme-hope(一款集成了众多插件的vuepress主题)。

## vuepress是如何工作的?

事实上,一个 VuePress 网站是一个由 Vue、Vue Router和 webpack驱动的单页应用。如果你以前使用过 Vue 的话,当你在开发一个自定义主题的时候,你会感受到非常熟悉的开发体验,你甚至可以使用 Vue DevTools 去调试你的自定义主题。

在构建时,我们会为应用创建一个服务端渲染(SSR)的版本,然后通过虚拟访问每一条路径来渲染对应的HTML。这种做法的灵感来源于Nuxt的 nuxt generate 命令,以及其他的一些项目,比如 Gatsby。

vuepress 一些特性

  • 为技术文档而优化的内置Markdown拓展
  • 在Markdown文件中使用Vue组件的能力
  • Vue驱动的自定义主题系统
  • 自动生成Service Worker(支持PWA)
  • Google Analytics集成
  • 基于Git的"最后更新时间"
  • 多语言支持
  • 响应式布局
  • 天然的SEO能力,对比Docsify这种前端渲染HTML要好很多

1. 安装

npm init vuepress-theme-hope@next docs

2. 配置

根据提示进行配置,可以启动自带demo

3. 配置vuepress工作目录

主配置文件config.ts

import { defineHopeConfig } from "vuepress-theme-hope";
import themeConfig from "./themeConfig";

export default defineHopeConfig({
  port: 9927,
  title: "大阳说",
  description: "一个程序员的持续进化",
  dest: "./dist",
  head: [
    // 添加百度统计
    ["script", {},
      `var _hmt = _hmt || [];
      (function() {
        var hm = document.createElement("script");
        hm.src = "https://hm.baidu.com/hm.js?906138b9aada58204bf5d1a51d54abc9";
        var s = document.getElementsByTagName("script")[0]; 
        s.parentNode.insertBefore(hm, s);
      })();`
    ],["link",{
        rel: "stylesheet",
        href: "/fonticon.css",
      },
    ],
    
  ],

  locales: {
    "/": {
      lang: "zh-CN"
    },
  },

  themeConfig,
});

主题配置:

import { defineThemeConfig } from "vuepress-theme-hope";
import navbar from "./navbar";
import sidebar from "./sidebar";

export default defineThemeConfig({
  themeColor: false,
  fullscreen: false,
  darkmode: "switch",
  locales: {
    "/": {
      lang: "zh",
    },
  },
  hostname: "https://dayangshuo.cn",
  author: {
    name: "大阳",
    url: "https://dayangshuo.cn",
  },
  iconPrefix: "iconfont icon-",
  logo: "/dayang.jpg",
  repo: "https://github.com/dayang9927",
  docsDir: "demo/src",
  // navbar
  navbar: navbar,
  // sidebar
  sidebar: false,
  footer: "备案",
  displayFooter: true,
  pure: true,
  pageInfo: ["Author", "Original", "Date", "Category", "Tag", "ReadingTime"],
  blog: {
    description: "一个程序员的持续进化",
    intro: "/intro.html",
    medias: {
      Email: "dayang9927@163.com",
      GitHub: "https://github.com/dayang9927",
      Zhihu: "https://www.zhihu.com/people/da-yang-12-48",
    },
  },

  encrypt: {
    config: {
      "/guide/encrypt.html": ["dayangshuo.cn"],
    },
  },

  plugins: {

    search: {
      locales: {
        "/": {
          placeholder: "搜索",
        },
      },
    },

    blog: {
      autoExcerpt: true,
    },

    // 你也可以使用 Waline
    comment: {
      type: "giscus",
      repo: "vuepress-theme-hope/giscus-discussions",
      repoId: "R_kgDOG_Pt2A",
      category: "Announcements",
      categoryId: "DIC_kwDOG_Pt2M4COD69",
    },

    mdEnhance: {
      enableAll: true,
      presentation: {
        plugins: ["highlight", "math", "search", "notes", "zoom"],
      },
    },
    
  },
});

palette.scss

$themeColor: #3498DB;
$sidebarWidth: 20rem;
$sidebarMobileWidth: 16rem;
.navbar .nav-item > .nav-link::after {
    background-color: #3498DB;
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,992评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,212评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,535评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,197评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,310评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,383评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,409评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,191评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,621评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,910评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,084评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,763评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,403评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,083评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,318评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,946评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,967评论 2 351

推荐阅读更多精彩内容