source-git-commit | workflow-type | source-wordcount | ht-degree |
---|---|---|---|
580a15c908fc8ac4ef5d62582dfdd87d75dde994 |
tm+mt |
766 |
3% |
我们欢迎社区成员以及文档团队以外的Adobe员工踊跃参与。
本项目已采用 Adobe 开源行为准则或 .NET Foundation 行为准则。有关更多信息,请参阅贡献文章。
请参阅 Adobe文档参与者指南.
您的参与方式取决于您的身份以及您希望参与的更改类型:
如果您要提供较小的更新,请访问文章,然后单击文章底部显示的反馈区域,然后单击 详细的反馈选项,然后单击 建议编辑 以转到GitHub上的Markdown源文件。 使用GitHub UI进行更新。 查看常规 Adobe文档参与者指南 以了解更多信息。
您为此存储库中的文档和代码示例提交的小幅度更正或说明受Adobe使用条款的约束。
如果您是Adobe社区的成员,并且希望创建新文章或提交重大更改,请使用Git存储库中的“问题”选项卡来提交问题,以便与文档团队开始对话。 在就计划达成共识后,您需要与员工合作,通过公共和专用存储库中的工作组合来帮助引入新内容。
如果您是来自Adobe Experience Cloud解决方案产品团队的技术文档撰稿人、项目经理或开发人员,并且您的工作就是撰写或创作技术文章,那么您应当使用位于的专用存储库 https://git.corp.adobe.com/AdobeDocs
.
社区参与者可以使用GitHub UI进行基本编辑或创建存储库分支以进行重大更改。
请参阅 Adobe文档参与者指南 以了解详细信息。
此存储库中的所有文章都使用GitHub风格的标记。 如果您不熟悉Markdown,请参阅:
对于某些主题,我们使用数据文件和模板来生成已发布的内容。 此方法的用例包括:
- 发布大量以编程方式生成的内容
- 为需要机器可读文件格式(如YAML)以进行集成(如站点范围分析工具)的多个系统中的客户提供单一真实来源
模板化内容的示例包括但不限于:
通常,大多数作者只需要将发行版本添加到产品可用性和系统要求表中。 所有其他模板化内容的维护都是自动进行的,或由专门的团队成员管理。 这些说明适用于“大多数”作者。
注意:
- 生成模板化内容需要在终端中的命令行上工作。
- 必须安装Ruby才能运行渲染脚本。 请参阅 _jekyll/.ruby-version 适用于所需版本。
有关模板化内容的文件结构的描述,请参阅以下内容:
_jekyll
— 包含模板化主题和所需资源_jekyll/_data
— 包含用于呈现模板的计算机可读文件格式_jekyll/templated
— 包含使用液体模板语言的基于HTML的模板文件help/_includes/templated
— 包含在中模板化内容的生成输出.md
文件格式,以便在Experience League主题中发布;渲染脚本自动将生成的输出写入此目录中
要更新模板化内容,请执行以下操作:
-
在文本编辑器中,打开以下位置的数据文件:
/jekyll/_data
目录。 例如: -
使用现有的YAML结构创建条目。
例如,要将Adobe Commerce版本添加到产品可用性表中,请将以下内容添加到
extensions
和services
的部分/jekyll/_data/product-availability.yml
文件(根据需要修改版本号):support: - core: 1.2.3 version: 4.5.6
-
导航至
_jekyll
目录。cd _jekyll
-
生成模板化内容并将输出写入
help/_includes/templated
目录。rake render
注意: 您必须从以下位置运行脚本:
_jekyll
目录。 如果这是您第一次运行脚本,则必须先安装Ruby依赖项,并具有bundle install
命令。 -
验证预期的
help/_includes/templated
文件已修改。git status
您应会看到类似于以下内容的输出:
modified: _data/product-availability.yml modified: ../help/_includes/templated/product-availability-extensions.md