Website download section: location of Mac OS X Readme
Christian Stimming
stimming at tuhh.de
Sun Nov 22 15:04:25 EST 2009
Two minor points to keep in mind when comparing a Wiki page to a plain HTML
file:
Am Donnerstag, 19. November 2009 schrieb John Ralls:
> The wiki page would become the primary; converting it to html is easily
> done by opening it in the browser and saving it (or downloading it via
> curl).
The Mediawiki pages as shown in your browser make heavy use of CSS (and
methinks also javascript?). Hence, saving the HTML document only gives you the
text content, but the design and look-and-feel might be completely gone. Not
that this might be a big problem here, but it is something to watch out for.
> Wikis are ad-hoc by definition, aren't they? They're also generally pretty
> flat. Since the quartz build instructions are called MacOSX/Quartz, and
> there isn't AFAICS MacOSX/anything else, I would be inclined to call the
> pages MacOSX/Stable_Readme and MacOSX/Unstable_Readme.
For the MediaWiki software which is running wiki.gnucash.org, nested page
names (with slashes in them) are possible but don't have any special meaning
at all. This is in stark contrast to what developers from a unix background
would expect and also what people would expect who have set up a web site with
sub-directories before (which means, almost everyone here). But really: For
the Mediawiki software, a page named "MacOSX/Stable/Readme" is no different
from a page named "MacOSX_Stable_Readme" or just spaces in between the words.
In other words, using pages names with slashes will not at all give you any
more structure than what the wiki already has, which is virtually nothing. In
particular, the "sub-pages" won't have any automatic link to the "parent
pages" or vice versa. Using wiki page names with slashes in it is solely a
minor hint for those human readers who are accustomed looking at the URL.
Nothing more.
The only supported form of structure in MediaWiki for automatically generated
menus or similar are the "Categories",
http://wiki.gnucash.org/wiki/Special:Categories but we don't use those much in
the gnucash.org wiki. Every other form of structure is purely done by manual
setting of links to and from the pages, as error-prone as this is.
Regards,
Christian
More information about the gnucash-devel
mailing list