From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <zsh-workers-return-30669-mason-zsh=primenet.com.au@zsh.org>
Received: (qmail 20047 invoked by alias); 15 Sep 2012 19:04:43 -0000
Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm
Precedence: bulk
X-No-Archive: yes
List-Id: Zsh Workers List <zsh-workers.zsh.org>
List-Post: <mailto:zsh-workers@zsh.org>
List-Help: <mailto:zsh-workers-help@zsh.org>
X-Seq: 30669
Received: (qmail 21566 invoked from network); 15 Sep 2012 19:04:41 -0000
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on f.primenet.com.au
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,SPF_HELO_PASS
	autolearn=ham version=3.3.2
Received-SPF: none (ns1.primenet.com.au: domain at wefu.org does not designate permitted sender hosts)
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: Av0EAIrOVFCE7/kU/2dsb2JhbABFhge2BIEHgkpKQQImAl+IIAuZQ45DkiyBIY9WgRIDiFaOH4Q5ilSDBg
X-IronPort-AV: E=Sophos;i="4.80,428,1344236400"; 
   d="scan'208";a="837109693"
Subject: Translating my Character Index into yodl-format
From: Jesse Weinstein <jesse@wefu.org>
To: zsh-workers <zsh-workers@zsh.org>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Date: Sat, 15 Sep 2012 11:54:21 -0700
Message-ID: <1347735261.2344.270.camel@zareason>
Mime-Version: 1.0
X-Mailer: Evolution 2.28.3 

I'm trying to translate my Character Index
( http://zshwiki.org/home/docs/charindex ) into yodl format so it can be
included with (and easily link to) the main zsh documentation. But I'm
running into difficulties figuring out what yodl tags to use. I've
looked at the yodl manual here: http://yodl.sourceforge.net/yodl.html
and the yodl source of the zsh docs, here:
http://zsh.git.sourceforge.net/git/gitweb.cgi?p=3Dzsh/zsh;a=3Dtree;f=3DDoc;=
hb=3DHEAD

I've figured out how to add a node to the docs (although I may have done
it wrong).

My beginning of an effort is below, in the file Doc/Zsh/kbdidx.yo

texinode(Keyboard Index)()(User Contributions)(Top)
ifnztexi(sect(Keyboard Index))

subsect(A)
startitem()
item(tt(-A))( Thing )
enditem()
subsect(B)
startlist()
list(tt(abc))=20
list(tt(de))
endlist()

Any pointers to previous efforts at migrating documentation from the
wiki to the main docs, or just advice about learning yodl, would be
appreciated.

Jesse Weinstein