知识储备
在阅读本篇前,您需要了解什么是小故事,可以查看开发小故事前期准备、小故事的组织结构、创建小故事的封面和创建小故事的封底页面了解基础信息;
小故事的MIP规范校验
小故事本身是基于mip技术开发的html页面,如果想要被搜索收录并被mip cache
缓存,需要您的小故事页面符合mip的规范校验。我们提供以下两种方法对页面进行代码规范的检查。
使用在线校验工具
首先打开 MIP 校验工具 的校验网页,把您开发的小故事页面代码复制粘贴到MIP代码校验工具的可视化区域,在网页的底部就会显示出您开发的小故事页面是否符合MIP规范。
如果校验通过,则会显示绿色的SUCCESS → 验证成功,完全符合MIP规范
提示您页面校验成功。
如果校验不通过,则会显示红色的ERROR → line x,col x:xxxxxxxx
提示您页面校验不成功,并且定位校验错的行号和列号。
使用mip命令行工具
使用MIP-CLI工具中的mip validate
命令。MIP-CLI是mip 开发工具,用于 MIP 页面和组件的开发和校验。依赖环境为 Node.js (>=4.x)
输入node -v
查看 node 版本,如果版本为 5.x,6.x, 请点击这里 。
- 示例:
将安装好的 node 打开 输入以下指令(mac系统需要sudo):
$ npm install -g mip-cli
mac系统需要使用以下指令:
$ sudo npm install -g mip-cli
出现以下界面显示正在安装:
如果安装过程中有报错, 请点击这里查看解决办法 。
检验是否安装成功可以输入mip -V
,如果出现 mip 版本号,则表示安装成功。
此时您已经成功安装好MIP-CLI,在控制台直接输入mip validate xxx.html
,其中xxx.html文件为您自己开发的mip页面。您可以查看是否通过校验。
- 可以看到如果成功,控制台将显示以下提示:
- 如果失败,控制台会显示失败原因,并且定位错误信息的出处:
在校验的同时,可能会有各种报错,那么您可以通过查看MIP校验错误列表来定位出错的位置和原因,修改并且重新校验,校验通过就可以提交部署MIP小故事页面了。
上一节:为小故事添加页面统计