When I need a document to "play" with in Editor, I usually go with the
Arbortext-supplied version of Docbook. However, for a project with a
little more scope, particularly one intended for the sort of modular
maintenance approach espoused by S1000D, I think it would be only
moderately more work, initially, to start a DITA bookmap and create
concept, reference and task topics as needed. These topics should
readily map to S1000D data modules, while the bookmap would be
translated to whatever form your S1000D system uses to organize
modules into a print publication.
-Brandon
On Wed, Jan 26, 2011 at 3:49 PM, Jarrett, John T (US SSA)
<-> wrote:
> Would you recommend a simple DTD or schema for a simple book like the operators manual in your car? Probably a good Arbortext one out there I just need to stumble across. Trying a commercial book and am trying to get away from the overly-complex Army-type.
>
> Eventually it would be imported into an S1000D system but there is neither the time nor the budget to worry about that now.
>
> Thanks,
>
> John T. Jarrett CDT
> Senior Tech Writer, Integrated Logistics Support,Land & Armaments/Global Tactical Systems
>
> T832.673.2147 | M 832.363.7234 | F 832.673.2376| x1147 | -
> BAE Systems, 5000 I-10 West, Sealy, Texas USA 77474
> www.baesystems.com
>
Arbortext-supplied version of Docbook. However, for a project with a
little more scope, particularly one intended for the sort of modular
maintenance approach espoused by S1000D, I think it would be only
moderately more work, initially, to start a DITA bookmap and create
concept, reference and task topics as needed. These topics should
readily map to S1000D data modules, while the bookmap would be
translated to whatever form your S1000D system uses to organize
modules into a print publication.
-Brandon
On Wed, Jan 26, 2011 at 3:49 PM, Jarrett, John T (US SSA)
<-> wrote:
> Would you recommend a simple DTD or schema for a simple book like the operators manual in your car? Probably a good Arbortext one out there I just need to stumble across. Trying a commercial book and am trying to get away from the overly-complex Army-type.
>
> Eventually it would be imported into an S1000D system but there is neither the time nor the budget to worry about that now.
>
> Thanks,
>
> John T. Jarrett CDT
> Senior Tech Writer, Integrated Logistics Support,Land & Armaments/Global Tactical Systems
>
> T832.673.2147 | M 832.363.7234 | F 832.673.2376| x1147 | -
> BAE Systems, 5000 I-10 West, Sealy, Texas USA 77474
> www.baesystems.com
>
I agree. Going along with DITA is closer to the S1000D design. It has some
quirks of its own and features you would probably want to stay away from
if you intend to go to S1000D. The good thing about it is the DITA Open
Toolkit. With that you can complie your output to PDF or HTML help without
having to buy anything.
Not sure what tools you have from PTC, but if you have PE or digital media
publisher you could get similar outputs from that as well. OT will have
xsl/xslt stylesheets that you can tweak directly, the PTC products I
belive use Styler stylesheets.
..dan
> When I need a document to "play" with in Editor, I usually go with the
> Arbortext-supplied version of Docbook. However, for a project with a
> little more scope, particularly one intended for the sort of modular
> maintenance approach espoused by S1000D, I think it would be only
> moderately more work, initially, to start a DITA bookmap and create
> concept, reference and task topics as needed. These topics should
> readily map to S1000D data modules, while the bookmap would be
> translated to whatever form your S1000D system uses to organize
> modules into a print publication.
>
> -Brandon
>
>
> On Wed, Jan 26, 2011 at 3:49 PM, Jarrett, John T (US SSA)
> <-> wrote:
>> Would you recommend a simple DTD or schema for a simple book like the
>> operators manual in your car? Probably a good Arbortext one out there I
>> just need to stumble across. Trying a commercial book and am trying to
>> get away from the overly-complex Army-type.
>>
>> Eventually it would be imported into an S1000D system but there is
>> neither the time nor the budget to worry about that now.
>>
>> Thanks,
>>
>> John T. Jarrett CDT
>> Senior Tech Writer, Integrated Logistics Support,Land &
>> Armaments/Global Tactical Systems
>>
>> T832.673.2147 | M 832.363.7234 | F 832.673.2376| x1147 |
>> -
>> BAE Systems, 5000 I-10 West, Sealy, Texas USA 77474
>> www.baesystems.com
>>
>
quirks of its own and features you would probably want to stay away from
if you intend to go to S1000D. The good thing about it is the DITA Open
Toolkit. With that you can complie your output to PDF or HTML help without
having to buy anything.
Not sure what tools you have from PTC, but if you have PE or digital media
publisher you could get similar outputs from that as well. OT will have
xsl/xslt stylesheets that you can tweak directly, the PTC products I
belive use Styler stylesheets.
..dan
> When I need a document to "play" with in Editor, I usually go with the
> Arbortext-supplied version of Docbook. However, for a project with a
> little more scope, particularly one intended for the sort of modular
> maintenance approach espoused by S1000D, I think it would be only
> moderately more work, initially, to start a DITA bookmap and create
> concept, reference and task topics as needed. These topics should
> readily map to S1000D data modules, while the bookmap would be
> translated to whatever form your S1000D system uses to organize
> modules into a print publication.
>
> -Brandon
>
>
> On Wed, Jan 26, 2011 at 3:49 PM, Jarrett, John T (US SSA)
> <-> wrote:
>> Would you recommend a simple DTD or schema for a simple book like the
>> operators manual in your car? Probably a good Arbortext one out there I
>> just need to stumble across. Trying a commercial book and am trying to
>> get away from the overly-complex Army-type.
>>
>> Eventually it would be imported into an S1000D system but there is
>> neither the time nor the budget to worry about that now.
>>
>> Thanks,
>>
>> John T. Jarrett CDT
>> Senior Tech Writer, Integrated Logistics Support,Land &
>> Armaments/Global Tactical Systems
>>
>> T832.673.2147 | M 832.363.7234 | F 832.673.2376| x1147 |
>> -
>> BAE Systems, 5000 I-10 West, Sealy, Texas USA 77474
>> www.baesystems.com
>>
>
