v0.1方向指南(已归档)


本版本效果

  • 可用,做到基本快速查阅(内容不完整,但是整体架子有)

技术实现预测


// 图示
①流程指南:本地书写 ---> GitLab ------------> GitHub(主干分支改变)
                        |                    |
                        --- 触发发布到GitHub   |
                                             -------> VuePress打包(中间层Node处理目录结构,将根据规则生成的更新到 .vuepress文件夹下) ---> 更新 notes.itzkp.com

// 图示解释
1. 本地书写
2. 发布到GitLab
3. GitLab主分支改变,触发 push到 GitHub主分支
4. GitHub主分支改变 触发执行,Node中间程序,处理GitHub主分支目录结构,根据自己定义规则生成,.vuepress 下的 config.js
5. 打包
6. 更新到 notes.itzkp.com


工具支撑:Jenkins

环境:Centos7

域名指南:notes.itzkp.com(采用VuePress静态打包)


规则限定

结构上:

内容上:


遇到的问题

1. 部署(已解决 2019.6.7 9:20)
  • 这个问题就是Node启动了代理静态文件,但是对于中文目录的会变为这种形式,于是Node就识别不到正确的文件了
  • 预计解决方案:优化Node代理静态服务

✅解决:方案是使用Express进行代理


2. VuePress设置问题
  • 左侧树不能设置三层结构 ✅

  • 不会设置多个侧边栏结构 ✅

  • 结果:似乎不能设置文件夹名称为一级,而是可以设置单个文件为 # 一级,然后 ## 为二级这样

  • 误区是,似乎 VuePress 只会代理每一层最外面的,而不会代理 文件夹下文件夹下的文件


VuePress配置

module.exports = {
  // base: '/documents/',
  title: 'Notes',
  description: '知识速查(了不起的个人工具库)',
  head: [
    ['link', { rel: 'icon', href: `/favicon.ico` }]
  ],
  themeConfig: {
    repo: 'https://github.com/zhukunpenglinyutong/notes',
    //导航
    nav: [
      { text: '速查', link: '/1.quickcheck/' },
      { text: '笔记', link: '/2.note/' },
      // { text: '常用网站', link: '/webtool/' }
    ],
    // 侧边栏
    sidebar: {
      '/1.quickcheck': [
        {
          title: '1.前端',
          children: [
            '/1.quickcheck/1.前端/1.HTML速查.md',
            '/1.quickcheck/1.前端/2.CSS速查.md',
            '/1.quickcheck/1.前端/3.JS方法速查.md'
          ]
        },
        {
          title: '2.后端',
          children: [
            '/1.quickcheck/2.后端/1.Node速查.md',
            '/1.quickcheck/2.后端/2.MySQL速查.md',
            '/1.quickcheck/2.后端/3.Express速查.md',
            '/1.quickcheck/2.后端/4.MongoDB速查.md'
          ]
        },
        {
          title: '3.运维',
          children: [
            '/1.quickcheck/3.运维/1.Centos下安装各种软件.md',
            '/1.quickcheck/3.运维/2.Nginx速查.md',
            '/1.quickcheck/3.运维/3.pm2常用命令.md',
            '/1.quickcheck/3.运维/4.Docker速查.md'
          ]
        },
        {
          title: '4.其他',
          children: [
            '/1.quickcheck/4.其他/1.正则表达式速查.md',
            '/1.quickcheck/4.其他/2.GitHub平台.md',
            '/1.quickcheck/4.其他/3.http协议速查.md',
            '/1.quickcheck/4.其他/4.微信小程序知识速查.md',
            '/1.quickcheck/4.其他/5.前端安全速查.md',
            '/1.quickcheck/4.其他/6.Electron速查.md',
            '/1.quickcheck/4.其他/7.VuePress速查.md',
          ]
        },
      ],
      '/2.note': [
        {
          title: '0.项目方向指南',
          children: [
            '/2.note/0.项目方向指南/v0.1方向指南',
            '/2.note/0.项目方向指南/v0.2方向指南'
          ]
        },
        {
          title: '1.每日规划',
          children: [
            '/2.note/1.每日规划/2019.6.4.md',
            '/2.note/1.每日规划/2019.6.5',
            '/2.note/1.每日规划/2019.6.7',
            '/2.note/1.每日规划/2019.6.8',
          ]
        },
        {
          title: '2.每日收获',
          children: [
            '/2.note/2.每日收获/2019.6.3',
            '/2.note/2.每日收获/2019.6.4',
            '/2.note/2.每日收获/2019.6.5'
          ]
        },
        {
          title: '3.面试总结',
          children: [
            '/2.note/3.面试总结/1.公司'
          ]
        },
        {
          title: '4.Typescript',
          children: [
            '/2.note/4.Typescript/1.概述'
          ]
        }
      ]
    }
  },
  serviceWorker: true,
}