How to add a Tweet Button in WebHelp Responsive output using a publishing template

It is possible to integrate Twitter into your WebHelp Responsive output and you can specify where you want the widget to appear in your WebHelp page.

To add a Twitter™ Tweet widget to your WebHelp Responsive output using an oXygen Publishing Template, follow this procedure:

  1. Go to the Tweet button generator page.
  2. Fill-in the displayed form. The Preview and code area displays the code that you will need.
  3. Copy the code snippet displayed in the Preview and code area and paste it into a div element inside an XML file called tweet-button.xml. Make sure you follow these rules:
    • The file must be well-formed.
    • The code for each script element must be included in an XML comment.
    • The start and end tags for the XML comment must be on a separate line.
    The content of the XML file should look like this:
    <div id="twitter">
      <a href="https://twitter.com/share" class="twitter-share-button">Tweet</a>
      <script>
      <!-- 
       !function (d, s, id) {
       var
       js, fjs = d.getElementsByTagName(s)[0], p = /^http:/.test(d.location)
    ? 'http': 'https';
       if (! d.getElementById(id)) {
       js = d.createElement(s);
       js.id = id;
       js.src = p + '://platform.twitter.com/widgets.js';
       fjs.parentNode.insertBefore(js, fjs);
       }
       }
       (document,
       'script', 'twitter-wjs');
      -->
    </script>
    </div>
  4. Open the template descriptor file associated with your publishing template.
  5. Use one of the parameters that begin with webhelp.fragment in the html-fragments section of the descriptor file. Set the value of that parameter to reference the tweet-button.xml file that you created earlier.
    <publishing-template>
        ...
        <webhelp>
            ...                
          <html-fragments>
            <fragment 
             file="HTML-fragments/tweet-button.xml" 
             placeholder="webhelp.fragment.after.toc_or_tiles"/>
      </html-fragments>
    </webhelp>
  6. Open the DITA Map WebHelp Responsive transformation scenario.
  7. Click the Choose Custom Publishing Template link and select your template.
  8. Click OK to save the changes to the transformation scenario.
  9. Run the transformation scenario.