da-content

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

DA + EDS content reference

DA + EDS 内容参考

A reference skill — not a workflow. Use it whenever you need to know what the rules are for generating, uploading, or delivering content through Adobe Document Authoring (DA) and Edge Delivery Services (EDS).

This skill consolidates rules from three primary surfaces. Load the reference for the task at hand:

Doing	Read
Generating HTML for DA upload	references/html-content.md
Uploading images, video, PDFs, fonts	references/media.md
Hitting the DA admin API, auth, preview/publish	references/platform.md
Re-verifying asset boundary behavior empirically	references/fixtures/README.md

Every factual claim in the references is tagged

[verified]

(read from code or observed empirically) or

[assumed]

(inferred from documentation without direct verification).

这是一份参考技能，而非工作流。当你需要了解通过Adobe Document Authoring（DA）和Edge Delivery Services（EDS）生成、上传或交付内容的规则时，即可使用本技能。

本技能整合了三个核心层面的规则。根据手头任务加载对应的参考文档：

操作	参考文档
生成用于DA上传的HTML	references/html-content.md
上传图片、视频、PDF、字体	references/media.md
调用DA admin API、认证、预览/发布	references/platform.md
实证验证资源边界行为	references/fixtures/README.md

参考文档中的所有事实声明都标记为

[verified]

（从代码读取或实证观察）或

[assumed]

（从文档推断，未直接验证）。

When to use this skill

何时使用本技能

Invoke this skill whenever you are:

Generating HTML that will be uploaded to DA (
```
admin.da.live/source/...
```
).
Uploading any binary (PNG, JPG, SVG, MP4, PDF, WOFF2) to DA.
Calling
```
admin.da.live
```
(Source API) or
```
admin.hlx.page
```
(preview / publish API) directly.
Reading a DA-stored HTML document and modifying it before re-upload.
Diagnosing why a generated page renders incorrectly on
```
aem.page
```
/
```
aem.live
```
(silent failures:
```
about:error
```
images, missing meta tags, blocks rendering as plain HTML without their JS or CSS).

在以下场景中调用本技能：

生成将上传至DA的HTML（
```
admin.da.live/source/...
```
）。
向DA上传任何二进制文件（PNG、JPG、SVG、MP4、PDF、WOFF2）。
直接调用
```
admin.da.live
```
（Source API）或
```
admin.hlx.page
```
（预览/发布API）。
读取DA存储的HTML文档并修改后重新上传。
诊断生成的页面为何在
```
aem.page
```
/
```
aem.live
```
上渲染异常（静默失败：
```
about:error
```
图片、缺失元标签、区块以纯HTML形式渲染而无对应的JS或CSS）。

When NOT to use this skill

何时不使用本技能

Writing block JS or CSS for a project — use building-blocks. This skill covers the content side, not the code side.
Universal Editor, structured-content authoring, or AEM Cloud Service (Java / OSGi / JCR). Out of scope.

为项目编写区块JS或CSS —— 使用building-blocks技能。本技能涵盖的是内容层面，而非代码层面。
Universal Editor、结构化内容创作或AEM Cloud Service（Java/OSGi/JCR）。这些均超出本技能范围。

Related Skills

Minimal upload example

最小上传示例

The most common operation — upload an HTML document to DA. Shows the non-obvious rules in one place: multipart/form-data body, field name

data

, blob with

text/html

type, Bearer IMS token, then a separate preview call to make the page reachable at

aem.page

. See references/platform.md for the full contract and references/html-content.md for what the HTML payload must look like.

bash

undefined

最常见的操作 —— 向DA上传HTML文档。将非显而易见的规则集中展示：multipart/form-data请求体、字段名

data

、

text/html

类型的二进制数据、Bearer IMS令牌，然后单独调用预览接口使页面可在

aem.page

访问。完整协议请见references/platform.md，HTML负载格式要求请见references/html-content.md。

bash

undefined

Use $DA_TOKEN from the da-auth skill, or read a cached token file directly.

使用da-auth技能获取的$DA_TOKEN，或直接读取缓存的令牌文件。

See platform.md §3 for the cache locations the various Adobe DA tools use.

请见platform.md第3节了解各类Adobe DA工具使用的缓存位置。

TOKEN="${DA_TOKEN:?invoke the da-auth skill to obtain a DA admin token}"

1. Upload HTML — note multipart with field name "data" (other names silently fail)

1. 上传HTML —— 注意使用multipart格式且字段名为"data"（其他字段名将静默失败）

curl -X PUT
-H "Authorization: Bearer $TOKEN"
-F "data=@./page.html;type=text/html"
"https://admin.da.live/source/{org}/{repo}/path/to/page.html"

2. Trigger preview — required separate step, path WITHOUT .html extension

2. 触发预览 —— 这是必需的单独步骤，路径不包含.html扩展名

curl -X POST
-H "Authorization: Bearer $TOKEN"
"https://admin.hlx.page/preview/{org}/{repo}/main/path/to/page"

3. Optional: publish to aem.live

3. 可选：发布至aem.live

curl -X POST
-H "Authorization: Bearer $TOKEN"
"https://admin.hlx.page/live/{org}/{repo}/main/path/to/page"


Image binaries upload the same way (PUT to `admin.da.live/source/...`)
but do NOT need their own preview/publish call — they're served
directly from `content.da.live` once uploaded. They DO get pulled into
Media Bus (content-addressed, with responsive variants) when a
*document* that references them is previewed — see
[references/media.md §2](./references/media.md) for the asset lifecycle.