gmane.text.docbook.misc

Re: DocBook Technical Committee Meeting Agenda: 22 May 2013

Hudson, Scott — 2013-05-22T17:22:04

last minute regrets, but something has come up.

--Scott

On May 20, 2013, at 10:13 AM, Bob Stayton <bobs< at >sagehill.net> wrote:

DocBook Technical Committee Meeting Agenda: 22 May 2013

Bob Stayton — 2013-05-20T16:13:48

DocBook Technical Committee Meeting Agenda: 22 May 2013
=============================================================

The DocBook Technical Committee will meet on Wednesday, 22 May 2013 at
1:00pm ET for 90 minutes.

Attendance at teleconferences is restricted to members
(and prospective members) of the committee.

This is the phone number for Wednesday's DocBook TC call:

Phone: +1-719-387-5556
 Code: 902213

The DocBook TC uses the #docbook IRC channel on
irc.freenode.org.  The IRC channel is used for exchanging
URIs, providing out-of-band comments, and other aspects
of the teleconference, so please join us there if at
all possible.

Agenda

1. Roll call
2. Accepting the minutes [1] of the previous meeting.
3. Next meeting: 15 May 2013
4. Review of the agenda.
5. Review of open action items

  a.  Norm to publish an XSD for 5.1 when it is finished.

  b.  Norm to follow up on OASIS mirroring the schema directory.

  c.  Larry to try mapping slides to assembly.

  d.  Norm to clarify bridgehead entry in TDG

Implied author

Brad Scott — 2013-05-16T13:09:08

Hi again

A print edition has an implied author for some of the bibliography (ie 
under the heading "Books by Brecht). I'd like to have the author in the 
bibliographic reference so I can generate an OpenURL query when it is 
online, but I'd also want to be able to suppress it for any display. Is 
this an occasion when I'd use < at >condition on the author?

<bibliomixed 
xml:id="bibl8"><author><personname><firstname>Berthold</firstname> 
<surname>Brecht</surname></personname></author><title><emphasis 
role="italic">Poems and Songs from the Plays</emphasis></title>, edited 
and mainly translated by <editor><personname><firstname>John</firstname> 
<surname>Willett</surname></personname></editor> 
(<address><city>London</city></address>: 
<publishername>Methuen</publishername>, 
<pubdate>1990</pubdate>)</bibliomixed>

Similarly, where there are multiple items in a bibliography by an 
author, I want to keep the long dash, but inherit (and not display) the 
implied author from the preceding item. So, this would give

Re: Punctuation after in ?

Bob Stayton — 2013-05-14T16:22:55

Hi Brad,
Yes, you can control that.  See this section in my book:

http://www.sagehill.net/docbookxsl/PersonNames.html

Bob Stayton
Sagehill Enterprises
bobs< at >sagehill.net

--------------------------------------------------
From: "Brad Scott" <brad.scott< at >brambletye-publishing.co.uk>
Sent: Tuesday, May 14, 2013 7:05 AM
To: <docbook< at >lists.oasis-open.org>
Subject: [docbook] Punctuation after <surname>in <bibliomixed>?

RDFa Lite support in DocBook

Jirka Kosek — 2013-05-14T15:11:18


Hi,

it seems that Norm actually already played with this, see:

https://github.com/docbook/docbook/blob/master/relaxng/extensions/rdfalite/rdfalite.rnc

RDFa Lite attributes doesn't clash with existing DocBook attributes, so
we can simply add them. The only drawback will be that there will be 5
additional global attributes.

Jirka

AW: how to have a structure in the HTML output

2013-05-14T14:21:56

Sorry ... I found it:
<book>
<?dbhtml dir="UserGuide" ?>


Von: Sticker Markus EXT FRD EPOS
Gesendet: Dienstag, 14. Mai 2013 15:34
An: docbook< at >lists.oasis-open.org
Betreff: [docbook] how to have a structure in the HTML output

Hi,

I tried to find some information about the structure cleanup in the output files, but I didn't found the right one on the web.
Today I got my output in one flat folder, so the output structure looks like this:

Root
|-- [img]
 |     |-- img1.png
|     |-- img2.png
|     '-- img3.png
|
|-- Sample.html
|-- Sample_frame.html
|-- Sample_main.html
|-- styles.css
'-- popup.js

My goal is to have the output like this:

Root
|-- [etc]
 |     |-- styles.css
|     '-- popup.js
|
|-- [html]
 |     |-- Sample_frame.html
|     '-- Sample_main.html
|
|-- [img]
 |     |-- img1.png
|     |-- img2.png
|     '-- img3.png
|
'-- Sample.html

So maybe, somebody can give me an idea how to customize docbook.
Thanks and
Best regards

Markus Sticker

Punctuation after in ?

Brad Scott — 2013-05-14T14:05:04

We are using bibliomixed as the standard container for all reference 
items within a collection of humanities and social science texts.

The intent was to (effectively) take the text string as it appears in 
the print source and then apply the markup, leaving all the punctuation 
in situ as it appeared in print. So, starting with this:

Adamson, Sylvia, ‘The Literary Language’, in Suzanne Romaine (ed.), The 
Cambridge History of the English Language: Volume 4, 1776–1997 
(Cambridge, 1999), pp. 589–692

We apply markup:

<bibliomixed><bibliomset relation="article"><author><personname>Adamson, 
Sylvia</personname></author>, ‘<title>The Literary 
Language</title>’</bibliomset>, in <bibliomset 
relation="book"><editor><personname>Suzanne 
Romaine</personname></editor> (ed.), <title><emphasis role="italic">The 
Cambridge History of the English Language: Volume 4, 
1776–1997</emphasis></title> (<address><city>Cambridge</city></address>, 
<pubdate>1999</pubdate>)</bibliomset>, pp. 
<pagenums>589–692

how to have a structure in the HTML output

2013-05-14T13:33:49

Hi,

I tried to find some information about the structure cleanup in the output files, but I didn't found the right one on the web.
Today I got my output in one flat folder, so the output structure looks like this:

Root
|-- [img]
 |     |-- img1.png
|     |-- img2.png
|     '-- img3.png
|
|-- Sample.html
|-- Sample_frame.html
|-- Sample_main.html
|-- styles.css
'-- popup.js

My goal is to have the output like this:

Root
|-- [etc]
 |     |-- styles.css
|     '-- popup.js
|
|-- [html]
 |     |-- Sample_frame.html
|     '-- Sample_main.html
|
|-- [img]
 |     |-- img1.png
|     |-- img2.png
|     '-- img3.png
|
'-- Sample.html

So maybe, somebody can give me an idea how to customize docbook.
Thanks and
Best regards

Markus Sticker

Re: Academic publishing use of DocBook

Richard Hamilton — 2013-04-29T18:12:02

Hi Brad,

Welcome to the list. My experience with DocBook includes doing some books that are used as textbooks, though we haven't done anything quite as complex as what you describe below.

That said, we have used DocBook for books that had marginal notes, endnotes, and some pretty complex bibliographic entries. You will need to do some stylesheet customization to make some of those things look good, but I don't suspect that's a surprise:-).

You may want to check out the work of the DocBook Publisher's Sub-Committee at OASIS. This group addresses issues of interest to publishers and has developed extensions of the DocBook schema specifically for the publishing community. You can get more information about this sub-committee at: https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=docbook-publishers

If you've got questions about the DocBook schema, for example how to use mark up in a particular situation, this mailing list is a good place to go. 

If you've got questions about how to make the stylesh

Academic publishing use of DocBook

Brad Scott — 2013-04-29T13:31:25

Hi

I'm new to the list, if not to DocBook. I've been doing digital 
publishing stuff since the 90s, which often now includes helping 
publishers with data workflows, specs and documentation.

I was wondering if there are any folks out there who have experience of 
using DocBook for academic humanities and social science books. I'm keen 
to compare notes especially on any "standards" you may have adopted for 
some features, especially references and notes, and for more complex 
edition handling (distinguishing between authorial/editorial text, 
marginal notes, etc).

I've also got cases where I have endnotes, which also have surrounding 
editorial text, so one needs to be able to preserve the original context 
of the notes, as well as maintain the pointers to them in the text body.

I'm sure this isn't the first such use of DocBook, so I'm keen not to 
reinvent the wheel. I am, however, keen to develop some good examples.

Thanks

Brad Scott

e: brad.scott< at >brambletye-publishing.co.uk
LinkedIn: http://www.lin

RE: Customizing Xrefs to Appendices

Morgan Hayward — 2013-04-26T13:17:47

Absolutely brilliant.  That did the trick.  Thank you, Bob!

Regards,
Morgan

-----Original Message-----
From: Bob Stayton [mailto:bobs< at >sagehill.net] 
Sent: April-25-13 7:33 PM
To: Morgan Hayward; docbook< at >lists.oasis-open.org
Subject: Re: [docbook] Customizing Xrefs to Appendices

Hi Morgan,
I don't think you can do this with just the gentext mechanism.  In the l10n files, "l:context" is a named context for gentext, not the XML context of an element in the document hierarchy.  So that file cannot distinguish if a section is in an appendix or not.

When an xref is being resolved, the stylesheet locates the target element, and applies templates in mode="xref-to" to generate the text for it. 
Normally those templates apply templates in mode="object.xref.markup", which triggers the gentext process using the l:template for that element.

You can create a custom template in mode="xref-to" for sections in an appendix and assemble your custom text there.  Something like this:

<!-- the context node here is appendix/

Re: Customizing Xrefs to Appendices

Bob Stayton — 2013-04-25T23:33:24

Hi Morgan,
I don't think you can do this with just the gentext mechanism.  In the l10n 
files, "l:context" is a named context for gentext, not the XML context of an 
element in the document hierarchy.  So that file cannot distinguish if a 
section is in an appendix or not.

When an xref is being resolved, the stylesheet locates the target element, 
and applies templates in mode="xref-to" to generate the text for it. 
Normally those templates apply templates in mode="object.xref.markup", which 
triggers the gentext process using the l:template for that element.

You can create a custom template in mode="xref-to" for sections in an 
appendix and assemble your custom text there.  Something like this:

<!-- the context node here is appendix//section -->
<xsl:template match="section[ancestor::appendix]" mode="xref-to">

  <!-- generate the word "Appendix" -->
  <xsl:call-template name="gentext">
    <xsl:with-param name="key">appendix</xsl:with-param>
  </xsl:call-template>

  <xsl:text> </xsl:text>

  <!-- gener

Customizing Xrefs to Appendices

Morgan Hayward — 2013-04-25T20:46:17

In our DocBook customization, we've removed all section numbering in our appendices, but we still have xref's in some of our manuals that reference those sections.  They end up displaying as "Section E.3, 'Section Title'".  We would like them to display as "Appendix E, 'Section Title'".

I understand how to create an l:template for a specific element, but I'm lost when it comes to defining the context.  Does anyone know how to tell DocBook to use a different xref format for a section in appendix compared to a section in a chapter?

Thanks in advance for your help.

Regards,
Morgan


Morgan Hayward
Technical Writer, Documentation

RuggedCom, A Siemens Company
Office: (905) 482-4599 | Toll Free: 1 (888) 264-0006
300 Applewood Cres. Concord, Ontario L4K 5C7

[cid:image001.png< at >01CE41D3.BA7D6CD0]<http://www.ruggedcom.com/rss.xml> [cid:image002.png< at >01CE41D3.BA7D6CD0] <https://twitter.com/#!/RuggedCom>  [cid:image003.png< at >01CE41D3.BA7D6CD0] <http://www.linkedin.com/company/77282?goback=.fcs_GLHD_RuggedCom_false_*2_*

Re: Attribute Set for

Stefan Knorr — 2013-04-23T08:54:31

Hi Bob.

Thanks for your answer – I'll give this a rest, then.

Stefan.

Re: DB4 to DB5 conversion stylesheet

Alexey Neyman — 2013-04-22T18:05:08

Hi Bob,

Thanks. I've also made some other modifications in db4-upgrade.xsl, attached, so the 
full list of changes is:
- <productname>: do not discard all < at >class specifiers (but see below)
- <remark>: do not discard markup
- <title>, <subtitle>, <titleabbrev>: do not reposition titles inside <info>. Instead, in 
<title> template, verify if parent element XXX contains another title inside 
XXX/XXXinfo - if it does, complain and skip the title outside of <XXXinfo>
- <productname>, <orderedlist>, <literallayout>: Suppress attributes with default 
values added by DTD (<literallayout class="normal">, etc.)
- Add an ability to set a custom < at >version via stylesheet parameter
- Slightly change the criteria used for determining where < at >version is set - set it on the 
topmost element without a namespace, or topmost element with DocBook 
namespace (we have a few documents that include DocBook inside some other 
elements using non-DocBook namespaces)

Also attached is a Python script I wrote for cloaking the entities and

Re: Attribute Set for

Bob Stayton — 2013-04-22T17:38:17

Hi Stefan,
That would not work for everyone, because not everyone uses a watermark 
image for their draft mode.  I had a client whose draft page masters had 
"DRAFT" appearing rotated in the side margins and no watermark image.

The draft page masters may not be very different in the stock stylesheets, 
but they represent an opportunity for customizing with more extensive 
changes.

I certainly agree that it is burdensome to manage a complete set of draft 
and nondraft page masters, given the number of page masters and their 
properties, but I haven't figured out a way to simplify without losing 
individual customizability.

Bob Stayton
Sagehill Enterprises
bobs< at >sagehill.net

--------------------------------------------------
From: "Stefan Knorr" <sknorr< at >suse.de>
Sent: Sunday, April 21, 2013 9:50 AM
To: "Bob Stayton" <bobs< at >sagehill.net>
Cc: "DocBook List" <docbook< at >lists.oasis-open.org>
Subject: Re: [docbook] Attribute Set for

Re: Attribute Set for

Stefan Knorr — 2013-04-21T16:50:28

Hi Bob,

you're right of course. Sorry for the useless proposal.

Anyway, is there all that much of a difference between a normal
simple-page-master and a draft simple-page-master whose watermark has
been turned off? (My rather superficial diff seems to indicate that the
xsl:if in question is usually the only difference.)
So, how about only using the draft page-masters when the watermark image
is enabled, and using the normal masters when it isn't?
Or is that likely to be incompatible with overly many customisations?


Stefan.

Re: [docbook-tc] DocBook Technical Committee Meeting Minutes: 17 April 2013

Loren Cahlander — 2013-04-19T19:33:48

I am sorry that I was not on the call.  I was driving from Minneapolis, MN to Durham, NC for a new contract.

I will be attending the next call.

Regard,
Loren

Sent from my iPhone

On Apr 19, 2013, at 11:50 AM, "Bob Stayton" <bobs< at >sagehill.net> wrote:

DocBook Technical Committee Meeting Minutes: 17 April 2013
=============================================================

The DocBook Technical Committee met on Wednesday, 17 April 2013 at
1:00pm ET.

1. Roll call

Present: Dick Hamilton, Nancy Harrison,
Scott Hudson, Jirka Kosek, Larry Rowland, Bob Stayton

Regrets: Norm Walsh

Absent: Loren Cahlander

2. Accepted the minutes [1] of the previous meeting.

3. Next meeting: 15 May 2013

Scott gave regrets.

4. Review of the agenda.

Add item 7a, Moving Publishers Draft to OASIS standard.

5. Review of open action items

a.  Norm to publish an XSD for 5.1 when it is finished.
    CONTINUE

b.  Norm to follow up on OASIS mirroring the schema directory.
    CONTINUE

c.  Larry to try mapping slides to assembly.

DocBook Technical Committee Meeting Minutes: 17 April 2013

Bob Stayton — 2013-04-19T15:50:41

DocBook Technical Committee Meeting Minutes: 17 April 2013
=============================================================

The DocBook Technical Committee met on Wednesday, 17 April 2013 at
1:00pm ET.

1. Roll call

Present: Dick Hamilton, Nancy Harrison,
Scott Hudson, Jirka Kosek, Larry Rowland, Bob Stayton

Regrets: Norm Walsh

Absent: Loren Cahlander

2. Accepted the minutes [1] of the previous meeting.

3. Next meeting: 15 May 2013

Scott gave regrets.

4. Review of the agenda.

Add item 7a, Moving Publishers Draft to OASIS standard.

5. Review of open action items

  a.  Norm to publish an XSD for 5.1 when it is finished.
      CONTINUE

  b.  Norm to follow up on OASIS mirroring the schema directory.
      CONTINUE

  c.  Larry to try mapping slides to assembly.
      CONTINUE

  d.  Norm to clarify bridgehead entry in TDG to indicate
      that bridgeheads are not numbered like sections.
      CONTINUE

  e.  Norm to update The Definitive Guide that the
      behavior of nested links is undefined by th

RE: TDG 5: DocBook sources?

Michael Valent — 2013-04-19T08:44:54

Thanks a lot!

-----Original Message-----
From: Jirka Kosek [mailto:jirka< at >kosek.cz] 


http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/defguide5/

Re: Attribute Set for

Bob Stayton — 2013-04-18T16:19:13

Hi,
Yes, there is a reason: you cannot apply an attribute-set with xsl:if.  Many 
things in XSL would be simpler if you could.   If you need a conditional 
attribute set, you must either conditionalize the value of every attribute 
in the attribute-set (and you still get all the attributes), or you must 
create an awkward xsl:choose that generates the output element either with 
or without the attribute-set applied, and repeat the rest of the content in 
both.  The template with match="section" in fo/sections.xsl has such a 
construction for applying the different section level properties.

Bob Stayton
Sagehill Enterprises
bobs< at >sagehill.net

--------------------------------------------------
From: "Stefan Knorr" <sknorr< at >suse.de>
Sent: Thursday, April 18, 2013 6:47 AM
To: "DocBook List" <docbook< at >lists.oasis-open.org>
Subject: [docbook] Attribute Set for