作者:codexu_总体思路1.在Github上创建一个项目,切换到本地创建的docs分支,通过VuePress构建一个文档项目(写一些文档),上传到Github。2、TravisCI自动克隆安装依赖,编译,上传到Githubmaster分支。3、通过GitHubPages功能在web端展示master分支上的内容。相关资料:我的文档看效果:https://codexu.github.io/我的文档远吗:https://github.com/codexu/codexu.github.ioVuePress中文文档(1.x):https://v1.vuepress.vuejs.org/zh/TravisCI:https://travis-ci.org创建项目1.使用VuePress初始化项目。就几个点,文档很详细。依赖项安装在devDependencies中。package.json脚本编写运行和打包脚本,"serve":"vuepressdevdocs","build":"vuepressbuilddocs"。(这里根据自己的习惯,后面持续集成会用到)创建一个docs文件夹,将所有markdown文档存放在这里。docs/.vuepress/config.js可以做很多配置。2.使用Github创建项目[name].github.io。比如我的文档是codexu.github.io,关联到本地。为什么是[名字].github.io?因为在这个项目下,可以直接使用https://[name].github.io/域名,简洁明了~3.通过gitcheckout-bdocs切换到docs分支,docs分支存放的是文档源码,master分支存放打包后的HTML等文档。为什么要用master分支存放打包后的文件?因为[name].github.io项目下没有这个选项,所以也可以换成其他仓库来避免这个问题。4.写一些文档,做一些简单的配置,先别急着提交到Github。通过TravisCI自动打包部署1、在根目录下创建一个.travis.yml文件,写入一些内容:language:node_jsnode_js:-10cache:yarninstall:-yarnscript:-yarnbuildafter_success:-cddocs/.vuepress/dist-gitinit-gitconfig--globaluser.name"${U_NAME}"-gitconfig--globaluser.email"${U_EMAIL}"-gitadd-A-gitcommit-m'deploy'-gitpush--quiet--force"https://${GH_TOKEN}@${GH_REF}"master:${P_BRANCH}language:选择node_js作为语言,前端还有选择吗?node_js:node版本,也许版本越高越快?cache:yarn缓存,可以让你的构建速度更快……对吧。install:安装依赖包管理工具,使用yarn比npm快很多。script:一切准备就绪后,通过yarninstall安装依赖。after_success:安装完成后,我们做一些打包,将说明推送到Github。后面会提到环境变量“${***}”。2、这时候可以push到Github上,因为没有.travis.ymlTravisCI会忽略你的项目,将默认分支改为docs。3.Github添加了个人访问令牌,位于设置/开发人员设置中。Note随便填,填travis-ci就可以了。检查除delete_repo之外的所有权限。4.进入TravisCI,用Github登录,进入dashboard,应该可以看到刚刚创建的项目。5.开始进入本项目,点击右上角更多选项的设置,配置环境变量。GH_REF:项目地址(github.com/[name]/[name].github.io.git)请去掉https://。GH_TOKEN:token是通过上面第三部分得到的。P_BRANCH:要上传的branch,这里我们要传给master。U_EMAIL:您的Github电子邮件地址。U_NAME:您的Github用户名。打开GitHub页面
