dita-conref-push
Audit DITA conref push (conaction) — validate pushbefore/pushafter/pushreplace operations, their mark-sibling pairing, and that the push targets resolve. Use when asked to check conref-push operations, debug content that isn't being pushed into a target, or before publishing content that uses conaction.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-20
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- dita-conref-push
- description
- Audit DITA conref push (conaction) — validate pushbefore/pushafter/pushreplace operations, their mark-sibling pairing, and that the push targets resolve. Use when asked to check conref-push operations, debug content that isn't being pushed into a target, or before publishing content that uses conaction.
03 SKILL.md 正文
DITA conref push (conaction)
Conref push is the inverse of conref pull: instead of a topic pulling shared content
in, a source pushes its content into a target it references. @conaction drives it,
and DITA-OT resolves it late (at build), so problems are easy to miss. The tool:
conref_push_audit (inventory + pairing + target resolution).
The pairing rules (what the audit checks)
- pushbefore / pushafter — needs a sibling element with
conaction="mark"that carries the@conref/@conkeyrefidentifying where to push. A push with no mark sibling pushes nowhere. - mark — needs a
pushbefore/pushaftersibling; a mark with nothing to push is inert. - pushreplace — carries its own
@conref/@conkeyrefto the element it replaces; no separate mark. - The push target (
@conreffile#topic/id, or@conkeyrefkey/id) must resolve to a real element — broken targets silently drop the push.
Process
- Audit —
conref_push_audit <root> --root-map <map>(the map resolvesconkeyrefkeys): the inventory of mark/pushbefore/pushafter/pushreplace, broken pairing, and unresolvable targets. - Fix pairing — add the missing
mark(with the target@conref) for an orphan push, or the missing push for an orphan mark; give apushreplaceits target. - Fix targets — correct the
@conrefpath/id or the@conkeyrefkey so it points at a real element in a real file (the audit names the missing id). - Verify with the engine — conref push only materializes at build; after fixing,
validate_deep(DITA-OT) confirms the pushed content lands where intended.
Report
The push operations found, the pairing/target problems and how each was fixed, and a note to deep-validate. Conref push is reuse — for the pull side and warehousing, see [[dita-conref-reuse]] and [[dita-conref-audit]].
04 同仓库更多 Skills
valid-skill
A valid test skill for unit testing.
wrong-name
Name does not match directory.
missing-description
暂无简介
hidden-skill
A skill hidden from model invocation.
dita-subject-schemes
Author or repair a DITA subjectScheme that governs conditional-processing attribute values (@platform, @audience, @product, @props, @otherprops), then validate content against it. Use when introducing controlled values, governing conditional content, or when validate_conditions reports controlled-value violations.
dita-shortdesc
Write SEO-friendly DITA shortdescs and abstracts — a standalone one-sentence summary that doubles as the link preview and the HTML meta description. Use when asked to add or improve a topic's description/abstract, write shortdescs, fill missing ones, or make descriptions SEO-friendly.