<body id="task-2201"><main role="main"><article role="article" aria-labelledby="ariaid-title1"><h1 class="title topictitle1" id="ariaid-title1">Insert Links to  Elements in Other Topics</h1><div class="body taskbody"><div class="abstract">
        <p class="shortdesc">You can  create a direct inline link to an element in another topic by using  <span class="ph">cross-references</span>.</p>
        <div class="note remember note_remember"><span class="note__title">Remember:</span> Linking to elements in other topics is not a best practice because it forces users to leave the context they are in and jump to a different location. Instead of linking to an element in another topic, consider reusing that element to create the experience of  smooth flow of content.</div>
</div><ol class="ol steps"><li class="li step stepexpand"><span class="ph cmd">Open a topic and place your cursor where you want to insert a link.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph">Content Editor</span> toolbar, click  <span class="ph"><span class="ph uicontrol">Insert Link</span> <img class="image" src="https://heretto.deploy.heretto.com/v4/deployments/I9vA3KlK8201IYmECh5U/object/ec5b0220-8ba7-11ed-b64f-0242581fbd62?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJodHRwczovL2pvcnNlay5jb20vZXpkX29yZ2FuaXphdGlvbiI6ImpvcnNlay1kb2NzIiwiaHR0cHM6Ly9qb3JzZWsuY29tL2V6ZC9vYmplY3RfdXVpZCI6ImVjNWIwMjIwLThiYTctMTFlZC1iNjRmLTAyNDI1ODFmYmQ2MiIsImV4cCI6MTc0Njg2ODY4MCwianRpIjoiMDAwMjg4ZTU3N2QyNDI0YmEwZTNjOTBhZGIyZDQzZTAiLCJodHRwczovL2pvcnNlay5jb20vZXpkX2ZpbGVzZXQiOiIzVjl1MUswbTlCTzFJcm9xRVJldSJ9.cYh5OZ6SJ4h6sDqGBr1W3NsNMI6E6hj_gb4mmxuxvLM"></span>.</span><div class="itemgroup stepresult">
                    <p class="p">The <span class="ph"><span class="keyword wintitle">Link</span> dialog</span> opens with the <span class="ph uicontrol">A File in </span><span class="ph">Heretto</span> option selected.</p>
                </div></li><li class="li step stepexpand"><span class="ph cmd">Click  <span class="ph"><span class="ph uicontrol">Select file</span></span>.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph"><span class="keyword wintitle">Library</span> dialog</span>, select the file that contains the element that you want to link to and click the <span class="ph"><span class="ph uicontrol">Link Inside File (Select Target Element)</span> button</span>.</span></li><li class="li step stepexpand"><span class="ph cmd">Select the element you want to link to:</span><ol type="a" class="ol substeps" id="task-2201__substeps_bkv_4pr_w3b"><li class="li substep substepexpand" id="task-2201__substep_zvy_p31_v3b"><span class="ph cmd" id="task-2201__cmd_hzj_pyp_ckb">In the <span class="ph"><span class="keyword wintitle">Create/Edit Link</span> dialog</span>, click an element and select it from the list that appears.</span></li><li class="li substep substepexpand" id="task-2201__substep_tjc_cj1_v3b"><span class="ph cmd">If prompted about an element ID value, click <span class="ph"><span class="ph uicontrol">OK</span></span> and <span class="ph"><span class="ph uicontrol">Save</span></span>.</span><div class="itemgroup info">
                    <div class="note tip note_tip"><span class="note__title">Tip:</span> <p class="p"><span class="ph">Heretto CCMS</span> generates ID attribute values automatically, but you can modify them. ID attribute values must be unique. Assigning customized, meaningful values may boost consistency in your documentation.</p></div>
                        </div></li><li class="li substep substepexpand" id="task-2201__substep_fld_fj1_v3b"><span class="ph cmd">Click the <span class="ph"><span class="ph uicontrol">Insert Content</span> button</span>.</span></li></ol></li><li class="li step stepexpand"><span class="hd-label">Optional: </span><span class="ph cmd" id="task-2201__linkTextChange">Change the link text by placing your cursor in the link and entering custom text.</span><div class="itemgroup info">
    <div class="note remember note_remember"><span class="note__title">Remember:</span> <p class="p">We don't recommend customizing the link text. You need to maintain and modify custom links each time the content changes and the link text is no longer relevant. You need to do that everywhere the link is used.</p></div>
                </div></li></ol><section class="section result">You inserted a link to an element in another topic.</section></div></article></main></body>

In a map, you can indirectly link to topics by using key references. You can consider

Key References (Indirect Links)

Links to files in Heretto enable you to link to other topics or files in the Content Library. You can use this linking option to redirect users to a separate page from the original topic.

Links to files in Heretto

Create a direct, inline link to another topic or file located  in Heretto CCMS by using the  cross-reference (xref) element.

Insert Links to Topics or Files in Heretto CCMS

You can  create a direct inline link to an element in another topic by using  cross-references.

Insert Links to Elements in Other Topics

heretto-ccms/create/linking/inline-links-overview/links-to-files-in-heretto/insert-links-to-elements-in-other-topics

create/linking/inline-links-overview/links-to-files-in-heretto/insert-links-to-elements-in-other-topics

<body id="topic-8515"><main role="main"><article role="article" aria-labelledby="ariaid-title1"><h1 class="title topictitle1 hide-footer-title" id="ariaid-title1">Footer Section</h1><div class="body footer-container"><p class="shortdesc"></p><section class="section footer-item footer-links footer-full"><h2 class="title sectiontitle" id="our-support-team-is-here-to-help-0">Our Support Team is here to help</h2>
            
            <p class="p">Submit a support request or check the status of your existing requests. You can also email us.</p>
            <p class="p"><a class="xref footer-connect-button j-external-link" href="https://support.heretto.com/hc/en-us" target="_blank">Contact Support Team</a></p>
        </section><section class="section footer-bottom-container">

        <div class="div footer-item footer-links footer-bigger">
            <p class="p footer-img-left"><a class="xref j-external-link" href="https://heretto.com/" target="_blank"><img class="image footer-logo" src="https://heretto.deploy.heretto.com/v4/deployments/I9vA3KlK8201IYmECh5U/object/a69de2b0-741e-11ee-a3d9-0242d8e432a4?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJodHRwczovL2pvcnNlay5jb20vZXpkX29yZ2FuaXphdGlvbiI6ImpvcnNlay1kb2NzIiwiaHR0cHM6Ly9qb3JzZWsuY29tL2V6ZC9vYmplY3RfdXVpZCI6ImE2OWRlMmIwLTc0MWUtMTFlZS1hM2Q5LTAyNDJkOGU0MzJhNCIsImV4cCI6MTc0Njg2ODY3NiwianRpIjoiNWU2MjNjNmY5ODZiNGMyNGJlZTRhOTU0YjllYTBjODUiLCJodHRwczovL2pvcnNlay5jb20vZXpkX2ZpbGVzZXQiOiIzVjl1MUswbTlCTzFJcm9xRVJldSJ9.SO3k55yS77PmJuPoQKgFkjJvlb78UBymNg36gRbMSBU"></a></p>
            <p class="p footer-section-title">Love this help site?</p>
            <p class="p">You can have one, too! Sitting on top of the Heretto CCMS, our team can build a tailored portal that will delight your customers. Meet with our team to learn more.</p>
            <p class="p"><a class="xref footer-connect-button j-external-link" href="https://www.heretto.com/request-demo?utm_medium=direct-traffic&amp;utm_source=direct-traffic&amp;utm_campaign=demo-request&amp;utm_content=helpsite&amp;utm_term=" target="_blank">Connect with us</a></p>
        </div>
        <div class="div footer-item footer-links">
            <p class="p footer-heading">Explore</p>
            <p class="p"></p>
            <p class="p"></p>
            <p class="p"><a class="xref" href="/heretto-ccms/integrations/heretto-ccms-integrations-overview">Integrations</a></p>
            <p class="p"><a class="xref j-external-link" href="https://heretto.com/video-tutorials/" target="_blank">Video Tutorials</a></p>
            <p class="p"><a class="xref j-external-link" href="https://learningdita.com/" target="_blank">Learning DITA </a></p>
        </div>
        <div class="div footer-item footer-links">
            <p class="p footer-heading">Company</p>
            <p class="p"><a class="xref j-external-link" href="https://heretto.com/about-heretto/" target="_blank">About Us</a></p>
            <p class="p"><a class="xref j-external-link" href="https://www.heretto.com/contact" target="_blank">Contact Us</a></p>
            <p class="p"><a class="xref j-external-link" href="https://heretto.com/" target="_blank">heretto.com</a></p>
        </div>
        <div class="div footer-item footer-links">
            <p class="p footer-heading">Legalities</p>
            <p class="p"><a class="xref j-external-link" href="https://heretto.com/legal/" target="_blank">Legal</a></p>
            <p class="p"><a class="xref j-external-link" href="https://heretto.com/privacy-policy/" target="_blank">Privacy Policy</a></p>
            <p class="p"><a class="xref j-external-link" href="https://heretto.com/terms-of-use/" target="_blank">Terms of Use</a></p>
        </div>
        <div class="div footer-copyright-container">
            <div class="div copyright-left">
                <p class="p copyright-item">© 2025 Heretto Intellectual Property. All rights reserved.</p>
                <p class="p copyright-item"><a class="xref copyright-link j-external-link" href="https://heretto.com/legal/" target="_blank">Legal</a></p>
                <p class="p copyright-item"><a class="xref copyright-link j-external-link" href="https://heretto.com/privacy-policy/" target="_blank">Privacy Policy</a></p>
                <p class="p copyright-item"><a class="xref copyright-link j-external-link" href="https://heretto.com/terms-of-use/" target="_blank">Terms of Use</a></p>
                <p class="p copyright-item"><a class="xref copyright-link j-external-link" href="https://heretto.com/about-heretto/" target="_blank">About Us</a></p>
            </div>
            <div class="div copyright-right">
                <p class="p copyright-item"><a class="xref j-external-link" href="https://twitter.com/helloHeretto" target="_blank"><img class="image social-logo" src="https://heretto.deploy.heretto.com/v4/deployments/I9vA3KlK8201IYmECh5U/object/a6b402c0-741e-11ee-a3d9-0242d8e432a4?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJodHRwczovL2pvcnNlay5jb20vZXpkX29yZ2FuaXphdGlvbiI6ImpvcnNlay1kb2NzIiwiaHR0cHM6Ly9qb3JzZWsuY29tL2V6ZC9vYmplY3RfdXVpZCI6ImE2YjQwMmMwLTc0MWUtMTFlZS1hM2Q5LTAyNDJkOGU0MzJhNCIsImV4cCI6MTc0Njg2ODY3NiwianRpIjoiZjFkN2EyZGM4NTZlNGY3OGIxYjZiMzY3YTNjNmY5M2UiLCJodHRwczovL2pvcnNlay5jb20vZXpkX2ZpbGVzZXQiOiIzVjl1MUswbTlCTzFJcm9xRVJldSJ9.NzyXiuuYGPmaA6KuC1esk--rrmMG-ei7THPMRCg3LtA"></a></p>
                <p class="p copyright-item"><a class="xref j-external-link" href="https://www.linkedin.com/company/heretto/" target="_blank"><img class="image social-logo" src="https://heretto.deploy.heretto.com/v4/deployments/I9vA3KlK8201IYmECh5U/object/a6c7b1d0-741e-11ee-a3d9-0242d8e432a4?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJodHRwczovL2pvcnNlay5jb20vZXpkX29yZ2FuaXphdGlvbiI6ImpvcnNlay1kb2NzIiwiaHR0cHM6Ly9qb3JzZWsuY29tL2V6ZC9vYmplY3RfdXVpZCI6ImE2YzdiMWQwLTc0MWUtMTFlZS1hM2Q5LTAyNDJkOGU0MzJhNCIsImV4cCI6MTc0Njg2ODY3NiwianRpIjoiODQwYTQ3MThiMTZjNGQ2MjgwZTZlNWJmMzhkY2QxMjEiLCJodHRwczovL2pvcnNlay5jb20vZXpkX2ZpbGVzZXQiOiIzVjl1MUswbTlCTzFJcm9xRVJldSJ9.I1xlJF1MZfmAty_7wnaPpCOf8rMNsCmoOyATTxoG1W8"></a></p>
            </div>
        </div>

</section></div></article></main></body>

Footer Section

<i18n-message>[MISSING CONTENT]</i18n-message>

Etto, the Heretto Copilot, is a generative Artificial Intelligence (AI) tool built for Heretto CCMS. The goal of Etto is to help you create quality structured content in the DITA XML standard, boost productivity by assisting with time-consuming tasks, and improve overall content consistency.

Etto, the Heretto Copilot Overview

<body class="page-break-after" id="concept-925"><main role="main"><article role="article" aria-labelledby="ariaid-title1"><h1 class="title topictitle1" id="ariaid-title1">Overview</h1><div class="body conbody"><div class="abstract">
        <div class="note note note_note"><span class="note__title">Note:</span> If you are looking for information about how to publish API specifications to <span class="ph">Heretto Portal</span>, see <a class="xref" href="/heretto-portal/heretto-portal-api-docs#concept-603">Heretto Portal API Docs</a>.</div>
        <div class="note important note_important"><span class="note__title">Important:</span> 
            <p class="p"><span class="ph">Heretto Deploy API</span> is undergoing a major architectural redesign and upgrade that enhances its performance, usability, and scalability. The first building blocks for this next generation (v4) of <span class="ph">Heretto Deploy API</span> are being rolled out, with the current focus on manual deployments. This content will be updated as the building blocks of the next generation <span class="ph">Deploy API</span> are rolled out. </p>
        </div>
        <p class="shortdesc"><span class="ph">Heretto Deploy API</span> is the crucial content delivery service that processes content from <span class="ph">Heretto CCMS</span> and transforms it into formats that can be delivered to end-users. The processed content is then delivered through the <span class="ph">Heretto Portal</span> or other delivery endpoints such as websites, applications, devices, or machines.</p>
    </div><p class="p">As an example, the documentation you are currently reading was delivered to this help site with <span class="ph">Deploy API</span>. Our help site is powered by both <span class="ph">Deploy API</span> and <span class="ph">Heretto Portal</span>.</p><div class="p"><span class="ph">Deploy API</span> supports: <ul class="ul"><li class="li">
                    <p class="p">Delivering localized content</p>
                </li><li class="li">
                    <p class="p">Managing access through authentication</p>
                </li><li class="li">
                    <p class="p">Tailoring content to different audiences (personalization)</p>
                </li></ul></div><p class="p">Key <span class="ph">Deploy API</span> use cases:</p><dl class="dl"><dt class="dt dlterm">Building Websites</dt><dd class="dd">
            <p class="p">Transform your <span class="ph">Heretto CCMS</span> content into complete websites such as knowledge bases, support portals, or documentation hubs. Customize branding and design elements to maintain visual consistency with your existing web properties.</p>
        </dd><dt class="dt dlterm">Embedding Content</dt><dd class="dd">
            <p class="p">Integrate content from <span class="ph">Heretto CCMS</span> directly into existing websites or applications. This enables context-sensitive help, in-app documentation, or targeted information delivery within your digital products.</p>
            
        </dd><dt class="dt dlterm">Distributing to Multiple Endpoints</dt><dd class="dd">
            <p class="p">Deploy your DITA source content to diverse delivery channels including IoT devices, embedded systems, and custom applications using <span class="ph">Deploy API</span>. This ensures consistent information across all customer touchpoints.</p>
        </dd></dl><p class="p">This single-source publishing approach ensures content consistency while reducing maintenance overhead. When you update content in <span class="ph">Heretto CCMS</span>, you can easily deliver them to all channels, typically significantly reducing publishing time compared to traditional multi-channel publishing workflows.</p></div></article></main></body>

Heretto Deploy API ensures that your content is processed in a secure way and delivered to the defined users. This information explains our authentication and security.

Authentication and Security

Read the Deploy API specification and related resources

Heretto Deploy API

FAQs

Heretto Deploy API is the crucial content delivery service that processes content from Heretto CCMS and transforms it into formats that can be delivered to end-users. The processed content is then delivered through the Heretto Portal or other delivery endpoints such as websites, applications, devices, or machines.

Deploy API Overview

Use Heretto API Docs to publish API documentation for public and internal consumption within Heretto Portal.

API Docs Overview

<body id="topic-9225"><main role="main"><article role="article" aria-labelledby="ariaid-title1"><h1 class="title topictitle1" id="ariaid-title1">Heretto Deploy Portal Overview</h1><div class="body"><p class="shortdesc"></p><iframe class="object iframe" controls="controls" src="https://www.youtube.com/embed/45CFJ3YhByI?list=PL4ZeW5ujwMiG-qroejPZ7DDYRf-potbdf" referrerpolicy="strict-origin-when-cross-origin" allowtransparency="true" frameborder="0" scrolling="no" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true" oallowfullscreen="true" msallowfullscreen="true" width="100%" height="270"></iframe><section class="section"><h2 class="title sectiontitle" id="heretto-deploy-portal-overview-0">Heretto Deploy Portal Overview</h2>
            
            <p class="p">Real-time content delivery anywhere</p>
        </section></div></article></main></body>

Heretto Deploy Portal Overview

<body id="topic-2626"><main role="main"><article role="article" aria-labelledby="ariaid-title1"><h1 class="title topictitle1" id="ariaid-title1">Heretto UX Overview</h1><div class="body"><p class="shortdesc"></p><iframe class="object iframe" controls="controls" src="https://www.youtube.com/embed/qJNtVI2cKTA" referrerpolicy="strict-origin-when-cross-origin" allowtransparency="true" frameborder="0" scrolling="no" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true" oallowfullscreen="true" msallowfullscreen="true" width="100%" height="270"></iframe><section class="section"><h2 class="title sectiontitle" id="heretto-ux-overview-0">Heretto UX Overview</h2>
            
            <p class="p"><a class="xref external-video-link j-external-link" href="https://heretto.com/product-pulse/" target="_blank">View more videos</a></p>
        </section></div></article></main></body>

Heretto UX Overview

A fix to an edge case related to merging files from a release to a branch.

April 29, 2025

Access XML Details of a Referenced SVG File

Access XML Details of a Referenced Topic

Include Draft-comment Content in Output

Create a Variable Image on the Cover Page

<body id="concept-2615"><main role="main"><article role="article" aria-labelledby="ariaid-title1"><h1 class="title topictitle1" id="ariaid-title1">Advanced XSL Transformations</h1><div class="body conbody"><p class="shortdesc">You can use advanced XSL to perform complex transformations in <span class="ph">PDF Generator</span> outputs. When planning to use advanced XSLT in your <span class="ph">PDF Generator</span> scenarios, consider this important information.</p><section class="section"><h2 class="title sectiontitle" id="important-considerations-0">Important Considerations</h2><ul class="ul"><li class="li"><p class="p">We recommend that users experienced with advanced XSL complete these procedures.</p></li><li class="li"><p class="p">You need to be  assigned the <span class="ph">Administrator</span> role in <span class="ph">Heretto CCMS</span> to modify <span class="ph">PDF Generator</span>  publishing scenarios.</p></li><li class="li"><p class="p"><span class="ph">PDF Generator</span> uses an API call that calls the resource UUID. The path to a resource is <code class="ph codeph"><var class="keyword varname">UUID</var>.<var class="keyword varname">file-extension</var></code>. For example, <code class="ph codeph">33573366-bfc8-445c-8322-203d83bbc1mr.svg</code>.</p></li><li class="li"><p class="p">You need to add namespaces to your XSLT stylesheets. Add  <code class="ph codeph">xs:preservens="true"</code> as presented here: </p><pre class="pre codeblock lang-xsl"><code>&lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"    xmlns:xs="http://www.w3.org/2001/XMLSchema" xs:preservens="true" exclude-result-prefixes="opentopic" version="2.0"&gt;</code></pre><pre class="pre codeblock lang-xsl"><code>xmlns:xs="http://www.w3.org/2001/XMLSchema"
xs:preservens="true"</code></pre></li></ul></section></div><article class="topic task nested1" aria-labelledby="ariaid-title2" id="task-8341"><h2 class="title topictitle2" id="ariaid-title2">Access XML Details of a Referenced SVG File</h2><div class="body taskbody"><div class="abstract"><span class="shortdesc">You can use XSLT to access XML details of an SVG file referenced in topic and use that information in the <span class="ph">PDF Generator</span> output transformation. This procedure can be completed only by users assigned the <span class="ph">Administrator</span> role in <span class="ph">Heretto CCMS</span>. </span></div><section class="section context"><p class="p">This procedure does not explain how to access details of annotated images with XSLT. It explains how to access details of images saved to the <span class="ph filepath">.svg</span> format, uploaded to <span class="ph">Heretto CCMS</span>, and added to a topic in a figure element (<code class="ph codeph">fig</code>) or image element (<code class="ph codeph">image</code>).</p></section><ol class="ol steps"><li class="li step stepexpand"><span class="ph cmd" id="task-8341__cmd_lzt_kpc_vkb">In the top-left corner, click the <span class="ph"><span class="keyword wintitle">Main Menu</span> <img class="image" src="https://heretto.deploy.heretto.com/v4/deployments/I9vA3KlK8201IYmECh5U/object/4d399120-0470-11ed-844a-02428d90e38c?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJodHRwczovL2pvcnNlay5jb20vZXpkX29yZ2FuaXphdGlvbiI6ImpvcnNlay1kb2NzIiwiaHR0cHM6Ly9qb3JzZWsuY29tL2V6ZC9vYmplY3RfdXVpZCI6IjRkMzk5MTIwLTA0NzAtMTFlZC04NDRhLTAyNDI4ZDkwZTM4YyIsImV4cCI6MTc0Njg2ODY3NiwianRpIjoiOWNmZmQ4NjQ0N2MzNGRlYjllYzIyMjMwYzA3MzNlY2YiLCJodHRwczovL2pvcnNlay5jb20vZXpkX2ZpbGVzZXQiOiIzVjl1MUswbTlCTzFJcm9xRVJldSJ9.nSbNhATj-n9f1jo9sSF4P973z3dGKUnBCAv4aVJBAR4"></span> and go to <span class="ph uicontrol">PDF
                    Generator</span>.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph"><span class="keyword wintitle">PDF Generator scenarios</span> screen</span>, click the publishing scenario you want to edit.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph"><span class="keyword wintitle">XSLT</span> tab</span>, add this code:</span><div class="itemgroup info"><pre class="pre codeblock lang-xsl"><code>&lt;xsl:if test="contains(@href, '.svg')"&gt;
    &lt;xsl:attribute name="width" select="document(@href)//*[local-name()='svg']/@width"/&gt;
&lt;/xsl:if&gt;</code></pre><p class="p">This code is an example of accessing the width attribute of an SVG file. </p>
                    
                </div></li><li class="li step stepexpand"><span class="ph cmd">Modify the code to call the desired SVG detail. </span></li><li class="li step stepexpand"><span class="ph cmd">Click <span class="ph uicontrol">Save Scenario</span> and verify your changes by publishing test content with the scenario you modified.</span></li></ol></div></article><article class="topic task nested1" aria-labelledby="ariaid-title3" id="task-700"><h2 class="title topictitle2" id="ariaid-title3">Access XML Details of a Referenced Topic</h2><div class="body taskbody"><p class="shortdesc">You can use XSLT to access XML details of a topic that is referenced by a different topic and use that information in the <span class="ph">PDF Generator</span> output transformation. This procedure can be completed only by users assigned the <span class="ph">Administrator</span> role in <span class="ph">Heretto CCMS</span>.</p><div class="section prereq p">
            <p class="p">Ensure the cross-reference (<code class="ph codeph">xref</code>) that links the topic whose details you want to access has <code class="ph codeph">scope="local"</code> set. For example, <code class="ph codeph">&lt;xref href="topic.dita" scope="local"&gt;&lt;/xref&gt;</code>.</p>
        </div><ol class="ol steps"><li class="li step stepexpand"><span class="ph cmd" id="task-700__cmd_lzt_kpc_vkb">In the top-left corner, click the <span class="ph"><span class="keyword wintitle">Main Menu</span> <img class="image" src="https://heretto.deploy.heretto.com/v4/deployments/I9vA3KlK8201IYmECh5U/object/4d399120-0470-11ed-844a-02428d90e38c?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJodHRwczovL2pvcnNlay5jb20vZXpkX29yZ2FuaXphdGlvbiI6ImpvcnNlay1kb2NzIiwiaHR0cHM6Ly9qb3JzZWsuY29tL2V6ZC9vYmplY3RfdXVpZCI6IjRkMzk5MTIwLTA0NzAtMTFlZC04NDRhLTAyNDI4ZDkwZTM4YyIsImV4cCI6MTc0Njg2ODY3NiwianRpIjoiNjZlYzRhMzMwZWU0NGVjMjhiYzQ5ODgxYTc0MDFmY2YiLCJodHRwczovL2pvcnNlay5jb20vZXpkX2ZpbGVzZXQiOiIzVjl1MUswbTlCTzFJcm9xRVJldSJ9.8maz-8MMev9VU7-habarASYAc1XmkZMvplyl7Lbu9m4"></span> and go to <span class="ph uicontrol">PDF
                    Generator</span>.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph"><span class="keyword wintitle">PDF Generator scenarios</span> screen</span>, click the publishing scenario you want to edit.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph"><span class="keyword wintitle">XSLT</span> tab</span>, add this code:</span><div class="itemgroup info">
                    <div class="note important note_important"><span class="note__title">Important:</span> Before passing that attribute to the <code class="ph codeph">document()</code> function, it must be  prefixed with <code class="ph codeph">no-doctype:</code> to remove the <code class="ph codeph">&lt;!DOCTYPE&gt;</code> element from processing.</div><pre class="pre codeblock lang-xsl"><code>&lt;xsl:template match="*[contains(@class, ' topic/xref ')]" name="topic.xref"&gt;
        &lt;xsl:choose&gt;
            &lt;xsl:when test="@file-uuid and normalize-space(@file-uuid)"&gt;
                &lt;xsl:variable name="prefixedFileUuid" select="concat('no-doctype:', @file-uuid)"/&gt;
                &lt;xsl:comment&gt;
                    &lt;xsl:value-of select="$prefixedFileUuid"/&gt;
                &lt;/xsl:comment&gt;
                &lt;a&gt;
                    &lt;xsl:attribute name="title"&gt;
                        &lt;xsl:value-of select="document($prefixedFileUuid)//title"/&gt;
                    &lt;/xsl:attribute&gt;
                &lt;/a&gt;
            &lt;/xsl:when&gt;
            &lt;xsl:otherwise&gt;
                &lt;span&gt;
                    Not able to retrieve title from Document 
                &lt;/span&gt;
            &lt;/xsl:otherwise&gt;
        &lt;/xsl:choose&gt;        
    &lt;/xsl:template&gt;</code></pre><p class="p">This code looks for the <code class="ph codeph">file-uuid</code> attribute. </p>
                </div></li><li class="li step stepexpand"><span class="ph cmd">Modify the code to call for the desired topic detail. </span></li><li class="li step stepexpand"><span class="ph cmd">Click <span class="ph uicontrol">Save Scenario</span> and verify your changes by publishing test content with the scenario you modified.</span></li></ol></div></article><article class="topic task nested1" aria-labelledby="ariaid-title4" id="task-7442"><h2 class="title topictitle2" id="ariaid-title4">Include Draft-comment Content in Output</h2><div class="body taskbody"><p class="shortdesc">By default, content added within the <code class="ph codeph">draft-comment</code> element is excluded from outputs. However, you can use XSLT to ensure that a <span class="ph">PDF Generator</span> scenario includes it. This procedure can be completed only by users assigned the <span class="ph">Administrator</span> role in <span class="ph">Heretto CCMS</span>.</p><ol class="ol steps"><li class="li step stepexpand"><span class="ph cmd" id="task-7442__cmd_lzt_kpc_vkb">In the top-left corner, click the <span class="ph"><span class="keyword wintitle">Main Menu</span> <img class="image" src="https://heretto.deploy.heretto.com/v4/deployments/I9vA3KlK8201IYmECh5U/object/4d399120-0470-11ed-844a-02428d90e38c?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJodHRwczovL2pvcnNlay5jb20vZXpkX29yZ2FuaXphdGlvbiI6ImpvcnNlay1kb2NzIiwiaHR0cHM6Ly9qb3JzZWsuY29tL2V6ZC9vYmplY3RfdXVpZCI6IjRkMzk5MTIwLTA0NzAtMTFlZC04NDRhLTAyNDI4ZDkwZTM4YyIsImV4cCI6MTc0Njg2ODY3NiwianRpIjoiMGE2NjhlMTU2YzUyNGNlNzljNDExZDExNmYwZjc3OTMiLCJodHRwczovL2pvcnNlay5jb20vZXpkX2ZpbGVzZXQiOiIzVjl1MUswbTlCTzFJcm9xRVJldSJ9.B_7oGfZnfp8GuqyV9yQs0e92QSGc8BKkZUtAoFF3dBY"></span> and go to <span class="ph uicontrol">PDF
                    Generator</span>.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph"><span class="keyword wintitle">PDF Generator scenarios</span> screen</span>, click the publishing scenario you want to edit.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph"><span class="keyword wintitle">XSLT</span> tab</span>, add this code:</span><div class="itemgroup info">
                    <pre class="pre codeblock lang-xsl"><code>&lt;xsl:param name="DRAFT" select="'yes'"/&gt;</code></pre>
                </div></li><li class="li step stepexpand"><span class="ph cmd">Click <span class="ph uicontrol">Save Scenario</span> and verify your changes by publishing test content with the scenario you modified.</span></li></ol></div></article><article class="topic task nested1" aria-labelledby="ariaid-title5" id="task-9914"><h2 class="title topictitle2" id="ariaid-title5">Create a Variable Image on the Cover Page</h2><div class="body taskbody"><div class="abstract"><p class="shortdesc">You can use a combination of DITAVAL files and XSLT code to control the images that print on a PDF cover. By doing so, instead of creating unique publishing scenarios for each product, you can use one <span class="ph">PDF Generator</span> publishing scenario to print different images on PDF covers. </p><p class="p">Portions of this procedure can be completed only by users assigned the <span class="ph">Administrator</span> role in <span class="ph">Heretto CCMS</span>.</p></div><div class="section prereq p">
            <p class="p">You should have:</p>
            <ul class="ul"><li class="li">A working PDF Generator scenario</li><li class="li">A map that you've created for publishing</li><li class="li">Images to print on the PDF cover</li></ul>
        </div><div class="li stepsection">
                <p class="p">Create a <span class="ph">DITAVAL</span> file that identifies the product category</p>
            </div><ol class="ol steps"><li class="li step stepexpand"><span class="ph cmd">Create a new <span class="ph">DITAVAL</span> file named <span class="ph filepath"><var class="keyword varname">product_name_1</var>.ditaval</span>, where <var class="keyword varname">product_name_1</var> is the name of one of your products.</span><div class="itemgroup info">
                    <div class="note tip note_tip"><span class="note__title">Tip:</span> Create a <span class="ph">DITAVAL</span> for each product for which you want a different cover page image.</div>
                </div></li><li class="li step stepexpand"><span class="ph cmd">Set up the <span class="ph">DITAVAL</span> to include <var class="keyword varname">product_name_1</var> and exclude all other products. </span><div class="itemgroup stepxmp">
                    <p class="p">An example of a <span class="ph">DITAVAL</span> source code that includes <var class="keyword varname">product_name_1</var> and excludes <var class="keyword varname">product_name_2</var>:</p>
                    <pre class="pre codeblock lang-xml" id="task-9914__codeblock_vvs_kkk_ntb"><code>&lt;val&gt;
    &lt;prop action="include" att="product" val="product_name_1"/&gt;
    &lt;prop action="exclude" att="product" val="product_name_2"/&gt;
&lt;/val&gt;</code></pre>
                    <div class="note important note_important"><span class="note__title">Important:</span> If you copy-paste this example, replace the <span class="keyword parmname">val</span> attribute values <code class="ph codeph">product_name_1</code> and <code class="ph codeph">product_name_2</code> with the applicable product values. </div>
                </div></li></ol><div class="li stepsection">
                <p class="p">Add XSLT code to a <span class="ph">PDF Generator</span> scenario (Administrators only)</p>
            </div><ol class="ol steps" start="3"><li class="li step stepexpand"><span class="ph cmd" id="task-9914__cmd_lzt_kpc_vkb">In the top-left corner, click the <span class="ph"><span class="keyword wintitle">Main Menu</span> <img class="image" src="https://heretto.deploy.heretto.com/v4/deployments/I9vA3KlK8201IYmECh5U/object/4d399120-0470-11ed-844a-02428d90e38c?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJodHRwczovL2pvcnNlay5jb20vZXpkX29yZ2FuaXphdGlvbiI6ImpvcnNlay1kb2NzIiwiaHR0cHM6Ly9qb3JzZWsuY29tL2V6ZC9vYmplY3RfdXVpZCI6IjRkMzk5MTIwLTA0NzAtMTFlZC04NDRhLTAyNDI4ZDkwZTM4YyIsImV4cCI6MTc0Njg2ODY3NiwianRpIjoiNDJlMmUzYzU0ODQ4NDFiZGE3NGFlYWQ2MDI4ODdhOWUiLCJodHRwczovL2pvcnNlay5jb20vZXpkX2ZpbGVzZXQiOiIzVjl1MUswbTlCTzFJcm9xRVJldSJ9.dSZlJ5i3gsCCaqIjcBjA8oCcyIdFDqvbCYXChhy2Lck"></span> and go to <span class="ph uicontrol">PDF
                    Generator</span>.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph"><span class="keyword wintitle">PDF Generator scenarios</span> screen</span>, click the publishing scenario you want to edit.</span></li><li class="li step stepexpand"><span class="ph cmd">In the <span class="ph"><span class="keyword wintitle">XSLT</span> tab</span>  of your <span class="ph">PDF Generator</span> scenario, add this XSLT code.</span><div class="itemgroup info">
                    <pre class="pre codeblock lang-xsl" id="task-9914__codeblock_pcm_dlk_ntb"><code>&lt;div class="cover-image"&gt;
  &lt;img&gt;
    &lt;xsl:attribute name="src" select="/normalized/map/topicmeta/data/image/@href"/&gt;
  &lt;/img&gt;
&lt;/div&gt;</code></pre>
                </div></li><li class="li step stepexpand"><span class="ph cmd">Click <span class="ph uicontrol">Save Scenario</span>.</span></li></ol><div class="li stepsection">
                <p class="p">Add image files to your map</p>
            </div><ol class="ol steps" start="7"><li class="li step stepexpand"><span class="ph cmd">Add this <code class="ph codeph">topicmeta</code> element to the root element of your DITA map.</span><div class="itemgroup info">
                    <pre class="pre codeblock lang-xml" id="task-9914__codeblock_dzl_hlk_ntb"><code>&lt;map id="ditamap-4870"&gt;
    &lt;title&gt;Map Title&lt;/title&gt;
    &lt;topicmeta&gt;
        &lt;data product="product_name_1"&gt;&lt;image href="../_global_shared/media/logos/LOGO1.png"/&gt;&lt;/data&gt;
        &lt;data product="product_name_2"&gt;&lt;image href="../_global_shared/media/logos/LOGO2.png"/&gt;&lt;/data&gt;
    &lt;/topicmeta&gt;
&lt;/map&gt;</code></pre>
                </div></li><li class="li step stepexpand"><span class="ph cmd">Replace the <code class="ph codeph">product</code> attribute values <code class="ph codeph">product_name_1</code> and <code class="ph codeph">product_name_2</code> with with the applicable product values.</span></li><li class="li step stepexpand"><span class="ph cmd">Modify the image <code class="ph codeph">href</code> attributes to link to your variable images in <span class="ph">Heretto CCMS</span>.</span></li></ol><div class="li stepsection">
                <p class="p">Publish content</p>
            </div><ol class="ol steps" start="10"><li class="li step stepexpand"><span class="ph cmd">Publish your map with the <span class="ph">PDF Generator</span> publishing scenario you modified and a DITAVAL file you created. </span></li></ol></div></article></article></main></body>

heretto-ccms/publish/pdf-generator/pdf-generator-templates-development-guide/heretto-pdf-generator-templates-development/developing-templates/develop-a-pdf-generator-template-in-heretto-ccms

Developing Templates

You customize the Heretto PDF Generator template
            style by using CSS. You can also use HTML to modify the cover page and XSLT to apply
            advanced structural customizations.

Heretto PDF Generator Templates Development

In Heretto CCMS, you can add annotations, for example, callouts to images. Annotations can be globally styled in PDF Generator publishing scenarios according to your branding
        needs.

Styling Annotated Images

You can use advanced XSL to perform complex transformations in PDF Generator outputs. When planning to use advanced XSLT in your PDF Generator scenarios, consider this important information.

Advanced XSL Transformations

You can overwrite the default robots.txt settings by adding new settings in the main config.json file associated with your main portal sitemap.

Configure Web Crawler Settings

Content Operations Platform For Knowledge Management | Heretto

Learn how to author, review, manage, translate, and publish to multiple channels

Heretto CCMS

Learn how to dynamically distribute your content to any audience, anytime

Heretto Portal

Learn what has changed in Heretto products

Release Notes

Heretto Component Content Management System (CCMS) is one platform to create, manage, and personalize enterprise knowledge for any audience, on any channel, in any language.

Heretto CCMS Overview

Get Started

Inline links enable you to insert links to other content in line
                with text in a topic.

Gretyl's Portal

Heretto Help

Insert Links to Elements in Other Topics

Footer Section

Our Support Team is here to help