Docsify/gitee pages站点搭建记录

一、工具准备

1.1、powershell 基本设置

• 以管理员方式启动powershell，执行以下脚本，打开脚本权限

get-executionpolicy
set-executionpolicy remotesigned

• powershell窗口，左上角或alt+space，属性设置，打开复制粘贴
• shift+鼠标右键，用powershell打开准备好的目录, 即可进入当前目录！

1.2、安装npm（已安装未验证，后续有新装再补充）

https://www.jianshu.com/p/d639ed839d70

1.3、git安装

• 官网下载、安装一路next即可Git - Downloading Package (git-scm.com)

二、安装docsify

2.1、安装 docsify-cli 工具：

# npm安装cli工具
npm i docsify-cli -g

# 初始化doc目录，生成默认的index.html, README.md, 和.igno
docsify init ./docs

# 本地运行并预览网站：
docsify serve docs

三、gitee操作

3.1、gitee官网基本设置

• 创建同名仓库，用于xxx.gitee.io直接访问，其他名称还需要二级目录，相对简单，过程略

• 仓库设置为共有，并在服务中设置pages属性，不过需要实名制先！

3.2、代码初始化及日常提交

[!tip] 或者考虑用tortoiseGit，简化操作

• 在doc目录里右键选择git shell，初始化本地用户

git config --global user.name "lin8878"
git config --global user.email "8101113+lin8878@user.noreply.gitee.com"

#做一些简单拉取、提交，然后既可以完全使用ui工具，省的每次敲代码
git remote rm origin
git remote add origin 'https://gitee.com/lin8878/lin8878.git'
git pull remote master
git add .
git commit -m 'autocommit'
git push origin master --force

#1.git强制覆盖本地文件（与git远程仓库保持一致）：
git fetch --all
git reset --hard origin/master
git pull
git强制覆盖本地命令（单条执行）：
git fetch --all && git reset --hard origin/master && git pull

# git强制推送本地代码到远程仓库，切换到对应的要上传文件的文件夹下面执行命令
git push -u origin develop

• 在doc目录里右键选择git ui，用于本地代码仓维护和远程push
  • 步骤：stage、commit、push即可

八、常用模板备份

九、参考资料

• 视乎可以在gitee上做多目录、多笔记本， 这里还有不错的导航！
• https://huanzi-qch.gitee.io/spring-boot/#/
• https://huanzi-qch.gitee.io/
• docsify 做的不错的站长 https://wiki.juemuren4449.com/
• docsify文件同步到gitee https://www.cnblogs.com/summerday152/p/14008463.html
• 毛毛姑娘的博客 https://maomao.ink/index.php/suibi/271.html
• 参考搭建 https://github.com/qufei1993/Nodejs-Roadmap/blob/master/docs/_sidebar.md
• 天乔巴夏 https://tqbx.gitee.io/javablog/