| 1 | <?xml version="1.0" encoding="UTF-8"?>
|
|---|
| 2 | <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
|
|---|
| 3 | "concept.dtd">
|
|---|
| 4 | <concept id="preprocess-topicpull" xml:lang="en-us">
|
|---|
| 5 | <title>Pull content into topics (topicpull)</title>
|
|---|
| 6 | <shortdesc>The <codeph>topicpull</codeph> step pulls content into <xref> and <link> elements.
|
|---|
| 7 | This step is implemented in XSLT.</shortdesc>
|
|---|
| 8 | <conbody>
|
|---|
| 9 | <section><p>If an <xref> element does not contain link text, the target is examined and the link text is
|
|---|
| 10 | pulled. For example, a reference to a topic pulls the title of the topic; a reference to a list item
|
|---|
| 11 | pulls the number of the item. If the <xref> element references a topic that has a short
|
|---|
| 12 | description, and the <xref> element does not already contain a child <desc> element, a
|
|---|
| 13 | <desc> element is created that contains the text from the topic short description.</p><p>The process is similar for <link> elements. If the <link> element does not have a child
|
|---|
| 14 | <linktext> element, one is created with the appropriate link text. Similarly, if the <link>
|
|---|
| 15 | element does not have a child <desc> element, and the short description of the target can be
|
|---|
| 16 | determined, a <desc> element is created that contains the text from the topic short
|
|---|
| 17 | description.</p></section>
|
|---|
| 18 | </conbody>
|
|---|
| 19 | </concept>
|
|---|
