Hi,
Am Thu, 9 Dec 1999 17:29:32 +0200 (EET) hast Du zum Thema
"[midgard] Working on Midgard tutorial" geschrieben:
> With Emile and Ron, we've started writing a
> tutorial to Midgard
Great work!
But (you knew that would have to come ;-)):
+ Apache configuration
As you mention in the abstract, a full coverage of the
options of apache vhost configuration would not be that bad
-- though, for the purpose of the tutorial, it might be
enough to outline the possibilities in order to give readers
a rough guess and help them find the simplest solution for
their first try with midgard (depending on the access to
dns, the personal experience with apache etc.).
Then one could incorporate a full and detailed coverage of
the topic into the manual or the installation instructions.
+ Installation tutorial
The "Midgard Installation Guide" by Eddie Azman is quite
outdated as I experienced while installing Midgard 1.2.5
quite recently. And, as a second point, it would benefit
from a broader perspective -- if it would not only "report"
Eddie's installation (on _his_ system, with ./configure
switches explained as 'it worked for me, so why not?' :-)),
but incorporate also a general overview of all the
non-midgardian things of a midgard installation, including,
for example, the apache vhost config as well as the mysql
access privilegies _in detail_. In case of MySQL which
should in 2.0 become easily replacable, this could also
simply be a link to an appropriate explanation.
+ Content administration
Midgard's Content Administration tool does indeed warrant
detailed explanation, at least the article.URL field and the
different content formattings (to which one would come back
later in 'host and page admin'). Advanced things like
scoring and approvement could well be left for the manual or
some kind of task-oriented advanced tutorials ('How to set
up an editorial environment with Midgard' ...)
+ Host admin
If I understood Midgard right, there is something lacking
for a running Midgard VMUC site in the first part of the
tutorial: the pages, at least a root page. Or am I totally
blind?
> Currently the tutorial contains
> only two examples:
> -Simple static Web site
> -Yahoo-like directory
Both seem to short for the beginner, I'd say. The second
one is even too complicated throwing PHP code on people
still trying to get the trick of an application server :-)
One idea for the code problem: Many people learning PHP
have problems with the cluttered code because of the mixture
of PHP and HTML. I'm sure that it would help to
1. use more whitespace
2. use more comments and
3. differentiate PHP and HTML code by text color
in example listings.
Way too many criticism for having done nothing for midgard
so far -- but hopefully (working) times will change ;-)
phr
--
--Daddy, why do those people have to use Microsoft Windows?
--Don't stare, son; it's not polite.
--
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]
