网站主题最初是在开发数据api的时候看到的，当时在学习Mybatis-Plus，最初也不知道这是个主题，就觉得Mybatis-Plus官网UI真的不错，直到后面发现另外一个类似的网站，我意识到这是个模板，于是有了自己也搭建一个的想法，不过拖延症相当严重，最初是在宝塔上修改的，效率极低，一度放弃部署，直到最近换成本地开发才好了很多，也就是最近网站搭建初步完成，接下来就是往里面增加文章等等，这里带大家从零开始搭建Vdoing主题网站，算是对过去一个月的知识总结。下图就是mybatis-plus官网，是我们年轻人喜欢的风格（这里随便吐槽一下xx园吧，风格还是20年前的，不知道他们的UI设计师是不是还是兼职的）。
what？你居然没有github账号，建议你放弃网站部署（开玩笑）。作为全球最大的代码托管平台，基本上每个稍微接触过开发的应该都用过，如果你还没注册的话，赶紧注册一个，没听过github太丢人了，注册也很简单（有手就行）。
这里推荐去国外的Godaddy平台注册一个域名
vercel平台是一个可以免费托管个人网站的自动化部署平台，只要你的代码托管平台（类似github，gitlab，gitee等）commit发生变化，它就会自动更新和重新部署，解放生产力。
这个是个包管理工具，和npm差不多，听说更快一点，这里安装是由于主题更新采用的是这个命令，所以这里安装一下。
yarn官网,如果不想配置环境变量的话，还是可以采用msi后缀安装。
有了图床，你就可以随时随地采用URL引用你的图片，非常方便，可以参考我写的这篇搭建博客CDN+COS搭建图床超详细步骤,有个缺点就是需要备案才能使用自定义域名和CDN服务，不过如果想要白嫖的话，搜索国外的图床也是可以的，国内也有一些提供图床配置的，使用它们的域名上传图片也可以。这里采用的是pic-go图床管理工具，强烈安利，真的太方便了。
如果你没有自己的图床也没关系，主题博客还提供本地引用的功能，不过这个更改图片的时候比较麻烦，虽然有时候它可能更快一点点。
我是用习惯了idea，所以这里推荐idea进行开发，安装插件，然后就可以本地开发了，没有的话安装一下即可。
idea官网
安装插件
至此，准备工作已经完成，接下来就进入今天的主题。
三、本地开发1.githubfork项目Vdoing主题项目地址,这里建议fork整个仓库，然后自己做一些修改即可，作者大大真的太强了。
打开以下目录的,你可能会问咋是md格式的，不应该是html格式的吗？别着急，这个是开发中的，打包之后是
以下字段对应相关的图，可以自行体会一下,对应导航栏下面的几个字段，其中涉及使用URL引入的，可以替换成路径引用，具体字段帮助请自行查看fork过来的仓库介绍，也可以到Vdoing官方文档查阅.
home:trueheroImage:→actionLink:/wresource/bannerBg:none
通过路径引用的图片目录，把你想要的图片全放进去然后就可以引用了。
进入界面
首先我们先找到head位置进行配置，打开网站的小图标，同样也可以使用URL或者本地引用
找到location开头的这段代码，网站的标题和描述写一下，这个会在百度搜索的快照中展示。
locales:{'/':{//代表baseurl，即网站所有的引用的根路径，默认是没有的，如果文件夹有需要可以修改lang:'zh-CN',title:"IT七剑客",description:'互联网中的持剑者,七剑客带你斩断一切bug',}},下面这些代码主要是配置导航栏和其他全局功能，其中logo是最左侧显示的图片，repro是自己的github名，用于直接跳转github主页，其他的取默认即可。
sidebarDepth:2,//侧边栏显示深度，默认1，最大2（显示到h3标题）logo:'',//导航栏logorepo:'xyh-fu',//导航栏右侧生成Github链接searchMaxSuggestions:10,//搜索结果显示最大数lastUpdated:'上次更新',//开启更新时间，并配置前缀文字string|boolean(取值为git提交时间)docsDir:'docs',//编辑的文件夹//docsBranch:'master',//编辑的文件所在分支，默认master。注意：如果你的分支是main则修改为maineditLinks:true,//启用编辑editLinkText:'编辑',
footer:{//页脚信息createYear:2022,//博客创建年份//博客版权信息，支持a标签copyrightInfo:'IT七剑客|MITLicenseliimgsrc=""style="zoom:30%;"ahref=""target="_blank"闽ICP备2021006579号-4/a/liliimgsrc=""style="zoom:30%;"atarget="_blank"rel="noopener"href=""闽公网安备35012102500470号/a/li'},
至此基本配置已经大功告成，接下来我们谈谈文章是怎么配置和主页路由的规则。
文章誊写和路由设置首先配置目录页，这个是文章的导航界面，可以分别查看各个目录下的文章列表
---pageComponent:name:Cataloguedata:path:01.wresource安卓imgUrl:
在这里设置目录的路由以及一些基础的配置，放图自行体会，这里需要注意一点，path要和docs下面的相应文章目录路径名一致，这里仅仅只是配置一下界面，真正的文章是放在docs下面的目录中。
关于文章誊写和命名规则具体查看作者的这篇文章关于目录和文章名称约定（这里偷懒一波）。
接下来再次回到之前得中，可以配置主界面相关信息了
features:可选imgUrl:
配置效果如下图所示
这部分就属于网站的内部配置了，与外观没有多大关系，如果觉得可以了，就不用配置了
站点信息页面主要用于统计网站相关信息的功能同时也增加文章字数统计以及阅读量统计等等，这个配置参考kbt大大的博客，这里提醒一下readfile文件在博客中失效，建议去kbt大大的github项目主页获取最新的代码。站点信息搭建
这里给出当时踩坑的那个readfile文件代码，如果有不同，以作者的为主。
importfsfrom'fs';//文件模块importpathfrom'path';//路径模块importmatterfrom'gray-matter';//FrontMatter解析器'chalk'//命令行打印美化constlog==(__dirname,'..','..','..','docs');//docs文件路径/***获取本站的文章数据*获取所有的md文档，可以排除指定目录下的文档*/functionreadFileList(excludeFiles:Arraystring=[''],dir:string=docsRoot,filesList:ArrayObject=[]){constfiles=(dir);((item,index)={letfilePath=(dir,item);conststat=(filePath);if(!(excludeFilesinstanceofArray)){log((`error:传入的参数不是一个数组。`))}((excludeFile)={if(()item!=='.vuepress'item!=='@pages'item!==excludeFile){readFileList(excludeFiles,(dir,item),filesList);//递归读取文件}else{if((dir)!=='docs'){//过滤docs目录级下的文件constfileNameArr=(filePath).split('.')letname=null,type=null;if(===2){//没有序号的文件name=fileNameArr[0]type=fileNameArr[1]}elseif(===3){//有序号的文件name=fileNameArr[1]type=fileNameArr[2]}else{//超过两个‘.’的log((`warning:该文件"${filePath}"没有按照约定命名，将忽略生成相应数据。`))return}if(type==='md'){//过滤非md文件({name,filePath});}}}});});returnfilesList;}/***获取本站的文章总字数*可以排除某个目录下的md文档字数*/functionreadTotalFileWords(excludeFiles=['']){constfilesList=readFileList(excludeFiles);letwordCount=0;((item:any)={constcontent=getContent();letlen=counter(content);wordCount+=len[0]+len[1];});if(wordCount1000){returnwordCount;}(wordCount/100)/10+'k';}/***获取每一个文章的字数*可以排除某个目录下的md文档字数*/functionreadEachFileWords(excludeFiles:Arraystring=[''],cn:number,en:number){constfilesListWords=[];constfilesList=readFileList(excludeFiles);((item:any)={constcontent=getContent();letlen=counter(content);//计算预计的阅读时间letreadingTime=readTime(len,cn,en);letwordsCount:any=0;wordsCount=len[0]+len[1];if(wordsCount=1000){wordsCount=(wordsCount/100)/10+'k';}//fileMatterObj={content:'剔除frontmatter后的文件内容字符串',data:{frontmatter对象},}constfileMatterObj=matter(content,{});constmatterData=;({item,wordsCount,readingTime,matterData});});returnfilesListWords;}/***计算预计的阅读时间*/functionreadTime(len:Arraynumber,cn:number=300,en:number=160){letreadingTime=len[0]/cn+len[1]/en;if(readingTime60readingTime60*24){//大于一个小时，小于一天lethour=(readingTime/60);letminute=(readingTime-hour*60);if(minute===0){returnhour+'h';}returnhour+'h'+minute+'m';}elseif(readingTime60*24){//大于一天letday=(readingTime/(60*24));lethour=((readingTime-day*24*60)/60);if(hour===0){returnday+'d';}returnday+'d'+hour+'h';}returnreadingTime1?'1':(readingTime*10)/10+'m';//取一位小数}/***读取文件内容*/functiongetContent(filePath:string){(filePath,'utf8');}/***获取文件内容的字数*cn：中文*en：一整句英文（没有空格隔开的英文为1个）*/functioncounter(content:string){constcn=((/[\u4E00-\u9FA5]/g)||[]).length;consten=((/[\u4E00-\u9FA5]/g,'').match(/[a-zA-Z0-9_\u0392-\u03c9\u0400-\u04FF]+|[\u4E00-\u9FFF\u3400-\u4dbf\uf900-\ufaff\u3040-\u309f\uac00-\ud7af\u0400-\u04FF]+|[\u00E4\u00C4\u00E5\u00C5\u00F6\u00D6]+|\w+/g)||[]).length;return[cn,en];}export{readFileList,readTotalFileWords,readEachFileWords,}下面给出效果图
这里有一点比较坑，就是当时这个模块默认挂载到热门标签下面，然而我没有设置标签。最后给挂在了页面底部。请务必仔细阅读作者的博客。
广告配置首先在的head中引入下列代码，这里是谷歌广告配置。
['script',{'data-ad-client':'自己的广告id',async:'async',src:'',},],//网站关联GoogleAdSense与html格式广告支持（你可以去掉）然后在themeConfig中添加下列字段
在下列目录中完成html广告的配置
我的配置，在全局右下角添加广告。
windowRB:`scriptasyncsrc=""/scriptinsclass="adsbygoogle"style="display:inline-block;width:200px;height:200px"data-ad-client="ca-pub-广告id"data-ad-slot="用户名"/insscript(adsbygoogle=||[]).push({});/script`,复制
百度统计这部分比较简单，在head中加入以下字段即可（谁说比较简单的，这个我鼓捣了一周，插件用不了，不知道是啥原因，最后采用这个比较简单的方法配置），至于百度统计码，百度一下百度统计即可。它最重要的作用就是分析网站的来访数量以及搜索量等等，站长必备工具之一。
['script',{src:'',},],复制
关于mongodb，感觉应该是香港节点会更快一点，不知道为啥会推荐us节点
关于环境id
这里应该是最近vercel的默认域名被禁的缘故，之类的域名国内均不能访问，所以在部署环境id时需要添加自己的域名进行部署，类似。
最开始是使用代理才可以进行配置的，之前都失败了，这一步如果没有默认的密码账号输入的话，建议开代理。
温馨提示，这部分部署需要国内备案域名，如果没有备案域名，请使用其他两种方式部署。
首先先运行vuepress项目，进入项目路径，终端输入以下命令进行构建项目
npmrunbuild
复制
生成静态文件成功之后可以在dist文件夹找到打包好的静态文件
直接将文件复制一下拖拽到cos的以下界面，注意是dist里面的文件，不要传dist整个文件夹，反正最后是存储桶中有如下的内容，即dist里面的文件。
此时还访问不了，如果想直接访问的话，权限管理改成公共读就可以访问了，使用访问节点的url即可，不过我们要介绍使用cdn进行访问，更快。
利用cdn进行私有读写，cdn提供给外部访问，配置相关可以查看这篇博客里面的配置，几乎是一样的，不多赘述。CDN+COS搭建图床超详细步骤，最后记得开启https访问。
至此我们已经完成了cos+cdn部署静态网站。下面是部署成功的站点,访问速度还可以。
vercel部署可以说是最简单的部署，还带自动化部署的功能，强烈推荐，目前主站是部署在vercel上的。
进入主界面，选择添加新项目：AddNew，选择Project
之后就是选择导入github中的项目，私有仓库也可以，gitpage中这个功能貌似收费，只能public。
配置运行参数，这部分是当初最坑的那个，当时不知道输出填啥，一直构建失败
先选择构建
接下来就是build和Outputsettings，按照以下设置即可
其中outputdirectory是很坑，之前不知道这个是输出文件，一直部署dev模式的网站，速度感人。
接下来就是稍微有点长的构建时间，大概10分钟吧，主要是Vdoing作者的文章比较多，构建需要花一定时间。
部署完毕是这样的，不过目前有个小尴尬的事情，自动提供的这几个域名国内访问不了，所以只能自己添加域名了。
在domains中添加自己的域名
先添加，然后根据提示进行添加dns解析
按照提示添加完解析即可
添加完会自动帮你添加ssl证书
大功告成
至此部署已经完成，之后只需要远程提交自己的修改到github上面即可完成修改界面。
创建静态网站记得填入自己的域名并添加dns解析
将里面的文件删去，最后一个.没删除问题不大，最主要是为了防止冲突
上传完解压一下就行
将解压后的文件复制到网站最开始的目录下，并删去原来的dist和文件
最后申请一下免费的证书和开启强制https就结束了（声明，没有域名，只是随便输一个）
浏览器键入自己的域名就可以访问了，我的宝塔部署的站点IT七剑客,挺快的，比之前dev模式好多了
五、常用命令安装node依赖自动安装缺少的依赖
npminstall项目调试
在测试功能时使用，该模式下，所有改动均可以快速看到效果，无需重新构建
npmrundev项目打包
用于生成环境的打包，项目成功之后可以打包，然后部署到各个地方
npmrunbuild六、写在最后
