[Gimp-web] Information about the site

[Branko Collin]

On 9 Sep 2003, at 18:20, Niklas Mattisson wrote:

> http://information.gimp.kicks-ass.org/
> 
> Is the site that I am working with however it is not finished yet. But
> I would still love to get some feedback on this and maybe get some
> more questions that we could answer on that page.

: peace by peace

Give piece a chance. :-)

As Raphael said, this should be a document in the module itself.

The document seems to assume the reader is going to install and make 
the web site on some kind of Unix. Perhaps it could be explicitely 
mentioned that this document assumes that.

As requirements Apache and SSI are mentioned, but not Python. Web 
developers like me are more likely to have it the other way around: 
to assume a web server (Apache or something else) as a given, and to 
have to install Python. So perhaps:

: You need to have a apache server up with SSI support in 
: it to make it work properly. 

should become:

: You need to have a apache server up with SSI support in 
: it to make it work properly. Also, Python shoud be installed
: on your system.

(How should the python binary be accessed? Should it be in the path 
or available at a set location, like /usr/bin/python? Or does that 
not matter here?)

If you turn this document into a text document, the spacing will 
depend on the viewer, but most likely be proportional. However, if 
you retain this as an HTML doc, something like

<b>chown -R apache . ; PYTHON=python2.2 ./install.sh /home/wgo ; 
chown -R <i>username</i> .</b>

should probably be encoded like: 

<kbd>chown -R apache . ; PYTHON=python2.2 ./install.sh /home/wgo ; 
chown -R <i>username</i> .</kbd>

so that it becomes clear where spaces go and so on.

Kbd is an HTML-element specifically targeted at representing keyboard 
input. I guess you could also use <code>. In a well set-up web 
browser, this should display in a manner that is useful for reading 
keyboard input. For instance, in IE the text in the KBD element 
displays as text in a proportional font. 

HTH,

-- 
branko collin
collin@xs4all.nl