我正在开发一个复杂的离子项目.我正在开发的许多组件和提供程序都是通用的,可以在我公司正在进行的其他项目中使用.这在软件开发中很常见.这是我提出的Git工作流程(此图显示了分支):
my-company-library-repo ----
|_ component 1 feature branch
|_ company component 1 feature branch testbed
|_ component 2 feature branch
Run Code Online (Sandbox Code Playgroud)
在测试平台中开发的最终组件代码(仅一个.ts或.js文件)被推送到组件功能分支.测试台代码保留在测试平台分支中.此外,在功能分支中还会附带组件可能附带的任何文档.
现在在应用程序repo中,我使用以下命令将feature分支添加为子树:
git subtree add -P <destination-dir/feature> --squash <my-company-library-repo-url> <feature-branch-name>
Run Code Online (Sandbox Code Playgroud)
这给了我以下(此图显示了文件夹结构):
my-app-repo-------
|_ company-library-feature-subtree
Run Code Online (Sandbox Code Playgroud)
这应该只包含它的子文件夹中的.jsor .ts和它的文档.我得到的只是部分工作.当它拉出子树时,它只会拉取组件及其doc文件,但文件会被拉入很长的子目录列表,如下所示:
my-app-repo/src/feature-branch/feature/src/app/providers/...
Run Code Online (Sandbox Code Playgroud)
这使得很难使用库,因为文件被放置了很多目录(未使用的目录).
因此,当我将我的2个文件从功能测试平台分支推送到功能分支时,我怎么能不用它们拉出整个目录结构?
经过一番挖掘之后,我仍然不知道Compodoc是否可以从打字稿注释生成markdown文档。Visual Studio Team Services Wiki功能仅支持markdown文件。如果它支持生成降价文档,那么CLI选项是什么?