10 分钟带你免费搭建一个属于自己的博客
苏生不惑第
328
篇原创文章,将本公众号设为星标
,第一时间看最新文章。
之前的文章又发现几个有意思的网站 留言区有人问能不能整理个我推荐过网站的入口,于是我搭建了个博客将之前分享的上百个网站整理起来。
安装 nodejs
之前文章京东每天自动签到领京豆 已经用过nodejs了 ,从https://nodejs.org/zh-cn/ 下载直接安装,安装后打开命令行能看到版本号就说明安装成功了。
λ node
Welcome to Node.js v14.17.1.
Type ".help" for more information.
安装 docsify
docsify可以快速帮你生成文档网站,在命令行输入npm i docsify-cli -g
安装 docsify ,然后docsify init ./docs
初始化项目,官网文档也写得很清楚了 https://docsify.js.org/#/zh-cn/ ,目录结构如下:
λ ls docs
_coverpage.md _navbar.md _sidebar.md about.md blog/ index.html README.md wechat/
index.html 为入口文件,README.md 为首页文件,.nojekyll 用于阻止 GitHub Pages 忽略掉下划线开头的文件。
接着输入docsify serve docs
启动一个本地服务器,可以实时预览效果,默认访问地址 http://localhost:3000/ ,使用markdown语法修改README.md文件即可看到效果:
关于markdown的使用可以在这个网站练习 https://md2pdf.netlify.app/ ,10分钟就能学会,本地用Typora编辑器。
我们需要新建文件_sidebar.md,用于展示侧边栏,index.html配置里加上loadSidebar: true,就行了,一个本地博客就这样搭建完了,是不很简单。
上传到GitHub
在本地修改测试没问题后将博客发布到GitHub上,这样就可以让其他人访问你的博客了,注册GitHub账号就不说了,新建一个仓库把本地文件上传到repo,然后打开setting的GitHub Pages ,在Source选择main branch / docs ,保存过几分钟就能生效,博客就能访问了。
自定义一个博客名字,选择构建的根目录ROOT DIRECTORY
为 docs。
问题
这里整理几个搭建博客可能遇到的问题。
图片处理 如果使用本地图片,Typora编辑器可以配合PicGo或者upgit上传图片到GitHub,如果使用第三方图床的图片提示403不显示 ,修改index.html加入代码 <meta name="referrer" content="no-referrer" />
。
2.GitHub 打不开
国外网站GitHub有时候访问慢甚至打不开,可以使用这个软件https://gitee.com/docmirror/dev-sidecar,如果不想安装软件也可以自己修改host https://ipaddress.com/website/github.com ,hosts文件位于 C:\Windows\System32\drivers\etc
,如果修改失败需要设置下权限。
3.博客配置
需要调整博客改文件index.html里的window.$docsify
就行,我这里只加了侧边栏,搜索栏。
window.$docsify = {
name: '苏生不惑的博客',
loadSidebar: true,
subMaxLevel: 2,
loadNavbar: true,
repo: 'https://github.com/docsifyjs/docsify/',
maxLevel: 4,
auto2top: true,
formatUpdated: '{MM}/{DD} {HH}:{mm}',
count:{
countable:true,
fontsize:'0.9em',
color:'rgb(90,90,90)',
language:'chinese'
},
search: {
maxAge: 86400000, // 过期时间,单位毫秒,默认一天
paths: 'auto',
// 支持本地化
placeholder: {
'/zh-cn/': '搜索',
'/': '输入关键词搜索'
},
// 支持本地化
noData: {
'/zh-cn/': '找不到结果',
'/': 'No Results'
},
// 搜索标题的最大层级, 1 - 6
depth: 2,
}
搜索效果还行:
知识星球
如果还有问题解决不了加入我的付费知识星球吧,其实我的另外一个星球已经连续更新3年了,在里面的朋友应该能看到,这是2021年度统计 https://wx.zsxq.com/mweb/annual-summaries/2021/index.html
如果文章对你有帮助还请
点赞/在看/分享
三连支持下, 感谢各位!