I have some software I have been writing, a fair amount of code, and I have been documenting it along the way. It's all written in MS Word (the documents that is, not the code ). But I hate Word! Everytime I use it I feel dirty, using images in documents is hard, it plays around with my formatting and it always tells me I've spelt my own name wrong (and only in very few cases is it correct)! It just feels sleazy.
So I wanted an alternative. I thought perhaps Publisher would be good, but I found it hard to apply different stylings or have text that ran on more than one page. So I went back to plain old HTML files, but because I wanted good CSS'ing and wanted the pages to look nice, I had a tonne of images and stylesheets floating around. I'm thinking something like FogCreeks CityDesk might be good - it'll create all my HTML but I only need the one template... but again, theres the images problem, and the fact that I have to publish everything to read it properly.
What other good alternative software/file formats do people use?
Whatever I use, I would prefer every page was published as a single file (ie images embedded) but to also use a centralised 'master page' for all the styles and to make all the pages look the same.
I would like it to be easily editable but look good, and for it to work locally (ie not rely on a web server).
Each document should also be seperately stored, so I can put it all in my SourceGear Vault database to rollback older files.
My next attempt might be making a custom editor that saves everything as XML, and use a single XSLT template to make it look good, but that's really a last resort.
Do any of the open source alternatives fit this description?