手把手带你用 VuePress + Github Pages 搭建博客,踩坑了

69 阅读6分钟

最后

给大家分享一些关于HTML的面试题。

开源分享:docs.qq.com/doc/DSmRnRG… 此时界面类似于:

ea88c96f6ca28dc0c54ff58dd69d2a88.png

3. 添加导航栏


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

module.exports = {

title: '...',

description: '...',

themeConfig: {

nav: [

{ text: '首页', link: '/' },

text: '冴羽的 JavaScript 博客', 

items: [

{ text: 'Github', link: 'github.com/mqyqingfeng' },

{ text: '掘金', link: 'juejin.cn/user/712139…' }

]

}

]

}

}

效果如下:

e45570d5923f7ee58c55f5afd06b6606.png

更多的配置参考 VuePress 导航栏。

4. 添加侧边栏


现在我们添加一些 md 文档,目前文档的目录如下:

.

├─ docs

│  ├─ README.md

│  └─ .vuepress

│     └─ config.js

|  └─ handbook

|     └─ ConditionalTypes.md

|     └─ Generics.md

└─ package.json

我们在 config.js 配置如下:

module.exports = {

themeConfig: {

nav: [...],

sidebar: [

{

title: '欢迎学习',

path: '/',

collapsable: false, // 不折叠

children: [

{ title: "学前必读", path: "/" }

]

},

{

title: "基础学习",

path: '/handbook/ConditionalTypes',

collapsable: false, // 不折叠

children: [

{ title: "条件类型", path: "/handbook/ConditionalTypes" },

{ title: "泛型", path: "/handbook/Generics" }

],

}

]

}

}

对应的效果如下:

3bc012ee64b6daeed76ec86cf57071fa.png

5. 更换主题


现在基本的目录和导航功能已经实现,但如果我还想要加载 loading、切换动画、模式切换(暗黑模式)、返回顶部、评论等功能呢,为了简化开发成本,我们可以直接使用主题,这里使用的主题是 vuepress-theme-rec:

现在我们安装 vuepress-theme-reco:

npm install vuepress-theme-reco --save-dev

# or

yarn add vuepress-theme-reco

然后在 config.js 里引用该主题:

module.exports = {

// ...

theme: 'reco'

// ...

}

刷新一下页面,我们会发现一些细节的改变,比如加载时的 loading 动画、以及支持切换暗黑模式:

df0175dbbd8608931cbcb6ed56f58171.png

6. 添加文章信息


但我们也会发现,像条件类型这一篇文章,条件类型(Conditional Types) 竟然出现了两遍,这是因为这个主题自动提取了第一个大标题作为本文的标题,我们可以在每篇文章的 md 文件中添加一些信息修改:


title: 条件类型

author: 冴羽

date: '2021-12-12'


此时文章的效果如下:

0b490841462fa87e807a31389de1c452.png

但如果你不想要标题、作者、时间这些信息呢,我们可以在样式里隐藏,这个稍后会讲到。

7. 设置语言


注意,上图的文章时间,我们写入的格式为 2021-12-12 ,但是显示的是 12/12/2021,这是因为  VuePress 默认的 lang 为 en-US,我们修改一下 config.js:

module.exports = {

// ...

locales: {

'/': {

lang: 'zh-CN'

}

},

// ...

}

可以发现时间换了一种展示方式:

96e10b04c01279213bf200c1c1334ca0.png

8. 开启目录结构


在原本的主题里,我们发现每篇文章的目录结构出现在左侧:

b7c5f4b88d6b5753c62ccc4aa122259e.png

而 vuepress-theme-reco 将原有的侧边栏的中的多级标题移出,生成子侧边栏,放在了页面的右侧,如果你要全局开启,可在页面 config.js 里设置开启:

module.exports = {

//...

themeConfig: {

subSidebar: 'auto'

}

//...

}

此时效果如下:

fb70e6bb90a0edc7759217d9a8fc2e17.png

9. 修改主题颜色


VuePress 基于 Vue,所以主题色用的是 Vue 的绿色,然而 TypeScript 的官方色则是蓝色,那如何修改 VuePress 的主题色呢?

你可以创建一个 .vuepress/styles/palette.styl 文件,文件代码如下:

$accentColor = #3178c6

此时可以发现主题颜色变了:

17cf2973a00a41c0152d6b5018c7281b.png

更多的颜色修改参考 VuePress 的 palette.styl。

10. 自定义修改样式


如果你想自定义修改一些 DOM 元素的样式呢?就比如在暗黑模式下:

093d3d7a860a013e0924ffc80e7d5b64.png

我们发现用作强调的文字颜色比较暗淡,在暗黑模式下看不清楚,我想改下这个文字的颜色和背景色呢?

而 VuePress 提供了一种添加额外样式的简便方法。你可以创建一个 .vuepress/styles/index.styl 文件。这是一个 Stylus 文件,但你也可以使用正常的 CSS 语法。

我们在 .vupress 文件夹下创建这个目录,然后创建 index.styl 文件,代码如下:

// 通过检查,查看元素样式声明

.dark .content__default code {

background-color: rgba(58,58,92,0.7);

color: #fff;

}

此时文字就清晰了很多:

f62a4176e703e88936354fb52685fd66.png

那之前我们提到的隐藏每篇文章的标题、作者、时间呢,其实也是类似的方式:

.page .page-title {

display: none;

}

最后的效果如下:

2df71ac0e8cb9ecf36db36a4256db003.png

11. 部署


我们的博客就算是正式的做好了,接下来我们部署到免费的 Github Pages 上。我们在 Github 上新建一个仓库,这里我取得仓库名为:learn-typescript

574f54a38b8c6786e37d4dfb83be003a.png

对应,我们需要在 config.js 添加一个 base 路径配置:

module.exports = {

// 路径名为 "//"

base: '/learn-typescript/',

//...

}

最终的 config.js 文件内容为:

module.exports = {

title: 'TypeScript4 文档',

description: 'TypeScript4 最新官方文档翻译',

base: '/learn-typescript/',

theme: 'reco',

locales: {

'/': {

lang: 'zh-CN'

}

},

themeConfig: {

// lastUpdated: '上次更新',

subSidebar: 'auto',

nav: [

{ text: '首页', link: '/' },

text: '冴羽的 JavaScript 博客', 

items: [

{ text: 'Github', link: 'github.com/mqyqingfeng' },

{ text: '掘金', link: 'juejin.cn/user/712139…' }

]

}

],

sidebar: [

{

title: '欢迎学习',

path: '/',

collapsable: false,

children: [

{ title: "学前必读", path: "/" }

]

},

{

title: "基础学习",

path: '/handbook/ConditionalTypes',

collapsable: false,

children: [

{ title: "条件类型", path: "/handbook/ConditionalTypes" },

{ title: "泛型", path: "/handbook/Generics" }

],

}

]

}

}

然后我们在项目 vuepress-starter 目录下建立一个脚本文件:deploy.sh,注意修改一下对应的用户名和仓库名:

#!/usr/bin/env sh

# 确保脚本抛出遇到的错误

set -e

# 生成静态文件

npm run docs:build

# 进入生成的文件夹

cd docs/.vuepress/dist

git init

git add -A

git commit -m 'deploy'

# 如果发布到 https://.github.io/

最后

在面试前我花了三个月时间刷了很多大厂面试题,最近做了一个整理并分类,主要内容包括html,css,JavaScript,ES6,计算机网络,浏览器,工程化,模块化,Node.js,框架,数据结构,性能优化,项目等等。

包含了腾讯、字节跳动、小米、阿里、滴滴、美团、58、拼多多、360、新浪、搜狐等一线互联网公司面试被问到的题目,涵盖了初中级前端技术点。

  • HTML5新特性,语义化

  • 浏览器的标准模式和怪异模式

  • xhtml和html的区别

  • 使用data-的好处

  • meta标签

  • canvas

  • HTML废弃的标签

  • IE6 bug,和一些定位写法

  • css js放置位置和原因

  • 什么是渐进式渲染

  • html模板语言

  • meta viewport原理