generator-polymer, 搭建一个聚合物工程

分享于 

6分钟阅读

GitHub

  繁體 雙語
Yeoman generator for scaffolding Polymer apps
  • 源代码名称:generator-polymer
  • 源代码网址:http://www.github.com/yeoman/generator-polymer
  • generator-polymer源代码文档
  • generator-polymer源代码下载
  • Git URL:
    git://www.github.com/yeoman/generator-polymer.git
    Git Clone代码到本地:
    git clone http://www.github.com/yeoman/generator-polymer
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/yeoman/generator-polymer
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    

    npm versionnpm downloadsBuild StatusDependency Status

    拒绝警告

    我们鼓励你看一下 Polymer,它包含许多与这里生成器相同的特性,并且拥有更大的团队支持它。 我们计划对这个项目进行偏差并最终从GitHub移除这个项目,并将所有未来。 好消息是在引擎盖下使用文书所以我会在那里看到你 !

    聚合物工程用发生器

    简介

    是polyfills和sugar的一个库,它能够在现代浏览器中使用Web组件。 项目允许开发者使用明天的平台构建应用程序,并告诉W3C在飞行规范中可以进一步改进的地方。

    generator-polymer 使用文书 ( web的脚手架工具) 提供聚合物脚手架,让你可以通过命令行轻松创建和定制聚合物( 自定义) 元素,并使用HTML导入工具导入它们。 这节省了编写样板代码的时间,这样就可以立即开始将逻辑写到组件中。

    特性

    问题

    发生器克隆聚合物初学者工具包种子元素。 如果为这些项目生成的模板文件存在问题,请在这些库中引发它们,因为它们是规范的源文件。

    安装

    安装生成器 npm install -g generator-polymer

    将新目录和光盘放入其中 mkdir -p my-project && cd $_

    创建一个新的聚合物项目: yo polymer

    生成器

    可用生成器:

    注意:生成器将从你的应用程序的root 运行

    应用

    建立一个新的聚合物应用,生成你需要的所有样板。

    例如:

    yo polymer

    元素( 别名:El )

    app/elements 中生成一个聚合物元素,并选择将导入附加到 app/elements/elements.html

    例如:

    yo polymer:element my-element# or use the aliasyo polymer:el my-element

    注意:你必须传入一个元素 NAME,而 NAME 必须包含破折号"-"

    还可以包含要导入的元素依赖项。 例如如果创建需要导入 paper-buttonpaper-checkbox 作为依赖项的fancy-menu 元素,则可以像这样生成文件:

    yo polymer:el fancy-menu paper-button paper-checkbox
    命令行选项
    
    --docs, include iron-component-page docs with your element and demo.html
    
    
    --path, override default directory structure, ex: --path foo/bar will put your element in app/elements/foo/bar
    
    
    
    

    种子

    基于种子元素工作流模型生成复用聚合物元素。 只有在创建独立元素的情况下才会使用,你希望通过 Bower 与其他元素共享。 如果你只是在构建一个聚合物应用,请坚持元素生成器。

    要预览新元素,你需要使用 polyserve命令行工具。

    例如:

    mkdir -p my-foo &&cd$_yo polymer:seed my-foo
    polyserve

    为你的种子元素生成一个Github页面分支。

    这需要在 GitHub 上设置密钥。

    Windows 用户将需要安装

    如果文档或者演示页面在 bower.json 中声明为 devDependencies,那么它们将被包含在你的GitHub页面分支。

    例如:

    cd my-foo
    yo polymer:gh

    如果由于某些原因,你不需要 devDependencies,请使用 --nodevdeps 选项。

    企业级企业

    Github企业实例需要定义自定义主机名。 使用 --hostname 选项。

    例如:

    cd my-foo
    yo polymer:gh --hostname custom.host.com

    测试

    yo polymer 生成的项目包含对 web-component-tester的支持。 包括以下命令:

    运行本地测试( 在终端):

    gulp test:local

    使用 SauceLabs 运行远程测试:

    gulp test:remote

    请参阅 web-component-tester自述文件for配置选项。

    elements.html 文件

    app 生成器将生成一个 elements.html 文件,你可以在其中放置导入。 这里文件将在运行默认 gulp 任务时为 。 如果你想确保 elements.html 是你的index.html 文件中唯一的导入,否则你可能会意外地装载聚合物两次并破坏应用程序。

    请参阅贡献文档。

    提交问题时,请遵循指南。 特别重要的是确保文书是只读的,并提供导致问题的命令或者命令。

    许可证

    BSD许可协议


    proj  SCA  脚手架  Polymer  
    相关文章