Docsify/other/How2UseDocsifyAndGit.md
2023-02-17 18:14:52 +08:00

50 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 如何优雅地搭建自己的个人Blog
## 0x00 简介
> 本文是一篇介绍如何使用个人vps自建bolg的文章主要使用了nginx+gitea(或其他git服务)+docsify来搭配完成个人bolg的建设。搭建完成后你只需要像写程序一样编写markdown文件然后git命令推送到你的仓库git仓库的webhook会提醒vps拉取最新的代码你的bolg就会自动完成更新。
> 没错!就是这么丝滑!
很多技术人员都有使用自己的vps搭建个人网站的习惯但是如何能简单高效地完成个人网站的部署日后编写bolg不需要再操心管理只需要将主要精力放在编写markdown上成了笔者思考的问题。
笔者选择了[Docsify](https://docsify.js.org/#/zh-cn/quickstart)作为个人bolg的搭建方案这是一个轻量级的静态个人bolg项目初始化后用户只需要关心如何编写自己的markdown文件内容即可所有的配置都在index.html里完成不依赖其他如tomcat、nginx等服务容器。当然多数情况下你的vps还是需要配置一个nginx以支持子域名访问服务器的功能的毕竟你也不希望其他人在访问你的各种服务时要在域名或者IP后再挂上各种奇奇怪怪的端口号吧
言归正传如何搭建一个轻量级的自有bolg服务呢
## 0x01 给服务器VPS安装nginx
如果你已经安装过nginx了当我没说(〃'▽'〃),可以略过这一节看下面的步骤了。
需要说明的是笔者是在Ubuntu 22环境下搭建的如果你使用的是其他的Linux发行版需要替换部分的命令请自行斟酌。
1. 在ubuntu环境下运行下面的命令
```shell
# 更新apt源
sudo apt update
# 安装nginx
sudo apt install nginx
```
使用下面的命令测试nginx是否安装成功
```shell
# 测试nginx状态
nginx -t
```
返回下面的信息说明nginx安装成功。
```shell
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
```
上面返回的信息也提示了nginx的配置目录是在/etc/nginx/nginx.conf随后我们需要修改这个目录的配置。
2. 初始化Docsify并将Docsify代码通过git上传到gitee上。
参考Docsify教程的[Quick Start](https://docsify.js.org/#/zh-cn/quickstart)初始化Docsify并将对应的代码上传到gitee上。
初始化docsify的命令如下
```shell
# 使用npm安装docsify
npm i docsify-cli -g
# 初始化docsify
docsify init ./docs
```