一看就会的保姆级教程,10分钟搭建个人博客,Web前端基础三剑客学习知识分享

  • 第一处是加载动画的副内容

  • 第二处是网站描述节点,用于SEO的

(3)dest

该属性表示的是项目打包以后文件生成的目录

例如我们将该 dest 的值改成 ./dist ,那么当我们执行 npm run build 打包文件后,会在当前根目录下生成一个 dist 文件夹,打包好的项目文件都在该文件夹中

(4)head

该属性表示的是 html 文档的 head 标签中需要额外插入的其它标签

默认生成的是:

“head”: [ // 在head标签中生成以下标签

[

“link”, // 生成link标签

{

“rel”: “icon”, // rel属性值为icon

“href”: “/favicon.ico” // href属性值为 /favicon.ico

}

],

[

“meta”, //生成meta标签

{

“name”: “viewport”, // name属性值为viewport

“content”: “width=device-width,initial-scale=1,user-scalable=no” // content属性值为width=device-width,initial-scale=1,user-scalable=no

}

]

]

当然我们也可以继续添加别的标签,例如:

“head”: [ // 在head标签中生成以下标签

[“link”, { “rel”: “icon”, “href”: “/favicon.ico” }],

[“meta”, { “name”: “viewport”, “content”: “width=device-width,initial-scale=1,user-scalable=no” }],

[“meta”, { “name”: “keywords”, “content”: “前端,js,css” }],

[‘meta’, { name: ‘author’, content: ‘零一’ }],

]

(5)theme

该属性表示的是当前项目使用的主题

这里我们是用 vuepress-theme-reco 主题的脚手架生成的,所以它默认就是 reco ,我们可以不用修改,当然后续你想使用别的主题也可以,可以参考一下 vuepress 的官网

(6)themeConfig

该属性表示的是主题的配置信息

这里东西有点多,我们慢慢来讲

1. nav

该属性表示导航栏的配置信息

默认生成的 nav 值如下:

“nav”: [

{ // 第一个导航按钮

“text”: “Home”, // 按钮名称为 Home

“link”: “/”, // 对应的跳转链接为 /

“icon”: “reco-home” // 按钮的前置图标为 reco-home

},

{ // 第二个导航按钮

“text”: “TimeLine”, // 按钮名称为 TimeLine

“link”: “/timeline/”, // 对应的跳转链接为 /timeline/

“icon”: “reco-date” // 按钮的前置图标为 reco-date

},

{ // 第三个导航按钮

“text”: “Docs”, // 按钮名称为 Docs

“icon”: “reco-message”, // 按钮的前置图标为 reco-message

“items”: [ // 该按钮的子菜单

{ // 子菜单中的第一个导航按钮

“text”: “vuepress-reco”,

“link”: “/docs/theme-reco/”

}

]

},

{ // 第四个导航按钮

“text”: “Contact”, // 按钮名称为 Contact

“icon”: “reco-message”, // 按钮的前置图标为 reco-message

“items”: [ // 该按钮的子菜单

{ // 子菜单中的第一个导航按钮

“text”: “GitHub”,

“link”: “https://github.com/recoluan”,

“icon”: “reco-github”

}

]

}

]

详细的注释我都已经写在上面了

2. sidebar

该属性表示的是侧边栏的导航信息

默认生成的是:

“sidebar”: {

“/docs/theme-reco/”: [

“”, // 空字符串对应的是 README.md

“theme”, // 对应 theme.md

“plugin”, // 对应plugin.md

“api” // 对应api.md

]

},

该配置信息表示的是当路径为 /docs/theme-reco/ 时,侧边栏会自动找路径 ./docs/theme-reco/ 下的 README.mdtheme.mdplugin.mdapi.md 文件进行识别生成侧边栏,如图所示:

侧边栏的文字其实是识别了 md 文件中的 title ,例如 theme.md 文件对应的名称就是 title 的值


title: theme

date: 2020-05-27


This is theme.

这是一种写法,但其实还有另一种更为复杂一点的写法,我们来看一下

“sidebar”: {

“/docs/theme-reco/”: [

{

title: ‘一些文件’, // 标题信息

collapsable: true, // 是否可折叠

children: [ // 该块内容对应的所有链接

“”,

“theme”,

“plugin”,

“api”

]

}

]

}

这样的实现效果其实和刚才是差不多的,区别的话可以看下图来对比一下:

3. type

该属性表示的是当前项目的类型

默认的是 blog ,也就是我们现在看到的样式,其实还有别的值可以设定,例如 docs ,其对应的就是比较简约化的文档样式了,当然了这些都是脚手架帮我们处理好了的

4. blogConfig

该属性表示的是导航栏的配置信息,其是 reco 主题设置的

不知你有没有发现,刚刚设置 nav 导航栏信息的时候,一共有 4 个导航栏按钮,但实际呢?

实际情况却有 6 个,那么多出来的两个是哪里来的呢?其实就是 blogConfig 中设置的

“blogConfig”: {

“category”: {

“location”: 2, // 在导航栏中的位置在第二个

“text”: “Category”

},

“tag”: {

“location”: 3, // 在导航栏中的位置在第三个

“text”: “Tag”

}

},

这两个都是内置的设定好了的,所以只要按这样配置好就可以了,不过我感觉是不太需要,大家可以自己抉择

5. friendLink

该属性是用于设置友链的

具体在网站中的位置如下图所示:

配置的话也比较简单,模仿默认的配置去做就可以了:

“friendLink”: [

{

“title”: “午后南杂”,

“desc”: “Enjoy when you can, and endure when you must.”,

“email”: “1156743527@qq.com”,

“link”: “https://www.recoluan.com”

},

{

“title”: “vuepress-theme-reco”,

“desc”: “A simple and beautiful vuepress Blog & Doc theme.”,

“avatar”: “https://vuepress-theme-reco.recoluan.com/icon_vuepress_reco.png”,

“link”: “https://vuepress-theme-reco.recoluan.com”

}

],

6. logo

该属性表示的是导航栏最左侧的 logo 图片,如下图所示

在写该值时的根路径是 public ,即 /logo.png 表示的就是 public 下的 logo.png

7. search

该属性表示是否有搜索功能

8. searchMaxSuggestions

该属性官网也没做过多说明,所以我也不知道有什么用,暂且可以不用管

9. lastUpdated

该属性表示每篇文章底部显示的 “最后一次更新时间” 的文案

如下图所示:

10. author

该属性表示作者的名称,在每一篇文章的作者署名中都会沿用该名称

11. authorAvatar

该属性表示作者的头像,与 logo 一样的路径规则,头像显示位置如下图所示:

12. record && recordLink && cyberSecurityRecord && cyberSecurityLink

record: ICP备案号

recordLink: ICP 备案指向的链接

cyberSecurityRecord: 公安部备案文案

cyberSecurityLink: 公安部备案指向链接

如果项目不是部署在个人服务器上的话,这四个属性可以忽略不管

13. startYear

该属性表示博客的开始时间(只需要写年份就可以了),在网站上的展示如图所示:

左侧是我们填写的时间,右侧是根据当前时间自动生成的年份

(7) markdown

该属性里存储着一些对于 markdown 解析的配置

例如脚手架自动生成的 lineNumbers 表示的就是代码块显示行号

其实还有其它很多的 markdown 配置,详细参考 vuepress官方(opens new window)")

四、开始输入文章吧


按照上面进行配置,一个基本的博客就搭建好了,现在就可以开始疯狂输入文章了,所有的文章只需要以.md文件格式放在blogs文件夹下即可

我们创建一篇文章试试吧~


title: 我的第一篇文章

date: 2021-05-07

categories:

  • 分类1

tags:

  • 标签1

  • 标签2


这是我的第一篇文章

这里有四个属性可以配置,分别是titledatecategoriestags

这四个属性在页面上的体现如下图所示:

其中,date的时间也会在时间轴中呈现出来,即你所有的文章会按date的时间从上到下按时间新->旧的顺序进行排序

另外,我们本文使用的主题框架还为文章提供了一个很不错的功能:加密,只需要在文章中给keys属性赋值一个md5加密后的字符串即可

比如我们将密码设为zero2one,那么打开在线md5加密 (opens new window)")网站,将密码输入到框中,就能得到一串密文,该密文就是我们要设置的keys的值


title: 我的第一篇文章

date: 2021-05-07

categories:

  • 分类1

tags:

  • 标签1

  • 标签2

keys:

  • ‘ababf713be53f3d10366196bf0297c30’

这是我的第一篇文章

来看下效果:

五、添加评论模块


其实这个主题框架已经内置了评论插件@vuepress-reco/vuepress-plugin-comments,我们需要做的就是做一些额外的配置

首先去Valine官网 (opens new window)")注册一下Valine账号,注册好后进行登录,然后进入控制台,点击左下角创建应用

应用创建好以后,进入刚刚创建的应用,选择左下角的设置>应用Key,然后就能看到你的APP IDAPP Key了:

拿到APP IDAPP Key后,我们来到我们项目中.vuepress/config.js中的themeConfig属性中,按如下设置即可:

module.exports = {

// …

themeConfig: {

// …

valineConfig: { // valine 评论功能配置信息

appId: ‘在这输入你的appid’,// your appId

appKey: ‘在这输入你的appKey’, // your appKey

placeholder: ‘尽情留下你想说的话吧~’, // 评论框占位符

avatar: ‘wavatar’, // 评论用户的头像类型

highlight: true, // 代码高亮

recordIP: true, // 记录评论者的IP

},

}

// …

}

这样我们就能看到我们每篇文章的最底部都有留言功能了

当然如果我们不想让某篇文章有留言板,也可以设置isShowComments属性为false即可


title: 我的第一篇文章

date: 2021-05-07

categories:

  • 分类1

tags:

  • 标签1

  • 标签2

keys:

  • ‘ababf713be53f3d10366196bf0297c30’

isShowComments: false


这是我的第一篇文章

此时留言板就不存在了

六、总结


到此为止,基本上一个博客该有的功能就都具备了。其实本文介绍的这个主题脚手架他还提供了一个插件广场(支持实现各种各样的功能),目前这个插件广场中有:打赏插件回到顶部插件、音乐播放器插件、可爱光标插件、流程图插件等等

最后,大家也可以访问一下我搭建的个人博客 ,我正在我的个人博客里打造一套完整的宝典,欢迎关注~

自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。

深知大多数前端工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则几千的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!

因此收集整理了一份《2024年Web前端开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。

img

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上前端开发知识点,真正体系化!

由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!

如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:前端)

结尾

正式学习前端大概 3 年多了,很早就想整理这个书单了,因为常常会有朋友问,前端该如何学习,学习前端该看哪些书,我就讲讲我学习的道路中看的一些书,虽然整理的书不多,但是每一本都是那种看一本就秒不绝口的感觉。

以下大部分是我看过的,或者说身边的人推荐的书籍,每一本我都有些相关的推荐语,如果你有看到更好的书欢迎推荐呀。

戳这里免费领取前端学习资料

我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。**

深知大多数前端工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则几千的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!

因此收集整理了一份《2024年Web前端开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。

[外链图片转存中…(img-5ZTdZddL-1712258956118)]

[外链图片转存中…(img-1VdLLr16-1712258956118)]

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上前端开发知识点,真正体系化!

[外链图片转存中…(img-xFJ7hQ1G-1712258956118)]

由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!

如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:前端)

结尾

正式学习前端大概 3 年多了,很早就想整理这个书单了,因为常常会有朋友问,前端该如何学习,学习前端该看哪些书,我就讲讲我学习的道路中看的一些书,虽然整理的书不多,但是每一本都是那种看一本就秒不绝口的感觉。

以下大部分是我看过的,或者说身边的人推荐的书籍,每一本我都有些相关的推荐语,如果你有看到更好的书欢迎推荐呀。

戳这里免费领取前端学习资料

前端学习书籍导图-1

  • 11
    点赞
  • 14
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值