How to create documentation using xml - tools? suggestions?

Question

I would like to create documentation using standard xml. I would like to stay away from Microsoft Word but be able to create documents and procedures using xml. I actually tried to create something simple with Word just to test and then saving it as xml. The amount of information saved is ridiculous. I want something much simpler and that allows me to go back and edit the files using just Notepad++ or similar. With an xml file created by Word, the structure is so complex that I am stuck using Word. Are there tools available that can help me do that?
I am currently doing the following:

<?xml version="1.0" encoding="utf-8"?>

<books>
  <title name="Sample document">
   <author>Insert Author</author>
    <chapter name="Title of the chapter one">
  <content></content>
</chapter>
  </title>
</books>

I am just making up the fields as I go but if there is a tool that can automatically do that, it would save me a lot of time and.. I don't want to reinvent the wheel.

Suggestions are appreciated.

Thanks Tony

Daniel Haley · Accepted Answer · 2011-11-17 23:39:10Z

3

Not really a programming question, but take a look at DocBook. You can either use the DocBook Schemas/DTDs as-is or use them for a base and modify to fit your needs.

I would also suggest using an XML editor. oXygen has built in support for DocBook.

EDIT

Almost forgot about DITA. (Also see http://dita.xml.org/)

edited Nov 17, 2011 at 23:39

answered Nov 17, 2011 at 20:01

Daniel Haley

53.1k7 gold badges75 silver badges97 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

jwl · Accepted Answer · 2011-11-17 19:44:54Z

0

I believe it is still in development and I have only looked at it superficially, but Jquery-docs is what the Jquery project is working on using for documentation, and it is XML based: https://github.com/jquery/jquery-docs

answered Nov 17, 2011 at 19:44

jwl

10.5k16 gold badges59 silver badges93 bronze badges

Collectives™ on Stack Overflow

How to create documentation using xml - tools? suggestions?

2 Answers 2

EDIT

Comments

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

**EDIT**

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Related

EDIT