使用Experience Modernization Agent进行可视化更改 visual-changes

本指南适用于更改网站外观的设计师和其他人员:颜色、字体、间距及其块的布局。 您描述了“体验现代化控制台”中对“体验现代化代理”所做的更改,在预览中选中它,然后将其发送给开发人员进行审阅。 代理将编写代码,因此您无需编写CSS或JavaScript。 但是,您的更改是通过其Git存储库到达网站的,因此您需要了解以下基本信息:将您的工作推送到分支,然后通过拉取请求将其移交。 如果这些术语是您的新术语,请参阅本指南中使用的单词。

开始之前 before-you-start

向项目负责人询问以下事项:

  • 访问控制台。 使用您的Adobe ID登录。 请参阅打开Experience Modernization Console。
  • 要处理的站点。 将站点的Git存储库连接到控制台工作区,您需要具有存储库的写入权限才能执行此操作。 查看连接您的站点。
  • 您工作的一部分。 同意哪些块、页面或样式是您的块、页面或样式,这样其他人就不会同时更改相同的文件。 查看从一个人开始,然后划分工作。
  • 如何移交。 大多数团队会保护主分支,以便开发人员查看每个更改。 询问您是否使用​ 创建新PR ​进行推送。 查看移交审核。
  • 对于Figma设计,为可以读取文件的Figma座位。 查看Figma设计中的工作。

在您推送之前,您的工作将保留在您自己的控制台工作区中。 您在预览中尝试的任何内容都不会单独访问实时网站。

CAUTION
切勿在聊天中键入或粘贴密码、访问令牌或其他密钥,并在附加屏幕截图和文件之前检查它们。 聊天中的所有内容都可访问人工智能模型,代理可以将其复制到网站的文件中。 您的Figma令牌仅在​设置 > 凭据​中运行。 查看禁止聊天。

您可以更改的内容 what-you-can-change

在Edge Delivery Services网站上,由作者编写内容,并由代码决定内容的外观。 因此,可视更改会更改网站的代码(主要是其CSS),并使作者输入的内容保持原样。 您无需再次导入或上传页面。

代码的每个部分都会到达网站的不同部分。 在请求更改之前,请确定它应到达的距离:

您更改的内容
示例请求
它的影响
站点范围的样式
“对所有链接和按钮使用我们的蓝色品牌。”
每一页。 颜色、字体和间距存储为设计令牌,全局样式中的命名值如--link-color。
默认内容
“增加所有二级标题下的空间。”
每个页面上的标题、文本、列表、图像和块外的按钮。
块
“给牌块一个圆角和细微的阴影。”
显示块的每个页面。
块变量
“添加卡片块的深色变体。”
仅作者使用变体标记的块,如​卡片(深色)。
节样式
“添加具有浅灰色背景的节样式。”
仅作者在其章节元数据中提供了该样式的章节。
页面模板
“在冒险页面上,以全宽显示英雄形象。”
仅限其元数据名称是该模板的页面。

变体、区域样式和模板仅在作者应用它们时才生效。 要求代理将其中一个页面应用于您正在处理的页面,以便您查看该页面并告知作者何时使用它。

有些请求超出了网站的外观。 添加由作者填写的字段、更改块内容的结构方式,或者添加行为(例如轮播)会更改块的内容模型或其逻辑。 描述您需要的内容,并将这些决策留给开发人员。 请参阅创建、更新和重构块。

限制对某些页面进行更改 impact

对块或全局样式的更改会更改使用它们的每个页面。 在请求之前,请先询问代理在何处使用卡片或样式,例如“我工作区中的哪些页面使用卡片块?”

当更改仅应用于某些页面时,请改为请求以下任一项:

  • 块变体,但只有块的某些实例看起来不同。
  • 当页面的一部分(如高亮显示的区域)需要其自身外观时,节样式。
  • 当某个类型的页面(如所有产品页面)需要其自身的外观时,页面模板。

显示您的意思 references

图片通常比描述更精确。 在提示中使用​附加文件 (回形针图标)进行附加:

  • 您想要的结果或问题的屏幕截图,其中包含要查看哪些内容的句子。
  • 品牌样式指南的页面,以图像或Word或PowerPoint文件的形式显示。

您还可以指向一个看起来正确的网站页面:“使/adventures上的信息卡看起来像/magazine上的信息卡。” 仅使用您的团队可以使用的设计和引用站点。

代理程序不记得对话之间的品牌规则。 一旦确定了规则(如按钮样式或标题大小),请让代理将其写入项目的说明文件中,以便遵循每个对话中的规则。 请参阅项目说明和内存。

从图形设计开始工作 figma

工程师可以通过Figma导入加载项从Figma中读取设计。 它会将设计的颜色、排版规则、间距和变量转换为网站的设计令牌,并将它的组件转换为块或块变量。

  1. 在Figma中,🔗使用控制台的​凭据​设置中列出的只读范围创建个人访问令牌。
  2. 在控制台中,打开​设置,在​ 凭据 ​下输入令牌,然后选择​保存。 新令牌可能需要几分钟才会生效。
  3. 在图中,选择一个元件或框架并复制其链接。 该链接包含用于标识所选内容的node-id。
  4. 在控制台中,发送带有链接的提示,如“更新Teaser块以匹配此Figma组件: {Figma link}”。 重复使用我们现有的设计令牌。”

须知事项:

  • 一次一个组件或帧。 代理从组件构建一个块,或从框架构建一个页面。 在发送下一个链接之前检查每个结果。 请参阅从Figma创建块和从Figma创建新页面。
  • 您的令牌,您的文件。 个人访问令牌读取您可以打开的每个Figma文件,而不会读取任何其他文件。 Figma会发布它并设置它的限制。 每个人都存储自己的令牌。 它与设计令牌、代理从设计中读取的颜色和间距无关。
  • 您的Figma座位。 您需要一个Dev或Figma完整座位;请参阅Figma和Design Systems。 如果控制台报告状态为429的Figma API错误,则令牌已达到Figma的速率限制。
  • 加载项。 图形导入是可选功能。 如果您的项目未启用此功能,代理会提供启用此功能的功能。
  • 设计令牌。 比较新令牌和现有令牌。 当Figma值与现有令牌仅略有不同时,请决定保留哪一个令牌,而不是同时保留两个令牌。

有关用户在代理中使用Figma之前组织批准的内容,请参阅Figma和设计系统。

进行第一次更改 first-change

  1. 在控制台的预览面板中打开页面。
  2. 在​ 视区 ​菜单中,选择要检查的宽度: 桌面、平板电脑​或​移动设备。
  3. 使用预览面板中的选择图标打开​检查模式。
  4. 选择要更改的元素,如标题、图像或按钮。 元素将添加到您的提示中:代理将接收其HTML及其在页面上的位置,并限制对该元素所做的更改。
  5. 描述更改及其达到的范围,然后发送提示。 例如:“使此按钮使用我们的主要样式,无论是在此处还是在每个页面。”
  6. 代理完成后,选择​刷新预览(如果尚未更新预览)。 检查每个​ 视区 ​大小的结果。
  7. 如果某些内容不正确,请说出您所看到的内容,例如“在手机上,文本会触摸图像。” 一次请求一个更改,然后在请求下一个更改之前对其进行检查。

要撤消更改,请要求座席恢复更改。 要将所有未推送的更改拖放到文件中,请打开​ 更改 ​视图,然后选择该文件旁边的​放弃。 请参阅更改操作。

如果代理在几次尝试后仍无法立即获得更改,请咨询您的开发人员,或在菜单栏中选择​请求支持,并描述您的请求和看到内容。 您的请求将发送到构建代理的团队。 当对话不顺利时,控制台还可以在​ 需要帮助? ​下提供帮助 请参阅请求支持。

示例提示 example-prompts

  • “使所有标题都使用附加样式指南中的标题字体。”
  • “将卡块中的卡片设置为等高,其按钮位于底部。”
  • “添加Teaser块的dark变体,在深色品牌颜色上使用白色文本,并将其应用于/adventures上的第二个Teaser。”
  • “添加浅色背景且上下有更多空间的highlight分区样式,并将其用于主页的新闻稿分区。”
  • “在移动设备上,栈叠列并将图像放在文本上方。”
  • “我工作区中的哪些页面使用主页块? 请向我展示每个人在完成这项更改后的情况。”
  • “将我们商定的按钮样式写入项目的说明文件中。”

交出前先检查 check

  • 检查每​ 视区 ​大小,特别是​移动设备。
  • 选中使用同一块、样式或模板的其他页面,而不只是您处理的页面。
  • 检查设计如何处理实际内容:长标题、短标题、缺少图像和包含许多项目的列表。
  • 检查文本在背景中是否保持可读状态。 您可以询问代理:“根据WCAG AA检查Teaser块中文本的颜色对比度。”
  • 推送之后,请打开拉取请求中列出的预览URL,然后查看那里的页面。 查看控制台预览与站点不同。

移交以进行审核 hand-over

  1. 按照推送代码更改中的说明,使用​ 创建新PR ​推送代码。 只存放属于您更改的文件,并以纯句子描述它,例如“圆角和卡片阴影”。
  2. 在通知中选择​查看PR,并将拉取请求的链接发送给审阅该请求的开发人员。

要进行审阅者请求的更改,请继续处理同一分支并使用​推送至当前分支;拉取请求将更新。

当开发人员合并实时网站时,您的更改会到达该网站。 如果您还更改了页面上的文本或图像,则属于内容更改:它仅在页面上传和发布时到达网站。 同意作者的看法。 请参阅协调内容更改。

本指南中使用的单词 glossary

术语
含义
区块
页面的组件,例如卡片、Teaser或轮播。 每个块都有自己的CSS和JavaScript。
块变量
块的替代外观,作者通过在括号中添加名称来选择该样式,例如​卡片(深色)。
默认内容
不在块中的标题、文本、列表、图像和链接。
分区
对块和默认内容进行分组的页面的一部分。 作者可以在节元数据中为节指定样式。
模板
在页面的元数据中命名的页面类型,例如文章或产品页面。
设计令牌
颜色、字体或间距的命名值,存储为CSS自定义属性,如--link-color。
分支
Git存储库中的单独工作行。 实时网站使用main分支。
拉取请求
将您的分支合并到另一个分支的请求,开发人员在合并之前会审查该请求。
预览
控制台呈现您的工作区。 推送后,每个分支还会拥有自己的预览URL。

在形状内容结构下更深入地说明了节、块和默认内容。

recommendation-more-help
experience-manager-cloud-service-help-main-toc