Skip to content

vognxt/commerce-operations.zh-Hans

 
 

Repository files navigation

source-git-commit workflow-type source-wordcount ht-degree
2727ddb18995ac2163276a0aa8573161add48971
tm+mt
760
3%

Adobe Commerce技术文档

我们欢迎社区成员以及文档团队以外的Adobe员工踊跃参与。

Adobe开源项目行为准则

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

关于您对Adobe内容的投稿

请参阅 Adobe文档参与者指南.

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

次要更改

如果您出于善意想要对文章进行次要更新,请访问文章,然后单击 编辑 文章中的链接,可转至文章的GitHub源。 然后,只需使用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 — 包含使用液体模板语言的基于HTML的模板文件
  • help/_includes/templated — 包含在中模板化内容的生成输出 .md 文件格式,以便在Experience League主题中发布;渲染脚本自动将生成的输出写入此目录中

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

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

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

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

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

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

    rake render
    

    注意: 您必须从以下位置运行脚本: _jekyll 目录。 如果这是您第一次运行脚本,则必须先安装Ruby依赖项,并具有 bundle install 命令。

  5. 验证预期的 help/_includes/templated 文件已修改。

    git status
    

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

    modified:   _data/product-availability.yml
    modified:   ../help/_includes/templated/product-availability-extensions.md
    

有关更多详细信息,请参阅Jekyll文档 数据文件液体过滤器和其他功能。

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 53.3%
  • JavaScript 40.8%
  • Ruby 5.1%
  • Shell 0.8%