html - 在 GitHub 上发布一个包含多个子组件的 Polymer 组件

Question

我创建了一个 Web 组件，我们称它为 a-1.html ，这是我要发布的主要 Web 组件，但该组件还依赖于我创建的另一个组件 b-2.html , 和 b-2.html还取决于我创建的第三个组件 c-3.html .

我关注了 Polymer 的 Create reusable elements指南以便在 GitHub 上发布我的元素，在开发方面一切正常(它们已经开发)，我制作了文档，并在 GitHub 上发布，但我面临 1 个问题。

该指南处理好像您有一个要发布的组件，它提到如果有任何依赖项，我应该放置它们，但是如果我的依赖项仍然是本地依赖项怎么办？我不能放 b-2.html和 c-3.html在 bower.json 中，因为它们尚未在线。

稍后，当我使用 bower install <username>/element 安装我的元素时，该元素无法正常工作，因为它丢失了 b-2.html和 c-3.html ，在线演示(使用 gp.sh 的 Github 页面)也无法正常工作。

对于这种情况，我应该将这些文件放在哪里，以便在 GitHub 上有一个完整的工作 repo，以及一个工作演示。

目录:

bower_components
--- lots of compoenents
--- including b-2 and c-3 added manually by me
---- in order for the demo to work locally, but since they 
----- aren't in bower.json, this won't work eventually
bower.json
demo
---index.html
index.html
README.md
test
---basic-test.html
---index.html
a-1.html

谢谢!

Answer 1

在 GitHub 存储库中发布多个元素与发布单个元素完全相同。您案例中的 b-2.html 和 c-3.html 元素应放在目录中的 a-1.html 旁边:

bower.json
a-1.html
b-2.html
c-3.html

除非在 bower.json 文件的 ignore 部分中指定，否则它们应该由 bower 安装。

在我看来，main bower.json 文件的一部分在这里很微妙。多个元素应被视为可以独立使用的个体。这里可能是适合您情况的主要部分:

"main": [
  "a-1.html",
  "b-2.html",
  "c-3.html"
]

但是，如果您希望使用 iron-component-page 组件来记录您的元素，请根据 Polymer 1.0 documentation所有元素都应导入到单个 html 页面中。推荐的设置组件的方法是为每个组件创建一个子目录，以便为每个组件编写一个演示页面。我在一个个人项目中做到了这一点，其中包括几个用于定义 UML 模型的元素:polymeria-uml .