[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: Wiki editing refresher

Hash: SHA1

Karsten Wade wrote:
> For all who are editing the DUG or Docs/Beats/, a quick reminder
> pointer:
> http://fedoraproject.org/wiki/WikiEditing#Marking_Technical_Terms
> http://fedoraproject.org/wiki/WikiEditing#Quick_Tips
> Thanks - Karsten

I've been working on converting the server guide (slowly) and notice
that the wiki does not have all the functionality/style that I need to
'easily' convert my guide to the LDP wiki - or I'm doing it the wrong
way :-O.

As the guide is server based, most of the configuration is done by
manually editing the files at the command line. I wanted to make the
guide easy to follow, so I'd like to have a separate format/style
differentiating between a typed command, the output of a command, and
the contents of a configuration file - these seemed the most common
choices for manual administration.

To move technical info (config files etc..) into the wiki takes a large
amount of time using wiki markup, and displaying configuration files
inside a table takes a fair bit to format, so it looks similar to what
the user is expecting to see. To make it simpler, html - <PRE> tags work
best, however the CSSs only provide one format/style for <PRE> tags.

I loaded up moin on my own server so I could learn without killing
anything on FDP and also to play with the CSSs/markup to get the results
I think is suitable for the guide.

I've created a few pages and a template located here:
(Internet Explorer does not display my theme very well - known fault)

Also, upgrading the guide should be easier when it is superceded by the
next FC release, because the new example commands / output can be copied
straight into the <PRE> tags again.

I just wanted to get your opinions in regards to the formating/style of
the command line interaction and to see if it would break anything
(docbook/CVS/XML conversion etc..).

Miles Brennan
Version: GnuPG v1.4.2.2 (MingW32)


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]