零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站

这篇具有很好参考价值的文章主要介绍了零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

目录

介绍

VuePress2

pnpm

搭建

安装 Node.js

安装 pnpm

安装 VuePress

step 1:创建文件夹并进入该目录

​编辑

step 2:初始化项目

step 3:安装VuePress

step 4:在 package.json 中修改 scripts

step 5:创建目录和配置文件

step 6:将默认的临时目录和缓存目录添加到 .gitignore 文件中

step 7:启动服务器来开发你的文档网站

构建你的网站

基本布局

添加导航栏

侧边栏配置

部署

新建仓库

添加 base 路径配置

创建 GitHub Actions 配置文件

提交项目到 github 仓库


不管是找工还是个人提升,对于程序员来说打造自己的github和博客网站都是必不可少的。

然而苦于不知道如何搭建自己的博客网站,网上很多教程都需要租服务器,行动还没开始就要开始花钱,而且长期维护博客也是一笔不菲的开销。那么如何零成本地快速开始搭建我们的个人网站呢?

现在就手把手教你用 VuePress2 + GitHub Pages 来搭建个人网站,不需要租服务器,完全免费,而且非常简单,有手就行

拒绝拖延,现在就上手做起来!

介绍

VuePress2

VuePress是基于Vue的静态网站生成器,风格简约,配置简单。VuePress2是VuePress的第二个主要版本,带来了许多新特性和改进,包括性能优化、更灵活的配置选项及对Vue3的支持

pnpm

你可以使用任意的包管理工具来搭建自己的博客,教程中使用的pnpm是一个快速、轻量级、模块化、安全、节省空间、可靠的包管理器。它与npm与yarn类似,但具有一些优势。在绝大多数场景下会比npm/yarn快2-3倍,可以高效利用磁盘空间。它与npm兼容,并且可以在npm的基础上构建。

搭建

安装 Node.js

没有安装node.js的话去Node.js官方下载安装包安装: Node.js

推荐下载稳定的版本(左边的)

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

安装好之后同时按 win+R键,在对话框中输入cmd,打开Windows的命令行

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

输入node -v之后如果显示版本号,那就说明安装成功啦

node -v

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

安装 pnpm

在命令行中输入指令安装

npm install pnpm -g

安装好查看版本号,若出现版本号说明已经安装成功

pnpm -v

安装 VuePress

step 1:创建文件夹并进入该目录

找一个你喜欢的位置创建文件夹,比如这里在F盘下创建了一个“una-blog”文件夹

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

在命令行窗口里面进入该目录,如果创建的目录不在C盘下的话先切换盘符

# 切换盘符
F:

# 进入目录
cd una-blog

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

step 2:初始化项目
git init
pnpm init
step 3:安装VuePress
# 安装 vuepress 和 vue
pnpm add -D vuepress@next vue
# 安装打包工具和主题
pnpm add -D @vuepress/bundler-vite@next @vuepress/theme-default@next

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

step 4:在 package.json 中修改 scripts
{
  "scripts": {
    "docs:dev": "vuepress dev docs",
    "docs:build": "vuepress build docs"
  }
}

打开package.json文件

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

修改其中的scripts字段,修改前:

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

修改后:

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

step 5:创建目录和配置文件

创建目录:

mkdir docs
mkdir docs\.vuepress

创建 VuePress 配置文件 docs/.vuepress/config.js

import { viteBundler } from '@vuepress/bundler-vite'
import { defaultTheme } from '@vuepress/theme-default'
import { defineUserConfig } from 'vuepress'

export default defineUserConfig({
  bundler: viteBundler(),
  theme: defaultTheme(),
})

step 6:创建第一篇文档

echo '# Hello VuePress' > docs/README.md

以上命令在docs文件夹下添加README.md文件,并往文件中写入以下内容:

# Hello VuePress

docs/README.md 文件中的内容就是网站首页的内容。当然你也可以将 ‘# Hello VuePress’ 替换为任何你喜欢的文档内容。

step 6:将默认的临时目录和缓存目录添加到 .gitignore 文件中

创建完成后,你项目的目录结构应该是这样的:

├─ docs
│  ├─ .vuepress
│  │  └─ config.js
│  └─ README.md
└─ package.json

docs 目录是你放置 Markdown 文件的地方,它同时也会作为 VuePress 的源文件目录。

docs/.vuepress 目录,即源文件目录下的 .vuepress 目录,是放置所有和 VuePress 相关的文件的地方。当前这里只有一个配置文件。默认还会在该目录下生成临时文件、缓存文件和构建输出文件。建议你把它们添加到 .gitignore 文件中。

echo docs/.vuepress/.temp >> .gitignore
echo docs/.vuepress/.cache >> .gitignore
echo docs/.vuepress/dist >> .gitignore

以上命令会自动在文件夹下添加.gitignore文件,并往文件中写入以下内容:

docs/.vuepress/.temp
docs/.vuepress/.cache
docs/.vuepress/dist

这样,项目上传到github的时候就会忽略文件夹中这些文件。

step 7:启动服务器来开发你的文档网站
pnpm docs:dev

VuePress 会在http://localhost:8080 启动一个热重载的开发服务器。当你修改你的 Markdown 文件时,浏览器中的内容也会自动更新。

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

构建你的网站

运行 docs:build 脚本可以构建你的网站:

pnpm docs:build

在 docs/.vuepress/dist 目录中可以找到构建生成的静态文件。

基本布局

现在页面还比较简陋,我们可以进一步细化让页面初具雏形

添加导航栏

修改config.js,在首页的右上角添加导航栏

import { viteBundler } from '@vuepress/bundler-vite'
import { defaultTheme } from '@vuepress/theme-default'
import { defineUserConfig } from 'vuepress'

export default defineUserConfig({
    bundler: viteBundler(),
    theme: defaultTheme({
        // 在这里进行配置
        navbar: [
            // NavbarItem
            { text: '首页', link: '/', },
            // NavbarGroup
            {
                text: 'una的博客',
                children: [
                    { text: 'Github', link: '/' },
                    { text: '知乎', link: '/' },
                    { text: '掘金', link: '/' },
                ],
            },
        ],
    }),

    lang: 'zh-CN',
    title: 'una的博客',
    description: '这是我的第一个 VuePress 站点',
})

效果图:

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

侧边栏配置

现在我们来添加一些关于算法的md文档,目前的文档目录为:

├─ docs
│  ├─ .vuepress
│  │  └─ config.js
│  ├─ README.md
│  └─ Algorithm
│     └─ Divide&Conquer.md
└─ package.json

修改config.js,添加sidebar

theme: defaultTheme({
        // 在这里进行配置
        navbar: [
            // NavbarItem
            { text: '首页', link: '/', },
            // NavbarGroup
            {
                text: 'una的博客',
                children: [
                    { text: 'Github', link: '/' },
                    { text: '知乎', link: '/' },
                    { text: '掘金', link: '/' },
                ],
            },
        ],
        sidebar: [
            {
                text: '前言',
                collapsible: false,
                children: [
                    { text: '内容介绍' },
                    { text: '使用指南' }
                ]
            },
            {
                text: '算法学习',
                link: '/Algorithm/Divide&Conquer',
                collapsible: false,
                children: [
                    { text: '分治法', link: '/Algorithm/Divide&Conquer' }
                ],
            }
        ]
    }),

效果图:

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

装饰个人网站的方式多种多样,这里就不再赘述啦~自行发挥~

部署

此时一个简单的个人网站就已经搭好了,为了让别人也能访问到我们的网站,我们接下来将其部署到免费的Github Pages上(Github)。

新建仓库

我们在 Github 上新建一个仓库,这里我创建的仓库叫:「clrlov.github.io」(clrlov是我的用户名)。

* 注意:如果你的博客地址不想要有二级目录,仓库名就叫 「<你的用户名>.github.io」。如果你的仓库名为blog,那最后的博客地址就会是https://用户名.github.io/blog,比如https://clrlov.github.io/blog

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

添加 base 路径配置

对应我们的仓库,我们需要在 config.js 添加 base 路径配置:

export default defineUserConfig({
    // 路径名为 “/<REPO>/”
    base: '/clrlov.github.io/',
    // ...
})

创建 GitHub Actions 配置文件

在你的项目根目录下,创建 .github/workflows 文件夹,然后创建 .github/workflows/docs.yml 文件来配置工作流。

在项目仓库打开Settings->Actions->General:

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

修改workflow permissions为 "Read and qrite permissions"

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

提交项目到 github 仓库

在命令行依次执行以下代码,或者你也可以采用任何github仓库中code页签下给出的提交方式

* 注意 git remote add origin 后面的地址要改成你自己的仓库地址:

  # git init 如果前面执行过,就不用再执行了
  git init 

  git add .

  git commit -m "first commit"

  git branch -M main

  # 记得改成你自己的仓库地址
  git remote add origin git@github.com:clrlov/clrlov.github.io.git

  git push -u origin main

切换到Actions页签,可以看到已经成功

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript最后一步!

在Setting标签页中,侧边栏中选择Pages,Source 选择 "Deploy from a branch",然后在 Branch 标签下选择 gh-pages 分支和 /(root) 目录,点"Save"保存

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

然后我们可以在上方看到我们的博客地址零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

点击"Visit site"或者点击网址,就可以进入我们的博客了!大功告成

零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站,github,vue,javascript

参考资料:

首页 | VuePress

从零开始:VuePress2 + GitHub Pages 搭建你的第一个免费博客网站 - 知乎

mqyqingfeng (冴羽) · GitHub文章来源地址https://www.toymoban.com/news/detail-839119.html

到了这里,关于零基础!手把手教你使用VuePress2 + GitHub Pages免费搭建个人博客网站的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • Java基础--手把手教你如何从键盘录入信息

    从键盘录入信息 Scanner 有扫描仪的意思,sc是自己取的名字(有的人喜欢用input), new Scanner 是创建一个Scanner对象, System.in 代表电脑的键盘。 即,扫描电脑的键盘。 将第一步写完,我们在编译器里面看到, Scanner 标红了,报错了! ❓ 为啥报错呢? 我们要使用 Scanner ,需要

    2024年02月11日
    浏览(50)
  • 【Java技术专题】「Guava开发指南」手把手教你如何进行使用Guava工具箱进行开发系统实战指南(基础编程篇)

    Preconditions(前置条件):让方法调用的前置条件判断更简单 。 Guava在Preconditions 类中提供了若干前置条件判断的实用方法,我们强烈建议在 Eclipse 中静态导入这些方法。每个方法都有三个变种: 当方法没有额外参数时,抛出的异常中不包含错误消息,这会使得调用方很难确

    2024年02月07日
    浏览(77)
  • 正则表达式详解(零基础教学,手把手教你写正则)

    本篇文章将从零讲解什么是正则表达式,以及正则表达式的规则、在python中的应用,用通俗易懂的描述方式进行零基础级别的讲解,尽量做到全网最全讲解,力求最高质量文章,欢迎关注!点击目录可直接进行相关位置跳转。 目录: 什么是正则? 为什么需要正则? 元字符

    2023年04月08日
    浏览(43)
  • 手把手教你做计算机网络基础大题—地址分配

    某单位分配到一个起始地址为14.24.74.0/24的地址块。该单位需要用到三个子网,它们的三个子网地址块的具体要求是:子网N1需要120个地址,子网N2需要60个地址,子网N3需要10个地址。请给出地址的分配方案。 起始地址为 14.24.74.0/24 的地址块,它代表前三个字节为网络前缀(网

    2024年02月09日
    浏览(65)
  • 手把手教你如何使用Docker

    我们在公司开发中,会有开发环境,测试环境,上线环境, 比如我们开发人员开发好了一个项目,在开发环境中运行正常,但测试人员拉到测试环境就跑不起来【jdk版本等】,或者上线的时候运行不起来,这时候就要为每个机器配置一个环境,那运维人员不得累死?【哈哈,

    2024年02月10日
    浏览(71)
  • 手把手教你如何使用SimiliarWeb

    在之前的“手把手教你如何使用Google Trends”文章中我们讲到从事跨境电商的卖家第一步遇到的问题是“客户在哪里?”该如何推广我的产品?因此若想自己的店铺做大做好,则需要工具来帮助分析市场行情,根据市场行情调整自己的业务状况。小编在上篇中已经讲解了三个特

    2024年02月09日
    浏览(66)
  • 02.【python基础一】手把手教你什么是注释、变量及输入函数

    📋 个人简介 💖 作者简介:大家好,我是小鹏linux,运维领域新星创作者,阿里云ACE认证高级工程师😜 📝 个人主页:小鹏linux🔥 🎉 支持我:点赞👍+收藏⭐️+留言📝 💬格言:你未必出类拔萃,但一定与众不同!🔥 📕 系列专栏:                🍎 阶段一:windows基

    2023年04月08日
    浏览(49)
  • 【码农教程】手把手教你Mockito的使用

    1)Mockito:简单轻量级的做mocking测试的框架; 2)mock对象:在调试期间用来作为真实对象的替代品; 3)mock测试:在测试过程中,对那些不容易构建的对象用一个虚拟对象来代替测试的方法就叫mock测试; 4)stub:打桩,就是为mock对象的方法指定返回值(可抛出异常); 5)

    2024年02月05日
    浏览(59)
  • 手把手教你使用gtest写单元测试

    开源框架:gtest,它主要用于写单元测试,检查真自己的程序是否符合预期行为。这不是QA(测试工程师)才学的,也是每个优秀后端开发codoer的必备技能。 本期博文内容及使用的demo,参考: Googletest Basic Guide[1] Googletest Samples [2] 构建依赖环境 按照惯例,先介绍下怎么基于

    2024年02月16日
    浏览(49)
  • 手把手教你 iconfont 导入使用及相关配置

    iconfont是阿里旗下的一套图标库,UI设计师设计号图标后,会将图标上传到iconfont的项目库中。前端开发人员需要下载项目图标,并在项目中使用。 iconfont相对于传统的直接导入图标进入页面,有以下几点优势: 体积更小,页面加载速度更快 解决图片像素点会随页面变化而模

    2024年02月07日
    浏览(62)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包