[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Transforming XML or other intermediate representation of Texinfo; c

From: Robert Dodier
Subject: Re: Transforming XML or other intermediate representation of Texinfo; category system
Date: Sat, 18 Dec 2021 18:05:53 -0800

Hi Pat, you mentioned it's not clear what I'm trying to do.

The category stuff I made up is essentially the same as tags which are
applied to bug reports in, e.g. Stackoverflow or Sourceforge, e.g. (I see the tags are called
"Labels" there). An item can have multiple tags / labels / categories
/ whatever it's called, and clicking on a tag navigates to a page
which shows all the items which are tagged with that.

Here's an example of Texinfo documentation (HTML) which has been
annotated with categories (in the sense I've imposed).

You can click on a link in the Categories: box and it will take you to
another page where all the items which are marked with a given
category are collected.

The Texinfo for such items looks like

@deffn foo (x, y, z)

Yadda yadda yadda, foo bar baz quux mumble blurf.


@end deffn

The easy part is to define @category{Foobar} as a macro which
substitutes @ref{Category: Foobar, Foobar}. Also easy to define
@opencatbox / @closecatbox as <div> / </div> .

The hard part, for which I've concocted some scripts, is to extract
the set of terms named as categories, and create the list of items
which are tagged with each category. This is the operation for which I
would like to inspect a parse tree of the Texinfo document.

The output of this second part is a bunch of stuff that looks like

@b{Category: Random blurfage}
@ref{Item: foo, foo}
@ref{Item: bar, bar}
@ref{Item: baz, baz}

where foo, bar, and baz are @deffn's or @defvr's which contain

So, in my world of dreams, I would get a parse tree for the document
containing @deffn foo, etc., look for all the @category doodads, and
build a lookup table to map categories to items. Then loop over all
the categories, and emit the @anchor{whatever} and @ref{foo},
@ref{bar}, etc., for each item claiming to be in category whatever.

In the current implementation, the stuff about looking for
@category's, building the lookup table, and emitting the made-up
Texinfo stuff for the categories is handled by the scripts I

Hope that helps clarify what I'm trying to do, thanks for your interest.

Robert Dodier

PS. The scripts for this stuff can be found at:
namely, extract_categories1.sed, and extract_categories1.awk.
However, I expect that stuff is all pretty much incomprehensible.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]