Re: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber

What about generalizing the element name: resources ?

Thanks and best regards,

--Scott

From: <dita@lists.oasis-open.org> on behalf of Éric Sirois <eric.sirois@ixiasoft.com>
Date: Tuesday, February 27, 2018 at 8:23 AM
To: Amber Swope <amber@ditastrategies.com>, Kristen James Eberlein <kris@eberleinconsulting.com>, "dita@lists.oasis-open.org" <dita@lists.oasis-open.org>
Cc: Robert Anderson <robander@us.ibm.com>
Subject: RE: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson

Hi Amber,

The bookmapresources is simply an anchor point to allow other specializations to hook into that spot. The way the shell is setup you will never see bookmapresources in a drop down menu in an XML editor. It’s there for specializers. The markup below is correct.

Bookmapresources is based on topicref

<!ENTITY % bookmapresources.content
                       "((%topicmeta;)?,
                         (%anchor; |
                          %data.elements.incl; |
                          %navref; |
                          %topicref;)*)"
>
<!ENTITY % bookmapresources.attributes
              "href
                          CDATA
                                    #IMPLIED
               keyref
                          CDATA
                                    #IMPLIED
               keys
                          CDATA
                                    #IMPLIED
               query
                          CDATA
                                    #IMPLIED
               copy-to
                          CDATA
                                    #IMPLIED
               outputclass
                          CDATA
                                    #IMPLIED
               %topicref-atts;
               %univ-atts;"
>

Bookmap.dtd shell: Usually you whould see “bookmapresources | %bookmapkeydefs-d-bookmapresources;”, but we omitted the first part so it’s not available.

<!ENTITY % bookmapresources "%bookmapkeydefs-d-bookmapresources;
">

Éric Sirois

DITA Toolsmith

IXIASOFT

825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1

tel + 1 514 279-4942 / toll free + 1 877 279-4942

mobile + 1 647 462-3620

eric.sirois@ixiasoft.com / www.ixiasoft.com

From: dita@lists.oasis-open.org [mailto:dita@lists.oasis-open.org] On Behalf Of Amber Swope
Sent: February 26, 2018 10:14 PM
To: Kristen James Eberlein <kris@eberleinconsulting.com>; dita@lists.oasis-open.org
Cc: Robert Anderson <robander@us.ibm.com>
Subject: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson

My apologies for the late response.

I have reviewed the proposal and have the following comments/questions:

1. Does the proposed <bookmapresources> element only allow specializations of <topicref> or also include <topicref> elements?

2. Is the sample markup correct? Or should <bookmapkeydefs> be replaced with <bookmapresources>?
<bookmap>

</booktitle>

</bookmapkeydefs>

</bookmap>

3. Also, can we include sample usage of the proposed <bookmakers> element?

Thanks, Amber

PS – I will be unable to attend tomorrow’s meeting.

From: Kristen James Eberlein [mailto:kris@eberleinconsulting.com]
Sent: Monday, February 26, 2018 2:33 PM
To: dita@lists.oasis-open.org
Cc: Robert Anderson; Amber Swope
Subject: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson

Have you reviewed the stage two proposal for #29? Is it ready for TC discussion tomorrow?

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)

On 2/26/2018 12:30 PM, Kristen James Eberlein wrote:

Eric, has your stage two proposal been reviewed by the assigned reviewer for stage two completeness?

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)

On 2/26/2018 11:45 AM, Eric Sirois wrote:

Submitter's message
HTML Version of Issue 29 Stage 2 proposal, bookmap update
-- Mr. Eric Sirois

Document Name: DITA 2.0 Stage 2 proposal for issue #29 (HTML)

No description provided.
Download Latest Revision
Public Download Link

Submitter: Mr. Eric Sirois
Group: OASIS Darwin Information Typing Architecture (DITA) TC
Folder: DITA Specification 2.0 Ideas and Proposals
Date submitted: 2018-02-26 08:45:08

--------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php

dita message