Mailinglist Archive: opensuse-doc (120 mails)

< Previous Next >
Re: [opensuse-doc] Wiki to PDF? Using Wiki as a doc source?
  • From: Christian Boltz <opensuse@xxxxxxxxx>
  • Date: Sun, 29 Apr 2007 16:14:01 +0200
  • Message-id: <200704291614.02462@xxxxxxxxxxxxxxx>
Hello,

Karl, please forget all your docbook knownledge for some minutes ;-) and 
then read this mail.

on Freitag, 27. April 2007, Karl Eichwalder wrote:
> 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.  

I agree with Clayton here - many people are not familar with XML and 
prefer the wiki syntax.

> OTOH, in technical books you often do not need all
> this semantic markup.  The mediawiki file format is rich enough for
> computer related books.

So why isn't LfL maintained in a mediawiki? ;-))
(I guess because it needs some things the mediawiki format doesn't 
offer, correct?)

> > 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".  

I don't think so. The reason why more people use OpenOffice is WYSIWYG. 
And because you can "design" your documents easier (well, usually this 
shouldn't be done at all, but people like to do it ;-)

> BTW, we try solve a problem that 
> does not exist.  Look at it from another point of view.
[...]
> 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.

Exactly this is the point - with some wiki templates, we could have 
fully _automatic_ conversion to XML.

This would also mean easier editing (no SVN knownledge needed, and it's 
nearly impossible to have syntax errors in mediawiki ;-)

We could even maintain LfL in a wiki which would mean new authors 
wouldn't need to learn docbook. Maybe this would also attract more 
authors to write for LfL...

Just compare the numbers - how many wiki editors does openSUSE have? And 
how many LfL editors?


Regards,

Christian Boltz
-- 
> Weiß jemand was suse 9.0 für Mindestvoraussetzung brauch?
Einen der damit umgehen kann...
[> Marcel Stein und Roman Langolf in suse-linux]
---------------------------------------------------------------------
To unsubscribe, e-mail: opensuse-doc+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-doc+help@xxxxxxxxxxxx

< Previous Next >