S1000D

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|

S1000D

rockyallen
Does anyone have any ideas or experience in using Asciidoctor with S1000D, or would be interested in using it?

S100D is a large and complex specification for creating technical publications (https://en.wikipedia.org/wiki/S1000D).
It is normally implemented using expensive commercial packages like Arbortext. The niche I am interested in (as a subsystem supplier) is providing my technical data (currently in asciidoc) to my customer in S1000D format so that they can generate the full equipment documentation.

The tools that I think this would need are:
Asciidoc to data module conversion
Asciidoc to publication module (or publication module to asciidoc) so that asciidoctor can be used to preview the output.

Reply | Threaded
Open this post in threaded view
|

Re: S1000D

mojavelinux
Administrator
@rockallen

I'm not familiar with the S1000D format, but given it's an XML specification, I can say it's the bread and butter of Asciidoctor. Generating it would be very similar to the DocBook (built-in) and Mallard (https://github.com/asciidoctor/asciidoctor-mallard) converters. And converting to formats such as this are the value add of Asciidoctor.

If you need help getting started, don't hesitate to ask. You may also be interested in join the Asciidoctor channel on gitter at https://gitter.im/asciidoctor/asciidoctor.

Cheers,

-Dan

--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux
Reply | Threaded
Open this post in threaded view
|

Re: S1000D

kibukj
This post was updated on .
In reply to this post by rockyallen
I would be interested in this for sure. I have only used AsciiDoc and asciidoctor a little bit myself so far, but I am particularly interested in free/open source tools for S1000D. I typically author straight S1000D XML (with some help from some XML plugins for vim) but there's obvious benefits to authoring in a lightweight markup language.

I actually do a lot more of the reverse, S1000D-to-DocBook, to produce Markdown READMEs and manpages for a set of S1000D tools I'm working on. I use an XSLT script for the conversion to DocBook, and Pandoc for everything else.

More relevant is this XSLT script to convert DocBook-to-S1000D, but I haven't spent as much time on it. The original purpose of this was to write content in a lightweight markup language like AsciiDoc, use pandoc to convert it to DocBook, and then to S1000D.

I've been gathering whatever free tools/info I can find related to S1000D here.