<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>About oXygen XML Editor</title>
</head>
<body>
<style type="text/css">
h1 a:hover {background-color:#888;color:#fff ! important;}
div#emailbody table#itemcontentlist tr td div ul {
list-style-type:square;
padding-left:1em;
}
div#emailbody table#itemcontentlist tr td div blockquote {
padding-left:6px;
border-left: 6px solid #dadada;
margin-left:1em;
}
div#emailbody table#itemcontentlist tr td div li {
margin-bottom:1em;
margin-left:1em;
}
table#itemcontentlist tr td a:link, table#itemcontentlist tr td a:visited, table#itemcontentlist tr td a:active, ul#summarylist li a {
color:#000099;
font-weight:bold;
text-decoration:none;
}
img {border:none;}
</style>
<div xmlns="http://www.w3.org/1999/xhtml" id="emailbody" style="margin:0 2em;font-family:Georgia,Helvetica,Arial,Sans-Serif;line-height:140%;font-size:13px;color:#000000;">
<table style="border:0;padding:0;margin:0;width:100%">
<tr>
<td style="vertical-align:top" width="99%">
<h1 style="margin:0;padding-bottom:6px;">
<a style="color:#888;font-size:22px;font-family:Arial,Helvetica,Sans-Serif;font-weight:normal;text-decoration:none;" href="http://blog.oxygenxml.com/" title="(http://blog.oxygenxml.com/)">About oXygen XML Editor</a>
</h1>
</td>
<td width="1%" />
</tr>
</table>
<hr style="border:1px solid #ccc;padding:0;margin:0" />
<table id="itemcontentlist">
<tr xmlns="">
<td style="margin-bottom:0;line-height:1.4em;">
<p style="margin:1em 0 3px 0;">
<a name="1" style="font-family:Arial,Helvetica,Sans-Serif;font-size:18px;" href="http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/CruPt7osXjg/document-type-extension-sharing.html?utm_source=feedburner&utm_medium=email">Document Type Extension Sharing</a>
</p>
<p style="font-size:13px;color:#555;margin:9px 0 3px 0;font-family:Georgia,Helvetica,Arial,Sans-Serif;line-height:140%;font-size:13px;">
<span>Posted:</span> 12 Aug 2015 04:41 AM PDT</p>
<div style="margin:0;font-family:Georgia,Helvetica,Arial,Sans-Serif;line-height:140%;font-size:13px;color:#000000;"><div class="body"> <p class="p">You can extend a default bundled document type (like <strong class="ph b">DITA</strong> or <strong class="ph b">Docbook</strong>) in the <span class="ph uicontrol">Document Type Association</span> preferences page, make modifications and then share the extension with your team. </p> <div class="p">The steps below describe how an extension of the <strong class="ph b">DITA</strong> framework which removes certain elements from the content completion list can be constructed and shared:<ol class="ol" id="author-document-type-sharing__ol_om1_xzp_zs"> <li class="li">Create somewhere on your disk, in a place where you have full write access a folder structure like: <span class="ph filepath">custom_frameworks/dita-extension</span>. </li> <li class="li">In the <span class="ph uicontrol">Document Type Association / Locations</span> preferences page add in your <span class="ph uicontrol">Additional frameworks directories</span> list the path to your <span class="ph filepath">custom_frameworks</span> folder.</li> <li class="li">In the <span class="ph uicontrol">Document Type Association</span> preferences page select the <span class="ph uicontrol">DITA</span> document type configuration and use the <span class="ph uicontrol">Extend</span> button to create an extension for it.</li> <li class="li">Give a custom name to the extension, for example <span class="ph uicontrol">DITA - Custom</span> and then change its <span class="ph uicontrol">Storage</span> to external, then save it to a path like: <span class="ph filepath">path/to/.../custom_frameworks/dita-extension/dita-extension.framework</span>.</li> <li class="li">Make changes to the extension, for example go to the <span class="ph uicontrol">Author->Content completion</span> tab and add in the <span class="ph uicontrol">Filter - Remove content completion items</span> list elements which should not be presented to the end users.</li> <li class="li">Click <span class="ph uicontrol">OK</span> to close the dialog and then either <span class="ph uicontrol">OK</span> or <span class="ph uicontrol">Apply</span> to save the preferences changes.</li> </ol></div> <p class="p">After you perform the steps above you will have in the <span class="ph filepath">dita-extension</span> folder a fully functioning framework which can be shared with others.</p> <div class="p">The framework can then be shared with others in several ways:<ul class="ul" id="author-document-type-sharing__ul_nsg_zbq_zs"> <li class="li">Copy it to their <span class="ph filepath">[OXYGEN_DIR]/frameworks</span> directory. </li> <li class="li">Create somewhere on disk a <span class="ph filepath">custom_frameworks</span> folder, copy the framework there and then from the <span class="ph uicontrol">Document Type Association / Locations</span> preferences page add in your <span class="ph uicontrol">Additional frameworks directories</span> list the path to the <span class="ph filepath">custom_frameworks</span> folder.</li> <li class="li"> <p class="p">Distribute the framework along with a project.</p> <div class="p"> Follow these steps:<ol class="ol" id="author-document-type-sharing__ol_h4n_vpi_5m"> <li class="li">On your local drive, create a directory with full write access, containing the project files and a <span class="ph filepath">custom_frameworks</span> folder containing your <span class="ph filepath">dita-extension</span>.</li> <li class="li">Start the application, go to the <a class="xref" href="http://www.oxygenxml.com/doc/versions/17.0/ug-editor/#topics/using-the-project-view.html" target="_blank"><span class="ph uicontrol">Project</span> view</a> and create a project. Save it in the newly created directory.</li> <li class="li">In the <span class="ph uicontrol">Document Type Association / Locations</span> preferences page, select <strong class="ph b">Project Options</strong> at the bottom of the page.</li> <li class="li">Add in the additional framework directories list an entry like <span class="ph filepath">${pd}/custom_frameworks</span>.</li> <li class="li">Add other resources to your project, for example you can have all your DITA content located inside the project folder.</li> <li class="li">You can then share the new project directory with other users. For example you can commit it to your version control system and have they update their working copy. When they open the customized project file in the <a class="xref" href="http://www.oxygenxml.com/doc/versions/17.0/ug-editor/#topics/using-the-project-view.html" target="_blank"><span class="ph uicontrol">Project</span> view</a>, the new document type becomes available in the list of Document Types.</li> </ol></div> </li> <li class="li"> <p class="p">Deploy the framework/document type configuration <a class="xref" href="http://www.oxygenxml.com/doc/versions/17.0/ug-editor/#topics/packing-and-deploying-addons.html" target="_blank">as an add-on</a>.</p> </li> </ul></div> <p class="p">After your team members install the framework they can check in <span class="ph uicontrol">Document Type Association</span> preferences page in the list of Document Types to see if the framework is present and if it appears before the bundled <span class="ph uicontrol">DITA</span> framework (meaning that it has higher priority).</p> </div><img src="http://feeds.feedburner.com/~r/AboutOxygenXmlEditor/~4/CruPt7osXjg?utm_source=feedburner&utm_medium=email" height="1" width="1" alt=""/></div>
</td>
</tr>
</table>
<table style="border-top:1px solid #999;padding-top:4px;margin-top:1.5em;width:100%" id="footer">
<tr>
<td style="text-align:left;font-family:Helvetica,Arial,Sans-Serif;font-size:11px;margin:0 6px 1.2em 0;color:#333;">You are subscribed to email updates from <a href="http://blog.oxygenxml.com/">About oXygen XML Editor</a>
<br />To stop receiving these emails, you may <a href="https://feedburner.google.com/fb/a/mailunsubscribe?k=y_tRXtumvTurKTedh51JnlYsGXw">unsubscribe now</a>.</td>
<td style="font-family:Helvetica,Arial,Sans-Serif;font-size:11px;margin:0 6px 1.2em 0;color:#333;text-align:right;vertical-align:top">Email delivery powered by Google</td>
</tr>
<tr>
<td colspan="2" style="text-align:left;font-family:Helvetica,Arial,Sans-Serif;font-size:11px;margin:0 6px 1.2em 0;color:#333;">Google Inc., 1600 Amphitheatre Parkway, Mountain View, CA 94043, United States</td>
</tr>
</table>
</div>
</body>
</html>