Take the 2-minute tour ×
Super User is a question and answer site for computer enthusiasts and power users. It's 100% free, no registration required.

I'm looking for an

  • open source
  • cross platform
  • WYSIWYG

editor that I can use to write documentation. I'm not looking for a web based solution - i.e. it should work without a web server, and I want to save my files directly to disk.

The result could be any structured format, like Wiki markup, ReStructuredText, DocBook, or a small subset of HTML, ... But it's important, that

  • Subversion diff can be used to see differences between the versions easily (this wouldn't work with .odt or .rtf files for example)

I'm currently thinking about using Open Office, and saving the files as HTML, but is there a better solution?

share|improve this question
add comment

3 Answers

up vote 1 down vote accepted

If you're going to save as HTML it might be better to use a dedicated HTML editor like KompoZer, which is WYSIWYG, open-source and cross-platform.

share|improve this answer
    
@Hugh: Thanks for this link! I just installed it (it's even in the Ubuntu Repository BTW :-), and it already looks quite promising: I like its interface, and it produces very clean HTML. The split view is practical, too. It even seems to handle long files pretty well. –  Chris Lercher Apr 2 '10 at 10:01
add comment

Use plain text and your favorite programmer's editor.

As format I would suggest asciidoc since its markup is very non-intrusive and it can be converted to HTML, DocBook and others pretty easily. This will make the diffs much more pleasant to look at.

share|improve this answer
    
@honk: I love programmer's editors, and use them for almost everything. But in this case we need real WYSIWYG... –  Chris Lercher Apr 2 '10 at 0:36
    
@chris: asciidoc almost is a WYSIWYG markup ;) –  Benjamin Bannier Apr 2 '10 at 0:37
add comment

A little bit late, but Texts fits your requirements except being open-source. It's WYSIWYG, works on Mac OS X/Windows and saves files in Markdown format that is diff-friendly.

share|improve this answer
add comment

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.