Skip to content

AdobeDocs/commerce-operations.zh-Hans

Repository files navigation

source-git-commit workflow-type source-wordcount ht-degree
a6086afc0a1f099b62014ad61098a5a1dc9d4675
tm+mt
719
3%

Adobe Commerce技术文档

我们欢迎社区以及文档团队以外的Adobe员工投稿。

Adobe打开Source行为准则

本项目已采用 Adobe 开源行为准则.NET Foundation 行为准则。有关更多信息,请参阅贡献文章。

关于您对Adobe内容的投稿

请参阅Adobe文档参与者指南

您的参与方式取决于您的身份以及您希望参与的更改类型:

次要更改

如果您要提供较小的更新,请访问文章,然后单击文章底部显示的反馈区域,单击​详细的反馈选项,然后单击​建议编辑​以转到GitHub上的Markdown源文件。 使用GitHub UI进行更新。 有关详细信息,请参阅常规Adobe文档参与者指南

您为此存储库中的文档和代码示例提交的小幅度更正或说明受Adobe使用条款的约束。

社区成员的重大更改或新文章

如果您是Adobe社区的成员,并且希望创建新文章或提交重大更改,请使用Git存储库中的“问题”选项卡来提交问题,以便与文档团队开始对话。 在就计划达成共识后,您需要与员工合作,通过公共和专用存储库中的工作组合来帮助引入新内容。

来自Adobe员工的重大更改

如果您是来自Adobe Experience Cloud解决方案产品团队的技术文档撰稿人、项目经理或开发人员,并且您的工作就是撰写或创作技术文章,那么您应当使用位于https://git.corp.adobe.com/AdobeDocs的专用存储库。

工具和设置

社区参与者可以使用GitHub UI进行基本编辑或创建存储库分支以进行重大更改。

有关详细信息,请参阅Adobe文档参与者指南

如何使用Markdown格式化主题

此存储库中的所有文章都使用GitHub风格的标记。 如果您不熟悉Markdown,请参阅:

模板

对于某些主题,我们使用数据文件和模板来生成已发布的内容。 此方法的用例包括:

  • 发布大量以编程方式生成的内容
  • 为需要机器可读文件格式(如YAML)以进行集成(如站点范围分析工具)的多个系统中的客户提供单一真实来源

模板化内容的示例包括但不限于:

生成模板化内容

通常,大多数作者只需要将发行版本添加到产品可用性和系统要求表中。 所有其他模板化内容的维护都是自动进行的,或由专门的团队成员管理。 这些说明适用于大多数作者。

注释:

  • 生成模板化内容需要在终端中的命令行上工作。
  • 必须安装Ruby才能运行渲染脚本。 有关所需版本,请参阅_jekyll/.ruby-version

有关模板化内容的文件结构的描述,请参阅以下内容:

  • _jekyll — 包含模板化主题和所需资源
  • _jekyll/_data — 包含用于呈现模板的计算机可读文件格式
  • _jekyll/templated — 包含使用Liquid模板语言的基于HTML的模板文件
  • help/_includes/templated — 包含模板化内容的生成输出,格式为.md,因此可在Experience League主题中发布;渲染脚本自动将生成的输出写入此目录中

要更新模板化内容,请执行以下操作:

  1. 在文本编辑器中,打开/jekyll/_data目录中的数据文件。 例如:

  2. 使用现有的YAML结构创建条目。

    例如,要将Adobe Commerce版本添加到产品可用性表中,请将以下内容添加到/jekyll/_data/product-availability.yml文件的extensionsservices部分中的每个条目(根据需要修改版本号):

    support:
       - core: 1.2.3
         version: 4.5.6
    
  3. 导航到_jekyll目录。

    cd _jekyll
    
  4. 生成模板化内容并将输出写入help/_includes/templated目录。

    rake render
    

    注意:​必须从_jekyll目录运行脚本。 如果这是您第一次运行脚本,则必须先使用bundle install命令安装Ruby依赖项。

  5. 导航回root目录。

    cd ..
    
  6. 验证预期的help/_includes/templated文件是否已修改。

    git status
    

    您应会看到类似于以下内容的输出:

    modified:   _data/product-availability.yml
    modified:   help/_includes/templated/product-availability-extensions.md
    
  7. 推送您的更改。

    git add .
    git commit -m "descriptive message of the intended commit"
    git push
    

有关Data FilesLiquid Filters和其他功能的更多详细信息,请参阅Jekyll文档。

About

No description, website, or topics provided.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published