XFE DOCUMENT

# PC端专题

# 获取模板

目前为了持续维护, 我们在当前仓库建设了 template-pc 的分支用于管理 PC 专题模板, 请使用下面命令进行项目起始开发:

# git 克隆一个分支名为 template-pc 的项目, 仅拉取最后一次 commit, "." 表示在当前文件夹中进行克隆
git clone -b template-pc https://github.com/XFETeam/xfe-document.git --depth=1 .

# 专题创建

  • 专题命名

    专题文件夹的命名为：a+年月日+专题英文或拼音小写简写+版本号，如：a20180412test12

  • 文件命名

    html首页文件必须命名为"index"，文件名禁止特殊字符比如空格、$等。统一使用英文单词或拼音缩写，必须小写，使用-隔开。

# 页面头尾部

  • navibar.js

    根据专题所属项目引用公用组件头部JS

      // 剑网三头部导航栏
  <script src="//zhcdn01.xoyo.com/xassets/com/jx3/navibar/v2/navibar.js"></script>

  • footer.js

    引用公用组件底部通用栏JS

      // 底部通用栏
  <script src="//zhcdn01.xoyo.com/xassets/com/pf/footer/v3/black/footer.js"></script>

# 页面TDK、Meta

# 页面内容

  • 默认字体

    使用reset样式，默认字体微软雅黑，使用英文方式：font-family:'Microsoft Yahei,微软雅黑,Tahoma,Helvetica Neue,Helvetica,PingFang SC,sans-serif'、 引用reset css

      // reset.css
  <script src="//zhcdn01.xoyo.com/xassets/com/pf/reset/reset.css"></script>

  • CSS

    css、class、id都需小写且书写合法，禁止特殊字符，使用-隔开

  • 页面跳转

    如为双端页面，需要自动判断跳转，如PC访问移动端页面，跳转到对应的PC专题上，反之亦然

  • HTML标签

    标签必须合法且闭合、嵌套正确，标签名均为小写，无语法错误

  • 链接

    页面A标签需要添加链接地址，并能正常打开，无地址时候添加

       javascript:alert('敬请期待！')

  • https协议

    分离后的页面链接、图片链接、静态资源等去掉http:使用//自适应。

  • CDN地址

    JS、CSS等公用静态资源，如jQuery，统一使用西山居CDN地址。禁止添加其他非西山居域名下的资源

# 图片规范

  • 图片标签

    图片标签必须写上宽度、高度和alt属。宽高为图片的原大小，alt不能为无意义字符，需要能表现出图片的含义，如图片为道具图，则应该为道具的名称。

  • 合理切图

    道具图片、头像、奖品，必须单独切割出来

# 兼容测试

# 内容检查

  • 页面内容检查 代码之外的检查，例如错别字、图片版权等

← 移动端专题 →