hi !

i'm trying to roll my own doctypes with lenya 1.4, and i came across a
few littles issues with the docs at
http://lenya.apache.org/1_4/reference/resource-types.html .


* the section "Configuring Resource Types" seems redundant to me, since
the same content is repeated later under "The Resource Type Definition"
with an example. it is a little confusing, so i'd say let's get rid of it.


* the example file under "The Resource Type Definition" omits the schema
langauge definition.

<schema src="fallback://lenya/resources/schemas/profile.rng"/>

should be

<schema language="http://relaxng.org/ns/structure/0.9";
src="fallback://lenya/resources/schemas/profile.rng"/>


* in the same section, the following path is recommended for the xpatch
file: {publication}/config/resourcetypes.xconf. in the lenya source,
such patch files are always placed in config/cocoon-xconf. should this
be changed for consistency? moreover, should the recommended file name
be resourcetype-<name>.xconf to be consistent with the usecase
patchfiles? (i'm aware that patchfiles will work regardless of their
name, but still...)


* the example file under "Formats" uses an undocumented prefix "pe"
which (after some head-scratching) is obviously "page-envelope", but it
should be made explicit.

<map:generate
src="lenya://lenya/pubs/{pe:publication-id}/content/{pe:area}/{pe:document-path}"/>


* "Adding Resource Types to a Publication" currently does not refer to
the "profile" example. this should also be changed for consistency.
i.e., move the section "Choose a Unique Resource Type Name" to the top
(since it introduces the example) and add a line

<resource-type name="profile" workflow="workflow.xml"/>

i wonder: shouldn't there also be a line

<module name="profile"/> ?


regards,

jörn


-- 
"Án nýrra verka, án nútimans, hættir fortíðin að vekja áhuga."
"Without new works, without the present the past will cease to be of
interest."
        - Ásmundur Sveinsson (1893-1982)

--
Jörn Nettingsmeier, EDV-Administrator
Institut für Politikwissenschaft
Universität Duisburg-Essen, Standort Duisburg
Mail: [EMAIL PROTECTED], Telefon: 0203/379-2736


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to