<?xml version="1.0"?>
<!-- About.xml (c) 1999 Shawn P. Vincent (svincent@svincent.com) -->

<page>

<file>MagicJar/About.xml</file>
<title>About the Magic Jar project</title>

<contents>

  <h2>Historiography</h2>

    <p>My approach to history is pretty fast and loose on these pages.
    My intent is to steal from history to develop roleplaying content,
    rather than studying history for its own sake.</p>

    <p>The result is that Magic Jar should not be used as a serious
    history resource.  I cannot guarantee that all of the material in
    it is accurate.  I make liberal use of secondary (and even
    tertiary) sources, I make no effort to check up on the facts I
    find, etc.</p>

    <p>That said, I do care about the historical accuracy of this
    information.  Does that make any sense?  I'd prefer if stuff was
    historically accurate, but I'm not a good enough historian to make
    it so, given my purposes here.  If I have something grossly wrong,
    I'd like to <a href="mailto:svincent@svincent.com">hear about
    it</a>.  Any comments from people who know more than me about this
    stuff would be much appreciated.</p>

    <p>I make an attempt to list all of my sources, so that the
    interested historical reader can go to my sources and read more
    directly the information.  Some of these sources are the web, and
    due to the changing nature of the Internet, may be dead.  I'd like
    to <a href="mailto:svincent@svincent.com">hear about</a> any dead
    links, so I can fix or remove them.</p>

  <h2>Technology</h2>

    <p>The contents of Magic Jar are authored in <a
    href="http://www.w3.org/XML/">XML</a> (yes, even this page), and
    <a href="http://www.w3.org/MarkUp/">HTML</a> is generated using an
    <a href="http://www.w3.org/Style/XSL/">XSL</a> processor.
    Currently I'm using <a
    href="http://www.alphaworks.ibm.com/tech/lotusxsl">LotusXSL</a> as
    my XSL processor, but this will likely change -- LotusXSL is slow,
    plus it has a restrictive license.</p>

    <p>The pages are authored using <a
    href="http://www.gnu.org/software/emacs/emacs.html">Emacs</a>, the
    extensible, customizable, self-documenting real-time display
    editor.  Emacs is glorious.  I use the <a
    href="http://www.gnu.org/software/emacs/windows/ntemacs.html">NT
    port</a>, because I use <a
    href="http://www.microsoft.com/ntserver/">Windows NT</a>.  I have
    not made the jump to <a href="http://www.linux.org/">Linux</a> as
    my primary operating system, although I do have a Linux server
    running in my home.</p>

    <p>There is a bunch of custom <a
    href="http://java.sun.com/">Java</a> code to manage the price
    database: converting prices of items to differing currencies, etc.
    Also, bits of the XSL transforms are written in Java, as XSLT
    extensions (which means my XSLT stylesheets aren't
    cross-platform).</p>

    <p>The pages you are reading are generated on my computer using a
    <a href="http://www.gnu.org/software/make/make.html">GNU
    Makefile</a>.  They are not generated on demand, although this is
    something I consider occassionally.  The files are packaged for
    upload using the same tool.</p>

    <p>The web site itself is hosted at my domain (<a
    href="http://www.svincent.com/">svincent.com</a>), and my domain
    is hosted at my employer, <a
    href="http://www.meteko.com/">Meteko</a>.  I really dislike
    Meteko's web page.  It uses Javascript, which I hate, because it
    <em>doesn't work</em>.  Ah well.</p>

    <p>The drop cap images are in a font called Ruritania, by <a
    href="http://www.ecel.uwa.edu.au/~plloyd/">Paul J. Lloyd</a>.
    More of his fonts can be downloaded from <a
    href="http://www.geocities.com/FashionAvenue/5967/freefont/index.html">
    Kris's Haven</a>.</p>

    <p>The drop caps were implemented by entering all the capital
    letters into CorelDRAW!, and exported them as GIF images.  (I will
    probably change the images to PNG soon, for the better
    licensing...)  My XSLT stylesheet automatically generates drop
    caps in specially marked sections.  It's a little gross, but if
    you consider that I am using HTML as a rendering engine, as there
    are no widely available formatting-object browsers in existence,
    it works ok.</p>

    <p>What does all this technological mumbo-jumbo mean to users of
    the system?  Not much, I suppose, but I figure some people might
    be interested.  :)</p>

  <h2>Browser Support Policy</h2>

    <p>I have a curious stance on browser support.  There is nothing
    on these pages that should cause any browser grief: I hardly ever
    use any HTML tags other than anchors, images, tables, headings,
    and paragraphs.  However, I do make massive use of Cascading Style
    Sheets (<a href="http://www.w3.org/Style/css/">CSS</a>) to style
    everything, I use tables, which some older browsers don't support,
    I don't specify image sizes for people with old browsers that are
    incapable of rerendering the page while the image gets
    downloaded...</p>

    <p>The fact is that I don't particularly care about supporting old
    browsers.  My main concern is one of asthetics and elegance.
    Using XSL to generate super-thin HTML with cascading style sheets
    doing all the formatting is <em>elegant</em>, above all else.</p>

    <p>Thus, bugs in old or wierd browsers that some people work
    around, I ignore.  I believe that you should browse the Internet
    with a browser that supports relatively recent standards, and has
    had most glaring bugs fixed.  Commenting out (&lt;-- --&gt;)
    blocks of script code so that old versions of <a
    href="http://www.netscape.com/browsers/">Netscape Navigator</a>
    ignore them may <em>work</em>, but it's ugly beyond belief.
    Users should upgrade their browsers appropriately.</p>

    <p>On the other hand, I'm always careful to support <a
    href="http://lynx.browser.org/">Lynx</a>.  I don't believe people
    should be using latest versions of one of the Big Two browsers: I
    just think that browser developers should support recent
    standards, and users should ensure that the browsers that they're
    using are modern and well written.  Lynx is a fine idea: the Web
    is meant to be multi-platform, working well on text-based mediums:
    CSS has tons of support for that.  But Lynx should be upgraded to
    support the standards it <em>can</em> support: like in-browser XSL
    transforms, CSS support (where it can), etc.</p>

    <p>This policy is not for everybody.  Corporations, for example,
    that want to allow everybody to see their web pages need to bend
    over backwards to make everybody happy.  I have the advantage that
    if I lose 30% of my visitors because they can't see tables, I
    don't have to worry about it: this is a personal endeavor.</p>

    <p>So there you go.  That's my rant.  I should go through and
    clean it up one of these days.  I will -- but not right now.</p>

</contents>
</page>

