Mailinglist Archive: opensuse-doc (120 mails)

< Previous Next >
Re: [opensuse-doc] Wiki to PDF? Using Wiki as a doc source?
  • From: Karl Eichwalder <ke@xxxxxxx>
  • Date: Fri, 27 Apr 2007 07:46:58 +0200
  • Message-id: <sh1wi6fjxp.fsf@xxxxxxxxxxxxxxx>
Christian Boltz <opensuse@xxxxxxxxx> writes:

> Just a quick idea: what about adding "semantic" templates to the wiki?

I'd rather vote to enhance the wiki to make it accept DocBook XML as an
input format.  OTOH, in technical books you often do not need all this
semantic markup.  The mediawiki file format is rich enough for computer
related books.

> I'm thinking about {{menu|File}} and similar...

I believe people do not like curly braces.  Curly braces are one of the
reasons why LaTeX "failed".  BTW, we try solve a problem that does not
exist.  Look at it from another point of view.

    If you want to write a book, use a markup system suitable for books
    (XML, Texinfo, LaTeX, Frame (mif), etc.).

    If you want to write wiki-like online articles with fast turn around
    times and want others to contribute to them, use a simple markup
    system such as basic HTML or the "standard" mediawiki format.

Later, if it turns out, you need some of the online articles as sections
of a book, convert them to XML--manually or with the help of some editor
marcos.

-- 
Karl Eichwalder
R&D / Documentation

SUSE LINUX Products GmbH, GF: Markus Rex, HRB 16746 (AG Nuernberg)
---------------------------------------------------------------------
To unsubscribe, e-mail: opensuse-doc+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-doc+help@xxxxxxxxxxxx

< Previous Next >