source-git-commit | workflow-type | source-wordcount | ht-degree |
---|---|---|---|
a6086afc0a1f099b62014ad61098a5a1dc9d4675 |
tm+mt |
719 |
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
— 包含使用Liquid模板语言的基于HTML的模板文件help/_includes/templated
— 包含模板化内容的生成输出,格式为.md
,因此可在Experience League主题中发布;渲染脚本自动将生成的输出写入此目录中
要更新模板化内容,请执行以下操作:
-
在文本编辑器中,打开
/jekyll/_data
目录中的数据文件。 例如: -
使用现有的YAML结构创建条目。
例如,要将Adobe Commerce版本添加到产品可用性表中,请将以下内容添加到
/jekyll/_data/product-availability.yml
文件的extensions
和services
部分中的每个条目(根据需要修改版本号):support: - core: 1.2.3 version: 4.5.6
-
导航到
_jekyll
目录。cd _jekyll
-
生成模板化内容并将输出写入
help/_includes/templated
目录。rake render
注意:必须从
_jekyll
目录运行脚本。 如果这是您第一次运行脚本,则必须先使用bundle install
命令安装Ruby依赖项。 -
导航回
root
目录。cd ..
-
验证预期的
help/_includes/templated
文件是否已修改。git status
您应会看到类似于以下内容的输出:
modified: _data/product-availability.yml modified: help/_includes/templated/product-availability-extensions.md
-
推送您的更改。
git add . git commit -m "descriptive message of the intended commit" git push
有关Data Files、Liquid Filters和其他功能的更多详细信息,请参阅Jekyll文档。