<div dir="ltr"><div>Hi Rebecca<br><br></div>Your to-do list is pretty accurate. I've added my comments below, preceded by [Yves]>>><br><br>On Wed, Jul 10, 2013 at 9:49 AM, rebecca officer <span dir="ltr"><<a href="mailto:rebecca.officer@alliedtelesis.co.nz" target="_blank">rebecca.officer@alliedtelesis.co.nz</a>></span> wrote:<br>




<div>Hi everyone </div>
<div> </div>
<div>Thanks very much for your answers. I really appreciate the expertise on this list.<br></div><div>[Yves]>>> You're welcome.<br></div>
<div> </div>
<div>I'm asking because I proposed to my team that we investigate going 
to DITA. One of my team members asked why not just use our existing set 
of paragraph tags etc and convert those to structured Frame and then 
into an XML schema? I didn't really have a good answer.<br>[Yves]>>> Because you'd be reinventing the DITA wheel, and this would mean a lot of work.<br></div>
<div> </div>
<div>As well as us editing docs in Framemaker, we'd want engineers 
editing the same docs in another XML editor, eg Oxygen. So we'd have to 
round-trip.<br>[Yves]>>> Good idea and good choice of tools: oXygen XML Author and FrameMaker+DITA-Fmx play very well together. With FMx-Auto (<a href="http://leximation.com/dita-fmx/fmx-auto.php">http://leximation.com/dita-fmx/fmx-auto.php</a> ), you can even generate Fm books from within oXygen.<br>
</div>
<div> </div>
<div>So am I right that if we do our own schema, we'd have to:</div>
<div> </div>
<div>- create a template (based on our unstructured FM one): [Yves]>>> correct, but you may have to create templates (plural), which may be difficult to maintain<br></div>
<div>- model tables, cross-references, images, etc: [Yves]>>> correct<br></div>
<div>- model some equivalent of conrefs if we want content reuse [Yves]>>> correct, but also think of equivalents of other advanced DITA reuse techniques, such as conditional text (ditaval), relationship tables, keys (keyref, keydef, conkeyref...)<br>
</div>
<div>- create some equivalent of ditamaps [Yves]>>> correct, this would be Fm books<br></div>
<div>- create an EDD [Yves]>>>correct, but you may have to create multiple EDDs (for authoring and for publishing)<br></div>
<div>- create a DTD [Yves]>>> correct, but this may be multiple DTDs (for various information types)<br></div>
<div>- create read/write rules [Yves]>>> correct<br></div>
<div>- create XSLT and CSS files in order to output XHTML [Yves]>>>correct</div>
<div>- create an XSL-FO file in order to output PDFs [Yves]>>>not necessarily. you can also create your PDFs via FrameMaker<br><br></div><div>[Yves]>>> When doing the information modeling, do not underestimate the effort to define the metadata and the attributes in particular. <br>
</div>
<div> </div>
<div>Or am I drastically on the wrong track? [Yves]>>> No, you're doing just fine. ;-)<br></div>
<div> </div>
<div>Does structured Frame automatically provide any of the above?<br>[Yves]>>> Structured Frame without DITA (so saving your files as .fm not .xml)? No. Structured Frame with DITA? Yes, and structured Frame with DITA-FMx even a lot more than that:<br>
<br><a href="http://leximation.com/dita-fmx/featurecomparison.php">http://leximation.com/dita-fmx/featurecomparison.php</a><br></div>
<div> </div>
<div>[Rebecca] With DITA, I think we'd use DITA-FMx. Does that make it easier to 
muck with your PDF output? From what I've read, PDFs sound like the 
biggest pain point so far.<br></div><div><br>[Yves]>>> There are various ways and tools to generate PDFs from DITA-structured content:<br><ul><li>DITA > FrameMaker > PDF<br></li><li>DITA > FrameMaker+DITA-FMx > PDF<br>
</li><li>DITA > XSL-FO > PDF<br></li><li>DITA > Word > PDF</li><li>DITA > WebWorks ePublisher > PDF</li></ul><p>My favourite way is to generate PDFs via DITA-FMx because it is very easy to design custom (or variants of) FrameMaker "bookbuild" templates. "Bookbuild templates" (aka "component templates") are used to generate Fm books from the DITA map. Then, you save this Fm book as PDF. If you know how to design professional unstructured FrameMaker templates, you can also design DITA-FMx bookbuild templates. These videos show you how the bookbuild process goes:</p>
<p><a href="http://youtu.be/rkQHuxtRmk0">http://youtu.be/rkQHuxtRmk0</a></p><p><a href="http://www.youtube.com/watch?v=ULFJ53RTHxo">http://www.youtube.com/watch?v=ULFJ53RTHxo</a></p><p>Cheers</p><p><br></p><p>Yves<br></p>
<p><br></p></div><br></div>