From mboxrd@z Thu Jan  1 00:00:00 1970
X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/22752
Path: news.gmane.org!not-for-mail
From: Christopher Creutzig <christopher@creutzig.de>
Newsgroups: gmane.comp.tex.context
Subject: Re: DOC/RTF to ConTeXt via XML
Date: Wed, 28 Sep 2005 09:08:58 +0200
Message-ID: <433A418A.9080502@creutzig.de>
References: <4373229C@webmail.colostate.edu>
Reply-To: mailing list for ConTeXt users <ntg-context@ntg.nl>
NNTP-Posting-Host: main.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset=windows-1252
Content-Transfer-Encoding: quoted-printable
X-Trace: sea.gmane.org 1127891459 15737 80.91.229.2 (28 Sep 2005 07:10:59 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Wed, 28 Sep 2005 07:10:59 +0000 (UTC)
Original-X-From: ntg-context-bounces@ntg.nl Wed Sep 28 09:10:57 2005
Return-path: <ntg-context-bounces@ntg.nl>
Original-Received: from ronja.vet.uu.nl ([131.211.172.88] helo=ronja.ntg.nl)
	by ciao.gmane.org with esmtp (Exim 4.43)
	id 1EKW4k-0006Ca-1Z
	for gctc-ntg-context-518@m.gmane.org; Wed, 28 Sep 2005 09:09:58 +0200
Original-Received: from localhost (localhost [127.0.0.1])
	by ronja.ntg.nl (Postfix) with ESMTP id 748D2127ED;
	Wed, 28 Sep 2005 09:09:57 +0200 (CEST)
Original-Received: from ronja.ntg.nl ([127.0.0.1])
 by localhost (smtp.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP
 id 08436-03-2; Wed, 28 Sep 2005 09:09:52 +0200 (CEST)
Original-Received: from ronja.vet.uu.nl (localhost [127.0.0.1])
	by ronja.ntg.nl (Postfix) with ESMTP id DA417127E0;
	Wed, 28 Sep 2005 09:09:52 +0200 (CEST)
Original-Received: from localhost (localhost [127.0.0.1])
	by ronja.ntg.nl (Postfix) with ESMTP id 28A5C127E0
	for <ntg-context@ntg.nl>; Wed, 28 Sep 2005 09:09:52 +0200 (CEST)
Original-Received: from ronja.ntg.nl ([127.0.0.1])
	by localhost (smtp.ntg.nl [127.0.0.1]) (amavisd-new,
	port 10024) with LMTP id 08436-03 for <ntg-context@ntg.nl>;
	Wed, 28 Sep 2005 09:09:51 +0200 (CEST)
Original-Received: from bayes.math.uni-paderborn.de (bayes.math.uni-paderborn.de
	[131.234.116.40]) by ronja.ntg.nl (Postfix) with ESMTP id E99E3127DE
	for <ntg-context@ntg.nl>; Wed, 28 Sep 2005 09:09:02 +0200 (CEST)
Original-Received: from localhost (localhost.localdomain [127.0.0.1])
	by bayes.math.uni-paderborn.de (Postfix) with ESMTP id 93DA0E000123
	for <ntg-context@ntg.nl>; Wed, 28 Sep 2005 09:09:02 +0200 (CEST)
Original-Received: from bayes.math.uni-paderborn.de ([127.0.0.1])
	by localhost (bayes [127.0.0.1]) (amavisd-new, port 10024) with ESMTP
	id 13527-02 for <ntg-context@ntg.nl>;
	Wed, 28 Sep 2005 09:08:59 +0200 (CEST)
Original-Received: from [192.168.1.2] (p548B0EDA.dip0.t-ipconnect.de [84.139.14.218])
	by bayes.math.uni-paderborn.de (Postfix) with ESMTP id 63A7EE000112
	for <ntg-context@ntg.nl>; Wed, 28 Sep 2005 09:08:59 +0200 (CEST)
User-Agent: Mozilla Thunderbird 1.0.6 (Macintosh/20050716)
X-Accept-Language: en-us, en
Original-To: mailing list for ConTeXt users <ntg-context@ntg.nl>
In-Reply-To: <4373229C@webmail.colostate.edu>
X-Enigmail-Version: 0.92.0.0
X-Virus-Scanned: by mailscan-system at math.uni-paderborn.de
X-Virus-Scanned: amavisd-new at ntg.nl
X-BeenThere: ntg-context@ntg.nl
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: mailing list for ConTeXt users <ntg-context.ntg.nl>
List-Unsubscribe: <http://www.ntg.nl/mailman/listinfo/ntg-context>,
	<mailto:ntg-context-request@ntg.nl?subject=unsubscribe>
List-Archive: <http://www.ntg.nl/pipermail/ntg-context>
List-Post: <mailto:ntg-context@ntg.nl>
List-Help: <mailto:ntg-context-request@ntg.nl?subject=help>
List-Subscribe: <http://www.ntg.nl/mailman/listinfo/ntg-context>,
	<mailto:ntg-context-request@ntg.nl?subject=subscribe>
Original-Sender: ntg-context-bounces@ntg.nl
Errors-To: ntg-context-bounces@ntg.nl
X-Spam-Checker-Version: SpamAssassin 3.0.3 (2005-04-27) on smtp.ntg.nl
X-Virus-Scanned: amavisd-new at ntg.nl
Xref: news.gmane.org gmane.comp.tex.context:22752
Archived-At: <http://permalink.gmane.org/gmane.comp.tex.context/22752>

Idris Samawi Hamid wrote:

>>But you should also explore DocBook-in-ConTeXt, which
>>uses ConTeXt's native XML processing capabilities.
>=20
>=20
> Is it possible to create a Word template that is isomorphic with a DocB=
ook=20
> format?

 You can write a Word template isomorphic to a (pretty large) subset of
DocBook, although I believe Word does not allow you to introduce new
types of crossreferences, so you can't reach everything DocBook has.
Whether you can make your authors use it consistently is a different
matter =96 DocBook uses, for example, different elements for different
types of what ConTeXt calls typing: <code> for inline code fragments,
<command> for something you invoke (use <option> for its options and
<symbol> for the placeholders to be replaced by actual values),
<computeroutput> should be obvious but there are also <screen> and
<screenshot> =96 the difference is a bit subtle; programmers might also
use <constant>, <errorcode>, <errorname>, <errortext>, <exceptionname>,
<funcdef>, <funcprototype>, <funcsynopsis>, <cmdsynopsis>,
<constructorsynopsis>, <arg>, <function>, <methodname>, <methodparam>,
<methodsynopsis>, <ooclass>, <ooexception>, <oointerface>,
<progamlisting> and its annotated cousin <programlistingco>, <sgmltag>,
<structfield>, <structname>, <varargs>, <varname>; <envar> denotes
environment variables, <filename> is almost superfluous since it is a
special case of a <systemitem> (yes, many of these elements carry
further meta-information in their attributes), then there are the
unspecific <literal> and <literallayout> elements and also <markup>,
<userinput>, and finally there is also <uri> to format URLs and other URI=
s.

 Somewhat related elements also abound: <keycap> is used to denote keys
on the keyboard, <keycombo> for combinations of those keys.  <guibutton>
is used for the text on a button in a GUI, <guilabel>, <guimenu>,
<guimenuitem> and <guisubmenu> and many others.

 Note that I do not question this abundance of possibilities.  After
all, it is logical markup taken to an extreme and probably noone really
uses all of it, yet all the parts are already there if you want them.
I do question the likelihood of the average Word user (who, let's face
it, probably never used formats since the introductory course) making
good use of this.  Sure it is nice to have authors' first and last names
explicitly marked in your text, but someone has to go there and do that,
and if they don't see any difference on their screens after doing it,
they will get lazy and not do it for the fifteenth person they name.
Additionally, most of the DocBook elements may only appear nested in the
correct places in other elements, which makes using an isomorphic Word
template rather challenging even for the advanced user.

 If you would like to browse through the long list of markup items in
DocBook, please see http://docbook.org/tdg/en/html/docbook.html =96 and d=
o
not be afraid; as I said above, very much of what is there is absolutely
special-purpose stuff.

> Adam (privately) suggested hiring someone to write a structured format =
for=20
> authors. Is that where docbook comes in?

 Actually, I would not orient the thing to fit to DocBook.  DocBook is
an extremely flexible beast, so if, after designing the structured
format best suited for your needs (this does not need to invlove any
xml), you want to map it to DocBook, that should not be any problem.

> Basically, authors in the humanities use Word and it's virtually a lost=
 cause=20
> getting them to switch to anything else, even free tools like OO.o (let=
 alone=20
> ConTeXt). It would have to be someting where I could do=20
> word=3D>docbook=3D>ConTeXt.

 As I said: Offering Word is obviously a must, but if that were the only
option you offered, you'd be actively adding your part to making sure
the situation does not change.  And getting Word to export DocBook will
certainly be much harder than using OOo for that part.


Christopher