<?xml version='1.0' encoding="utf-8"?>
<!--
/* ***** BEGIN LICENSE BLOCK *****
 * Licensed under Version: MPL 1.1/GPL 2.0/LGPL 2.1
 * Full Terms at http://mozile.mozdev.org/0.8/LICENSE
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the
 * License.
 *
 * The Original Code is James A. Overton's code (james@overton.ca).
 *
 * The Initial Developer of the Original Code is James A. Overton.
 * Portions created by the Initial Developer are Copyright (C) 2005-2006
 * the Initial Developer. All Rights Reserved.
 *
 * Contributor(s):
 *	James A. Overton <james@overton.ca>
 *
 * ***** END LICENSE BLOCK ***** */

/**
 * @fileoverview A demonstration of DocBook editing with Mozile.
 * <p>Project Homepage: http://mozile.mozdev.org 
 * @author James A. Overton <james@overton.ca>
 * @version 0.8
 * $Id: docbook.xml,v 1.2 2006/08/23 23:35:02 jameso Exp $
 */
-->

<?xml-stylesheet href="docbook.css" type="text/css"?>
<book xmlns="http://docbook.org/ns/docbook">
	<script xmlns="http://www.w3.org/1999/xhtml" type="application/x-javascript" src="../src/core.js"/>
	<script xmlns="http://www.w3.org/1999/xhtml" type="application/x-javascript" src="docbook.js"/>
	<title>Mozile DocBook Demonstration</title>
	<author>James A. Overton</author>

	<chapter id="MozileAndDocBook">
		<title>Mozile and DocBook</title>
		
		<section id="Demonstration">
			<title>Demonstration</title>
			<para>This is a demonstration of Mozile 0.8 editing a simple DocBook document. It is known to work in Firefox 1.5, but <emphasis>you must enable Caret Browsing mode by pressing F7</emphasis>. It does not work properly in Internet Explorer 6 or other browsers at the present time. Editing is structured by a simplified DocBook RNG schema named <filename>../lib/docbook.rng</filename>.</para>
			<itemizedlist>
				<title>Known Issues</title>
				<listitem>Validation is not yet done, so changed can be made which render the document invalid.</listitem>
				<listitem>Only a small subset of DocBook elements are used.</listitem>
				<listitem>No commands have been defined other than the defaults, so the toolbar is nearly empty.</listitem>
				<listitem>The toolbar is not centred.</listitem>
			</itemizedlist>
			<para>The following two sections are editable.</para>
		</section>
		
		<section id="WhatIsMozile">
			<title>What is Mozile?</title>
			<para>Mozile is a what-you-see-is-what-you-get (<acronym>WYSIWYG</acronym>) editing tool for web browsers. The name "Mozile" comes from <emphasis role="bold">Moz</emphasis>illa <emphasis role="bold">I</emphasis>n<emphasis role="bold">l</emphasis>ine <emphasis role="bold">E</emphasis>ditor. As of version 0.8, Mozile is no longer limited to Mozilla browsers like Firefox. But it's still an inline editor, which means that it allows you to edit the content of a web page "inline", without switching to another program or to a special mode. With Mozile you can just click in the page and start editing, like you're using a word processor.</para>
			<para>Mozile is an open source project, and is distributed free of charge under the terms of our <link href="http://mozile.mozdev.org/0.8/LICENSE">license</link>. Please see our homepage at <link href="http://mozile.mozdev.org">http://mozile.mozdev.org</link> for more information. Mozile is written using JavaScript, and version 0.8 is designed to work in most modern browsers, including <link href="http://www.mozilla.com/firefox/">Mozilla Firefox</link> and <link href="http://www.microsoft.com/windows/ie/">Internet Explorer</link>. However Mozile is still in development, and only Firefox 1.5 and Internet Explorer 6 are currently supported.</para>
		</section>
		
		<section id="WhyUseMozile">
			<title>Why Use Mozile?</title>
			<para>For a long time, people have been trying to edit rich content in their web browsers using HTML text boxes and awkward markup syntax. As wikis and content management systems become more popular, more and more content is being generated in our browsers. Why can't we have WYSIWYG editing, like in a word processor?</para>
			<para>Without Mozile, there are two incompatible ways to do rich text editing in a browser. Internet Explorer allows you to set a <code>contentEditable</code> attribute on an element, and then edit the contents. Firefox and other Mozilla browsers have a setting called <code>designMode</code>, which lets you edit the whole page, like the old Netscape Composer. The Internet Explorer method is missing some important features, like <emphasis>redo</emphasis>. The Firefox <code>designMode</code> won't let you pick which parts of a page are editable. But the worst part is that both of these methods are trapped in the last decade: they use out of date HTML code like <code>font</code> tags, and they have no idea what CSS is. You're limited to the small number of built-in editing commands.</para>
			<para>Mozile overcomes these problems in three ways:</para>
			<itemizedlist>
				<listitem>Mozile works in Firefox and Internet Explorer, and we're working in support for other browsers as well.</listitem>
				<listitem>Mozile uses pure DOM methods to manipulate the document, so the code you get is nice, clean X/HTML and CSS.</listitem>
				<listitem>You can customize commands and add new ones, so you can edit the document in any way that JavaScript, DOM, and CSS allow.</listitem>
			</itemizedlist>
		</section>


	</chapter>

</book>