[drupal-docs] XHTML in our documentation - Textile, Markdown, ...

[Gabor Hojtsy]

>> Any text-based format can be "converted". I suspect that what "Dries
>> has wanted" is a way for export/offline reading. I am not a fan of
>> random alternative markup languages.
> 
> i'm not the biggest fan either. But the advantages of having clean 
> parseable XML are huge. The first example that comes to mind is the 
> wonderful S5 slideshow module from Bryght  [1]. This one is worth 
> checking out. It displays any set of book pages in a snazzy slideshow a 
> la Powerpoint/Keynote/etc. The catch is that your book pages must 
> contain valid, semantically correct HTML. So how can we assure that 
> documentation authors produce work that has this characteristic? I 
> propose that these markup languages are the best way. I'm open to other 
> suggestions, or to debate on whether clean HTML is even a worthwhile goal.
> 
> [1] http://www.bryght.com/node/121 (see the test site link)

I am also -1 on using any markup language other than valid XHTML. Drupal 
also has modules to check for input validity, and can refuse 
non-compliant XHTML code. I am using the bbcode firefox extension to 
help me author bug reports and comments on drupal.org. It does support 
HTML and XHTML editing options too:

https://addons.update.mozilla.org/extensions/moreinfo.php?id=128&vid=196&category=Miscellaneous

It is far from being a WYSIWYG editor, but I don't like these shiny 
editors, so this immediate solution fits my work quite well.

Goba