使用vuepress-6小时搭建一个完全免费的个人网站

分享一个通过vuepress搭建个人博客

当然也可以自己写不用vuepress,自己写代码然后通过githubPages也是可以的,只是使用vuepress相对来说时间快一点,他生成的网站也是响应式的。

这是我的个人博客:https://1crazy.github.io/,其实非常简单:我只用了1天时间就完成了,下面给大家讲一下如何开始。

一、个人网站的作用:

个人相册,笔记,个人小说,员工手册,公司制度文档,等等

UmiJSDvaJS的文档也是使用的vuepress,可以参考一下他的网站
我们可以随意的更换侧边栏的信息,比如公司概况企业文化家庭相册自己的文章等等,当然我们自己写更换布局。

二、什么是vuepress

简单介绍一下,vuepress是尤雨溪18年4月12日发布的vue静态网站生成器,支持vue语法,内置webpack,每一个由VuePress生成的页面都是通过SSR预渲染的HTML,也因此具有非常好的加载性能和搜索引擎优化。

三、相关文档

下面列出来的非常简单,后面我也会给大家讲解一下用到的操作,当然大家也可以查看官方文档,为了方便查看,我列出它们的中文文档

git

node.js

vuepress

github pages

npm

markdown

webpack

vue

四、开始个人网站

1. 首先我们全局安装vuepress

npm i vuepress -g
安装vuepress

2. 将vuepress克隆至本地仓库

git clone git@github.com:docschina/vuepress.git
克隆至本地

3. 克隆以后的目录

完成好了以后,我们可以看到文件夹中多了一个vuepress文件夹

docs文件夹

在这个文件夹目录下,我们还是需要安装一下依赖生成node_modules文件夹,使用

npm i
生成nodemodules文件夹

简单介绍一下,在上面docs文件夹下就是我们需要自己写的东西,当然个人博客我们使用markdown语法书写就好了,首先我们先看一下效果,我们进入docs文件夹
vuepress dev生成本地访问链接【注意备用IE,建议使用最新版谷歌浏览器】

生成本地服务器

本地访问网址

本地访问图片

这个是vuepress的默认主题,我们后面就需要在 config.js里面进行配置更改就好了,当然如果需要自己写组件的话,就在components文件夹下面书写就好了

4. 关于默认主题中config.js文件中themeConfig的配置

其实配置很简单,可以参考一下vuepress官方文档,写的非常详细

默认主题配置

下面是我的一些themeConfig:配置信息以及我的docs目录结构,.md文件就是我们写博客的地方了,其中里面的vuepress文件夹不用管它,没有是正常的,他是通过vuepress build生成的静态文件,后续我们将其文件夹内的东西push至github上面就好了

我的目录结构
  themeConfig: {
    repoLabel: 'github',
    // editLinks: true,
    docsDir: 'docs',
    //获取最后一次提交博客时间
    lastUpdated: true, // 最后更新时间
    displayAllHeaders: true, // 默认值:false
    // selectText: '选择语言',
    // editLinkText: '编辑此页',
    lastUpdated: '上次更新',
    locales: {
      '/': {
        label: '简体中文',
        selectText: '选择语言',
        lastUpdated: '上次更新',
        nav: [
          {
            text: '博文',
            // link: '/index/HTMLCSS/'
            items: [
              { text: 'html&css', link: '/index/html-css/css.md' },
              { text: 'javascript', link: '/index/javascript/javascript.md' },
              { text: 'nodejs', link: '/index/nodejs/nodejs.md' },
              { text: '其它', link: '/index/others/rap2.md' }
            ]
          },
          {
            text: '项目总结',
            link: '/project/project.md'
          },
          {
            text: '小练习',
            link: '/practice/practice.md'
          },
          {
            text: '简书',
            link: 'https://www.jianshu.com/u/422ccfa02512'
          },
          {
            text: 'github',
            link: 'https://github.com/1Crazy/1Crazy.github.io'
          }
        ],
      },
    },
    sidebar: {
      '/index/': [
        // 侧边栏在 /index/ 目录上
        '/index/',
        {
          title: 'html&css',
          collapsable: true, // 不可折叠
          children: ['/index/html-css/css.md']
        },
        // 侧边栏在 /javascript/ 目录上
        {
          title: 'javascript',
          collapsable: true, // 不可折叠
          children: [
            '/index/javascript/javascript.md'
          ]
        },
        // 侧边栏在 /node.js/ 目录上
        {
          title: 'nodejs',
          collapsable: true, // 不可折叠
          children: [
            '/index/nodejs/nodejs.md',
            '/index/nodejs/spider.md',
          ]
        },
        // 侧边栏在 /others/ 目录上
        {
          title: '其它',
          collapsable: true, // 不可折叠
          children: [
            '/index/others/rap2.md',
            '/index/others/cmder.md',
          ]
        },
      ],
      // 侧边栏在 /practice/ 目录上
      '/practice/': [
        ['/practice/practice.md','练习'],
        ['/practice/practice1.md','练习1']
      ],
      // 侧边栏在 /project/ 目录上
      '/project/': [
        ['/project/project.md','工作总结'],
        ['/project/project1.md','工作总结1']
      ]
    },
  }
}

五、github上创建仓库

仓库名字一定要写成你的: github名.github.io这种形式。然后将build好的静态vuepress文件里面的文件push上去就好了,之后就可以通过域名访问你的网址了,注意刚push上去,因为githubPages可能需要一定的时间,大概5分钟左右就可以看到你生成的网站了,赶快试试吧。

https://1crazy.github.io/ 像这样,自己的【github名.github.io】就可以了

创建仓库

六、需要注意地方

目前vuepress官方是1.x 的文档,由于目前 1.x 仍处于 alpha 阶段,在到达 beta 阶段之前,有些 API 可能会变化、应用也可能不够稳定,所以看文档时可以看下面这个

https://v0.vuepress.vuejs.org/zh/

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

推荐阅读更多精彩内容