OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Feedback from dita-users about <mapresources>

Last week I sent an e-mail to the dita-users list, asking the larger community for feedback about the proposed <mapresources> element. (You can read my e-mail to the list below.)

Seven people responded:

  1. Radu Coravu, Syncrosoft
  2. Leigh White, IXIASOFT
  3. Megan Bock, Netapp (?)
  4. Julio Vasquez
  5. Mark Schubert, parson
  6. Reece Roggentien
  7. chrispitude@gmail.com

With one exception, responders wanted to make <mapresources> available in map. Here are some excerpts from the e-mails:

  • "I applaud this idea! I think the distinction between maps referenced by mapresources and those referenced "the usual way" is an important one."
  • "Iâd prefer for it to be available in both bookmap and map. We have some outputs that have map root documents rather than bookmap."
  • "Definitely long overdue. I've always struggled with where to place the objects mentioned and having an element to gather cover image references, keydefs, and warehouse topics so it was clear that these are just non-content objects is a great add. Thanks."
  • "Iâd certainly use it in the map element. We use plenty of keys and have content used specifically for cover pages, and it would be helpful to be able to group them under a dedicated organizing element. In lieu of such an element, weâve implemented guidelines for where keydefs should be placed in relation to topicrefs and maprefs."
  • It will "provide a solution for the following issue: https://www.oxygenxml.com/forum/post54203.html"
The one person concerned about making <mapresources> available in map was Radu Coravu, who commented "I clearly see the benefit for it in a bookmap, as now we need to place all those key definitions in the frontmatter. But maybe for a plain DITA <map> it might not make that much sense, it would increase the complexity of the choices you need to make when you want to add a new element on the first level of the DITA Map." He suggested constraining map to limit the places that <mapresources> is permitted.


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

-------- Forwarded Message --------
Subject: [dita-users] New DITA element: Request for feedback
Date: Thu, 3 Oct 2019 08:03:24 -0400
From: Kristen James Eberlein kris@eberleinconsulting.com [dita-users] <dita-users@yahoogroups.com>
Reply-To: dita-users@yahoogroups.com
To: dita-users <dita-users@yahoogroups.com>


I'd like to ask the larger DITA community for feedback. (Skip ahead and look for bold highlighting if you want to jump ahead to my question.)

The DITA TC will be updating book map for DITA 2.0. One of the changes will be adding a new element (<mapresources>) that will serve as a location for resource-only objects like the following:

  • Key definitions
  • Subject schemes
  • Topics that contain content only used in processing, for example, information used to generate a PDF cover page
The DITA TC is considering the best way to implement this change. We are considering two options:
  1. Define <mapresources> as part of bookmap
  2. Add <mapresources> to the map group domain. This would make the new element available everywhere that <topicref> elements are allowed.

Question for the community: Would you find <mapresources> useful in map? Or would it just be another element that your map authors would be distracted/inconvenienced by?

The following code sample illustrates how the new element will be used in bookmap:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA 2.0 BookMap//EN" "bookmap.dtd">
ÂÂÂ <mainbooktitle>Test bookmap</mainbooktitle>
ÂÂÂ <mapref href=""subject-scheme.ditamap" type="subjectscheme"/>
ÂÂÂ <topicref href=""moz-signature">--

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


Posted by: Kristen James Eberlein <kris@eberleinconsulting.com>
Reply via web post â Reply to sender â Reply to group â Start a New Topic â Messages in this topic (1)



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]