vuepress+gitee免费搭建个人在线博客(无保留版)

这篇具有很好参考价值的文章主要介绍了vuepress+gitee免费搭建个人在线博客(无保留版)。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

最终效果,一睹为快!

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

一、工具选型

vuepress+gitee

二、什么是VuePress

Vuepress是官方出品的一款极简静态网站生成器,它的初衷就是为了用于方便快速的撰写文档。

它主要包含了以下几个特点:

  • 非常简洁
  • 良好的SEO
  • 加载性能很高
  • 可自定义主题
  • 可以在markdown中写vue组件

官网地址:https://vuepress.vuejs.org/zh/

三、准备工作

环境搭建:

  • 电脑安装了git
  • 电脑具有Node环境
  • VScode编辑器(可选)
  • gitee账号

3.1 node 安装

Node官网地址:https://nodejs.cn/download/
选择自己电脑合适的版本安装即可,安装过程一直下一步。
比如Windows 64的电脑:
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

3.2 Git安装

Git官网地址:https://git-scm.com/
选择自己电脑合适的版本安装即可,安装过程一直下一步。
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

3.3 Gitee账号注册

Gitee官网地址:https://gitee.com/
我们会将博客网站部署到Gitee上面。
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

四、搭建步骤

4.1 初始化VuePress

电脑任意位置,创建空文件夹,用于存放我们的博客系统,你可以起任意名称。例如“blog”。
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

4.2 安装VuePress

  1. 在“blog”文件夹内,大概Git命令行,点击“git bash”。
    vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客
  2. 检查“node”是否安装成功,执行如下命令:
node -v

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

  1. 执行npm 初始化命令。
npm init -y

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客
该命令执行完毕,在“blog”文件夹内,会生成一个“package.json”文件。

  1. 安装VuePress,执行安装命令。
npm install -D vuepress

由于网络可能安装会比较慢,耐心等待即可,失败的话重新多安装几次,出现下面的界面则代表安装成功。
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客
当前目录如下图:
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

4.3 初始化目录

  1. 在“blog”目录下,新建“docs目录”,在“docs目录”下新建“README.md”文件,作为我们的博客首页。

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

  1. 然后修改README.md内容。
---
home: true
heroText: 一个分享互联网知识干货的老师傅
tagline: 抖音:划水老师傅
actionText: 查看知识 →
actionLink: /查看知识/查看知识
features:
- title: Gitee技术知识
  details: 所有知识,纯手工码字......
- title: 不建议报培训机构
  details: 因为2023年还在搞机构的,都是在割韭菜。
- title: 不建议入行
  details: 也许上一秒花费n个w学完,下一秒就失业了,再下一秒,你就又要转行了。
footer: 哪怕没钱赚 | 说些大实话 | 多点粉丝也是好的。
---
  1. 修改package.json文件,该文件用于项目的打包和运行,代码修改如下(新手第一次修改前,建议备份一份):
{
  "name": "moyu178666",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "docs:dev": "vuepress dev docs",
    "docs:build": "vuepress build docs"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "vuepress": "^1.9.9"
  }
}
  1. 执行命令,将博客运行起来看看效果,执行命令:
npm run docs:dev

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客
访问 http://localhost:8080/
页面效果:
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

该步骤执行失败的一些方案解决:
1. Error: error:0308010C:digital envelope routines::unsupported
解决:
卸载当前版本,下载安装低于17的node。下载地址:https://nodejs.org/dist/v16.19.0/

4.4 编写文章

页面上有一个按钮“查看知识”,此时点击该按钮,跳转的页面是“404”,因为我们还没有创建跳转页面。

打开“README.md”文件,“actionLink”,这个表示我们点击首页“查看知识”的按钮所要跳转的页面。

在“docs”目录下,新建“查看知识”文件夹,然后创建“查看知识.md”文件,然后随便写一些内容。
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客
再次执行:npm run docs:dev之后,刷新浏览器,点击首页“查看知识 →”,页面跳转如下:
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

页面未跳转问题:
检查下README.md 中“actionLink: /查看知识/查看知识”,和你的文件目录路径是否一致。

五、部署到Gitee

我们本地将博客调试好后,就可以进行部署,让所有人都可以正常访问。

(目前博客实现为Demo版,之后我们进行导航栏等细节美化以及目录结构优化)

5.1 创建仓库

Gitee上,我们需要新建一个仓库,用于存放我们的博客系统。
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

需要注意:

  • 仓库名称建议与个人空间地址(下图)保持一致,这样我们的博客地址显示会比较友好。以[空间地址.http://gitee.io]的形式访问。
  • 仓库属性“公共”。(私有不能开启GiteePage服务)

5.2 个人空间地址设置

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

4.3 推送本地博客项目到Gitee仓库

  1. 进入blog目录,打开打开gitbash命令行工具,打包博客,执行命令:
   npm run docs:build

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

  1. 参考gitee仓库给我们的步骤操作,将代码推送到仓库。

    博客目录,打开Git bash依次执行下列命令。

    git init
    git add .
    git commit -m "Init"
    git remote add origin https://gitee.com/xxxxxxx/myblog-demo.git 
    git push -u origin "master"
    

执行玩上面的命令后,我们的代码就推到了仓库中去。
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

5.4 部署

在仓库页面点击服务菜单,选择gitpage选项:
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

选择部署分支和部署目录,然后点击启动:

  • 部署分支,不用改,默认master

  • 部署目录,选择docs/.vuepress/dist文件夹,刚刚我们执行打包命令生成的。

  • 建议勾选“强制使用HTTPS”。
    vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

  • 点击“启动”,启动后,访问该连接。(老师傅已经关闭了自己的链接,所以已失效)

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

后续本地修改代码记得执行下面的命令,进入对应工作目录即可

npm run build
git add .
git commit -m "修改"
git push

六、进阶

6.1 优化项目目录结构

VuePress 遵循 “约定优于配置” 的原则,推荐的目录结构如下:

.
├── docs
│   ├── .vuepress (可选的)
│   │   ├── components (可选的)
│   │   ├── theme (可选的)
│   │   │   └── Layout.vue
│   │   ├── public (可选的)
│   │   ├── styles (可选的)
│   │   │   ├── index.styl
│   │   │   └── palette.styl
│   │   ├── templates (可选的, 谨慎配置)
│   │   │   ├── dev.html
│   │   │   └── ssr.html
│   │   ├── config.js (可选的)
│   │   └── enhanceApp.js (可选的)
│   │ 
│   ├── README.md
│   ├── guide
│   │   └── README.md
│   └── config.md
│ 
└── package.json
  • docs/.vuepress: 用于存放全局的配置、组件、静态资源等。
  • docs/.vuepress/components: 该目录中的 Vue 组件将会被自动注册为全局组件。
  • docs/.vuepress/theme: 用于存放本地主题。
  • docs/.vuepress/styles: 用于存放样式相关的文件。
  • docs/.vuepress/styles/index.styl: 将会被自动应用的全局样式文件,会生成在最终的 CSS 文件结尾,具有比默认样式更高的优先级。
  • docs/.vuepress/styles/palette.styl: 用于重写默认颜色常量,或者设置新的 stylus 颜色常量。
  • docs/.vuepress/public: 静态资源目录。
  • docs/.vuepress/templates: 存储 HTML 模板文件。
  • docs/.vuepress/templates/dev.html: 用于开发环境的 HTML 模板文件。
  • docs/.vuepress/templates/ssr.html: 构建时基于 Vue SSR 的 HTML 模板文件。
  • docs/.vuepress/config.js: 配置文件的入口文件,也可以是 YMLtoml
  • docs/.vuepress/enhanceApp.js: 客户端应用的增强。
当你想要去自定义 templates/ssr.html 或 templates/dev.html 时,最好基于 默认的模板文件 (opens new window)来修改,否则可能会导致构建出错。

对于上述的目录结构,默认页面路由地址如下:

文件的相对路径 页面路由地址
/README.md /
/guide/README.md /guide/
/config.md /config.html

所以,看完目录结构后,我们可以着手去做一个多页面的静态博客网站了。

6.2 配置文件

  1. 创建config.js配置文件:docs.vuepress\config.js
  2. 修改配置内容,比如我们这一次想修改页签名称和加上一个title。
  3. 本地执行 npm run dev (给小白解释下,此处我从doc:dev 变成了dev,是因为我修改了"package.json",后面不在赘述。)
  "scripts": {
    "dev": "vuepress dev docs",
    "build": "vuepress build docs"
  },
module.exports = {
    title: '划水老师傅的博客',
    description: '一起摸鱼吧!'
  }

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

七、终极之路

7.1 最终效果,一睹为快

利用官方做好的模板“VuePress Theme Hope”,我们可以不需要动手写很多配置以及动脑子,就可以生成特别好看的“文档网站”或者“个人博客”。

官网地址:https://theme-hope.vuejs.press/zh/

文档类型网站示例:
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

博客类型网站示例:
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

7.2 快速搭建

建立在已经熟悉之前的基本使用前提下,我们不再赘述重复内容,直接进入正题。

  1. 首先,我建议你安装“pnpm”。
安装命令:npm install -g pnpm
  1. 进入任意目录,执行命令如下,表示在该目录下,生成”moyu178666“的项目,当然你也可以是“blog”或者“docs”:
pnpm create vuepress-theme-hope moyu178666
  1. 根据提示,选择对应选项即可,最后一步注意,选择你需要创建的类型“blog”或者“docs”。
    vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

  2. 大功告成。

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

7.3 解决build失败

忘了截失败图…重新创建了项目,顺手将之前的“MyGitee”,改成了“my_gitee”。
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

使用package.json 更新包,就可以解决build失败问题,另外你可以用提供的其他命令进行我们之前提到的“run”等操作。
vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

7.4 解决上传本地代码到Gitee仓库后,没有“dist”目录

需要删除标记的代码”src/.vuepress/dist/“。

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

7.5 解决GiteePage部署失败问题

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

部署目录未设置正确,比如如图,我的设置就是一次错误的尝试。正确的应该是“moyu178666/src/.vuepress/dist”。

7.6 解决部署完成后,浏览器访问页面异常问题

如果你是按照我的步骤,从第一步到现在,不会产生这个问题。

如果产生这个问题,你需要修改“src\.vuepress\config.ts”文件。

产生这个问题的原因是,你多创建了一个目录,比如“blog\src\.vuepress\”,导致路径错误,需要修改为:

base: "/src/",

vuepress + gitee,gitee,vuepress,markdown,博客,博客搭建,网站搭建,个人博客

八、问题记录

利用vuepress-theme-hope生成的项目。

config.js 修改 base: “/src/”,

Gitee马云的路径得设置。

打包失败时,利用package.json文件调试模式,更新安装包。

九、git 常见错误

error: failed to push some refs to ‘https://gitee.com/xxxxx/xxxxx.git’

产生该问题的原因:可能是因为在手动修改了远程仓库中的文件,导致一些文件在本地仓库和远程仓库上不一致,故而引发该错误。

解决方法:使用命令 git pull --rebase origin master 将远程仓库同步到本地,然后再重新add、commit、push就行了。当然引发这种错误的原因可能不是这个,但大家可以尝试一下。我就是通过该方法解决此错误的。

建议: 不要在远程仓库手动修改文件,应该要在本地仓库中进行修改,然后提交到远程仓库,从而保证本地仓库和远程仓库的一致性文章来源地址https://www.toymoban.com/news/detail-771717.html

到了这里,关于vuepress+gitee免费搭建个人在线博客(无保留版)的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

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

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

相关文章

  • docsify & gitee 搭建个人博客

    npm是Node.js的包管理器,用于安装和管理JavaScript包。要安装npm,需要先安装Node.js。以下是在不同操作系统上安装npm的步骤: 1.1 在Windows上安装npm: 访问Node.js官方网站(https://nodejs.org)。 在下载页面上,选择适用于Windows的LTS版本(长期支持版本)的Node.js安装程序。 下载安装

    2024年02月12日
    浏览(34)
  • 使用 gitee+sphinx+readthedocs 搭建个人博客

        给大家安利如何快速搭建个人博客网站!     这是我本地运行的一个使用sphinx构建的博客服务,这些文章,都是用markdown写的。 一直有个想法,就是把自己写的这些文件,搞成一个博客网站,放到网上,但是,一想,要搞个域名、一个服务器,这样长期运营维护,成本有

    2024年01月19日
    浏览(32)
  • 10分钟搭建一个免费个人博客网站

    准备工作 有Gitee账号 有安装git 会 markdown 编写文档 Node.js 版本 = 8.6 博客采用VuePress搭建,Gitee部署,接下来,5步搞定。 1.创建项目 创建项目目录,并初始化项目,安装VuePress 2. 创建目录结构 3.完成基础配置 配置主题,定义自己的导航栏 配置首页 在 myblog/package.json 中添加一些

    2024年02月09日
    浏览(55)
  • Hexo+GithubPages免费搭建个人博客网站

    一、前言 二、Github配置 新建同名仓库 配置Pages 三、安装Hexo 四、配置hexo-deployer-git 五、访问 六、发布文章 七、安装主题 我之前开了好几年的云服务器了,实际上使用场景并不是很多,感觉有点浪费。前两个月都给关掉了,现在呢琢磨着弄一个免费的云服务搭建个人博客。

    2024年02月13日
    浏览(54)
  • 使用hugo+github搭建免费个人博客

    前提条件 win11电脑一台 电脑安装了git 电脑安装了hugo github账号一个 初始化一个博客 打开cmd窗口,使用hugo新建一个博客工程 下载主题 主题官网:themes.gohugo.io 在上面找一个主题,我这里找名称为 m10c 的主题:m10c | Hugo Themes (gohugo.io) 注意 :不同主题的安装方式不同,以后再专

    2024年01月18日
    浏览(55)
  • 使用Hugo+Github从0开始免费搭建个人博客

    以win11为例 1.注册git账号:https://github.com/并记住用户名和密码 2.下载地址:Git - Downloads (git-scm.com)鼠标右键显示Git Bash Here就表示安装Git成功了。 3.设置本地git用户 是否已经登录 生成密钥 将其中Your Name替换为用户名,邮箱替换为自己注册时的邮箱 如图所示,密钥已经给我们生

    2024年02月12日
    浏览(45)
  • 免费搭建个人博客:零成本实现网站发布,无需域名和服务器

    估计每个开发者想拥有属于自己的个性化博客网站,但却担心域名和服务器费用 还有那些头痛的服务器费配置,现在我们可以可以在几分钟内拥有的博客网站,并且无需支付任何域名和服务器费用 本文推荐的建站方案核心就是:hugo  Hugo,一个快速、简单且功能强大的静态网站生

    2024年04月26日
    浏览(46)
  • python爬虫_selenuim登录个人markdown博客站点

    大家好,我是yma16,本文分享python使用selenuim登录个人markdown博客站点。 该系列文章: python爬虫_基本数据类型 python爬虫_函数的使用 python爬虫_requests的使用 python爬虫_selenuim可视化质量分 python爬虫_django+vue3可视化csdn用户质量分 python爬虫_正则表达式获取天气预报并用echarts折线

    2024年02月16日
    浏览(43)
  • 基于Java+MySQL+Tomcat+Servlet+Maven+JQuery+jackson+开源Markdown编辑器实现前后端分离个人博客系统

    目录 项目简介 模块实现 设计实现数据库相关代码 博客列表页 博客详情页 注册页 登录页 检测登录状态 显示用户信息 退出登录 发布博客 删除博客 统计博客数量 效果展示 部分代码展示 小结:     项目中使用了Java ,MySQL ,Tomcat ,Servlet ,Maven ,JQuery ,jackson,开源MarkDo

    2024年02月02日
    浏览(46)
  • docker搭建在线Markdown服务器

    2024年02月13日
    浏览(44)

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

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

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

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

二维码1

领取红包

二维码2

领红包