tg-cli v1.1.8

Tg-cli - 互娱网站构建脚手架

如在使用中遇到问题或有希望添加的新功能，欢迎积极反馈。

主要功能有：

• 构建互娱专题模版

  • 生成PC、移动通用模板
  • 集成通用模块
  • 集成上报规则

• 集成gulp

  • 分离图片路径
  • 压缩图片
  • 补齐img['alt']/a['title']属性
  • 修复如target="_blank"等安全问题
  • 为静态资源添加时间戳

安装

环境: Node.js , npm 3.0+、 Git.

npm install -g tg-cli

推荐使用国内镜像安装 cnpm

创建专题

使用预览

查看命令输入详解

安装完成以后，可以在命令行下使用 tg 命令来创建专题，该命令的用法：

$ tg -h

  Usage: tg [options]

  Options:

    -h, --help        output usage information
    -V, --version     output the version number
    -g --game <game>  指定游戏域名前缀，例如"cf"、"dnf"、"lol"等
    -d --dir <dir>    指定需求目录名，格式为"a+日期+名称"，例如"a20170601test"

  Examples:

    交互式创建项目：
    tg

    快捷方式创建项目：
    tg -g cf -d a20170406newbie

快捷创建需求模板，可以通过 tg -g 游戏域名前缀 -d 需求目录名 来实现： 特别提醒：外包同学请用下面的交互式创建方法！！

E:\codes> tg -g lol -d a20170601demo
   正在生成通用模板...

√ 目录生成成功！

   您的文件路径：E:\codes\a20170601demo\

   接下来，请执行：

      cd a20170601demo
      npm install
      npm run dev

   请愉快地coding吧:)

交互式创建，直接执行 tg

$ tg
  _____ ____    ____ _     ___
 |_   _/ ___|  / ___| |   |_ _|
   | || |  _  | |   | |    | |
   | || |_| | | |___| |___ | |
   |_| \____|  \____|_____|___|

? 选择项目类型：  (Use arrow keys)
> 移动专题
  PC专题
? 输入项目名(例: a20170406tgcil)：a20170601demo
{ appName: 'a20170601demo' }
? 作者 <cp/rtx名>：cp
? 输入游戏域名前缀(例: cf)：lol
?   (Press <space> to select, <a> to toggle all, <i> to inverse selection)
  = 请选择通用模块(用空格多选) =
>(*) IEG通用登录
 ( ) 浮层
 ( ) 选项卡
 ( ) 轮播图
 ( ) 视频
 ( ) 抽奖
    正在生成通用模板...

√ 目录生成成功！

   您的文件路径：/data/codes/a20170601demo/

   接下来，请执行：

      cd a20170601demo
      npm install
      npm run dev

   请愉快地coding吧:)

分离和打包

页面制作完毕之后，可以进行分离和打包操作：

• 分离

  npm run build

该命令会对网页、js、css文件中的路径进行必要的替换，把对ossweb-img目录下的文件的引用替换为静态CDN的完整URL。然后把处理后的文件拷贝到 build 目录下的同名文件夹中。建议内部重构同学用该命令进行分离后再通过SVN上传。

• 分离并打包

  npm run zip

将会分离页面路径、压缩图片、复制配置文件，并将他们打包zip文件 建议外包同学用该命令进行分离打包后，通过QCP系统上传生成的zip包以同步到服务器，或者将zip包发给接口人即可。

• 分离文件

  npm run build:html

只分离文件，不压缩图片。 方便后期快捷修改html文件

• 压缩图片

  npm run build:image

只压缩ossweb-img目录中的图片，不做其他操作。

使用预览

网页开发及实时预览

1. 用命令行进入项目开发目录

cd <新建的目录>

2. 安装依赖项

npm install

3. 启动预览和实时刷新

npm run dev

执行上述命令后，默认浏览器会自动启动，并打开 http://localhost:8000，在文件有任何修改时，浏览器会立即自动刷新当前页面。

目录说明

生成的需求目录（aYYYYMMDDxxxx）下，目录结构如下图所示：

css                             //样式文件夹，可以删除，建议外联样式放到ossweb-img目录下
  |__comm.css                   //外联样式文件，默认不使用，可以删除
js                              //js文件夹，如果没有外联js可以删除
  |__comm.js                    //外联js文件，默认不使用，可以删除
ossweb-img                      //静态文件夹，该文件夹下的所有子目录及文件会发布到静态文件CDN，URL需要分离处理
  |__tg-cli.png                 //图片资源文件，默认不使用，可以删除
index.htm                       //首页文件，可以根据需要修改后缀为shtml

除了上述需求相关文件之外，目录下还会有node_modules、package.json、gulpfile.js、tg_config.js这几个文件，请勿修改或删除。 如果需要用到 Server Side Includes 特性，可以在目录下创建一个 inc 目录，将页面片（后缀.inc）存放于其中。

模板定制

目录：

    \---template
    +---act      <专题模板>
    |   +---m    <专题模板>
    |   |   \---common    <移动通用专题模板>
    |   |       +---css
    |   |       +---js
    |   |       \---ossweb-img
    |   \---pc   <PC专题模板>
    |       +---common     <pc通用专题模板>
    |       |   +---css
    |       |   +---js
    |       |   \---ossweb-img
    |       \---wt         <wt.qq.com单独模板路径>
    |           \---ossweb-img
    |               +---css
    |               +---image
    |               \---js
    +---gulp      <gulp配置>
    \---module    <通用模块>
        +---common   <多端通用模块>
        +---m        <移动端通用模块>
        \---pc       <PC端通用模块>

模板语法：

模板用Mustache语法配置载入相关模块嵌入和相关配置， 目前支持的自定义配置：

相关

• tgt-pkg - 互娱网站质量测试