Greetings!
On 12 Dec, Thijs van der Vossen wrote:
> Hmm.. This only tells me how to get the midgard code sources, not the manual.
> Just for the record, I'm not a hacker, only a web developer. Can you please
> give me some more specific instructions on how to get the SGML sources?
The SGML sources are in the midgard/doc directory of
Midgard's CVS repository so you will get them when you
checkout the actual code tree.
> I never used the DocBook format, so I have to take a look at that first. Right
> mnow I would like to make a printed version of all the documentation. In the
DocBook is quite simple as long as you keep in mind that
the syntax rules are much more strict than in HTML. O'Reilly
has a great book on DocBook, which is also available for
reading online at http://www.docbook.org
As for printing, just get the SGML source files from the
repository and run them through a SGML processor. Good
option here would be SGMLtools which you can find from
http://www.sgmltools.org
You should be able to process the DocBook files into
various different formats, including RTF, HTML and
PostScript.
When you start writing up material for the manual, just
remember that if producing DocBook and using CVS seems
too difficult, we can always arrange it so that you
produce plain text or something else and we then convert
it to SGML for publication. After all, just getting the
content written up is what matters. The presentation is
a different issue.
> following weeks I will probably start using Midgard for a few small projects.
> During these projects I promise to write manual entries for the parts I
> encounter.
That sounds sensible. I've noticed that the best way
for me to really *learn* a new thing is to first look
up the basics, and then try to either train in to someone
else or write some documentation. That way you have
to think about how it works in much more depth than
by just using it.
> Thijs.
/Bergie
--
-- Henri Bergius -- +358 40 525 1334 -- [EMAIL PROTECTED] --
http://www.iki.fi/Henri.Bergius
--
This is The Midgard Project's mailing list. For more information,
please visit the project's web site at http://www.midgard-project.org
To unsubscribe the list, send an empty email message to address
[EMAIL PROTECTED]
