Bob Stayton | 27 May 19:51 2015
Picon

DocBook Technical Committee Meeting Minutes: 27 May 2015

DocBook Technical Committee Meeting Minutes: 27 May 2015
=============================================================

The DocBook Technical Committee met on Wednesday, 27 May 2015
at 1:00pm ET.

1. Roll call

Present: Dick Hamilton, Scott Hudson, Larry Rowland,
Bob Stayton, Norm Walsh

Regrets: Jirka Kosek

2. Accepted the minutes [1] of the previous (March) meeting.

3. Next meeting: 17 June 2015

This was changed to 24 June 2015.

4. Review of the agenda.

No new items.

5. Review of open action items

   a.  Norm to convince someone to implement the new XInclude
       standard.
       CONTINUED

   b.  Bob to integrate publishers XSL into DocBook XSL.
(Continue reading)

Bob Stayton | 26 May 19:00 2015
Picon

DocBook Technical Committee Meeting Agenda: 27 May 2015

DocBook Technical Committee Meeting Agenda: 27 May 2015
=============================================================

The DocBook Technical Committee will meet on Wednesday, 27 May 2015
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 (March) meeting.
3. Next meeting: 17 June 2015
4. Review of the agenda.
5. Review of open action items

   a.  Norm to convince someone to implement the new XInclude
       standard.
(Continue reading)

Daniel Pocock | 26 May 17:04 2015

bookinfo author blog URLs


Hi,

In the bookinfo <author/> element, is there a recommended way to add
URLs for an author's home page, blog, etc?

Regards,

Daniel
Bob Stayton | 23 Mar 16:44 2015
Picon

DocBook Technical Committee Meeting Agenda: 25 March 2015

DocBook Technical Committee Meeting Agenda: 25 March 2015
=============================================================

The DocBook Technical Committee will meet on Wednesday, 25 March 2015
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 (January) meeting.
3. Next meeting: 15 April 2015
4. Review of the agenda.
5. Review of open action items

   a.  Norm to work with OASIS to advance DocBook 5.1 to
       OASIS Standard.
(Continue reading)

Chet Ensign | 20 Mar 18:16 2015

Your Public Review for DocBook Version 5.1 has been announced

Members of the DocBook TC,

Your 30 day public review for DocBook Version 5.1 has been announced. The review ends on April 21st. You can find the announcement at https://www.oasis-open.org/news/announcements/30-day-public-review-for-docbook-v5-1-ends-april-21st.  

I have announced the public review to the membership and also tweeted it and posted the news on LinkedIn. Feel free to like/share/retweet/etc. to further spread the news. 

Also, because it has been a long time since your last public review, please review and keep in mind the OASIS requirements for handling comments as spelled out in [1]. 

- Non-TC member feedback can only be submitted to the TC's comment list docbook-comment <at> lists.oasis-open.org. The TC must have someone subscribed to this mail list to monitor comments. 

- All submitted comments must be acknowledged by the TC. 

- The TC needs to maintain a log of all comments received and their resolutions. The comment resolution log will need to be available when you begin your next public review or take other action on draft. A simple comment resolution log template is available in OpenDocument [2] and Office [3] format. 

Congratulations on getting this started. It is a great step forward. Let me know if you have any questions regarding the review or next steps.

=== Additional references:



--

/chet   [§] 
----------------
Chet Ensign
Director of Standards Development and TC Administration 
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393 

Check your work using the Support Request Submission Checklist at http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html 

TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin

Follow OASIS on:
LinkedIn:    http://linkd.in/OASISopen
Twitter:        http://twitter.com/OASISopen
Facebook:  http://facebook.com/oasis.open
Chet Ensign | 20 Mar 18:01 2015

30-day Public Review for DocBook V5.1 - ends April 21st

OASIS members and other interested parties, 

The OASIS DocBook TC [1] members have recently approved a Committee Specification Draft (CSD) and submitted it for 30-day public review:

DocBook Version 5.1
Committee Specification Draft 01 / Public Review Draft 01
11 Feb 2015

Overview:

DocBook is a general purpose [XML] schema particularly well suited to books and papers about computer hardware and software (though it is by no means limited to these applications). 

The Version 5.1 release introduces assemblies for topic-oriented authoring. It also addresses a selection of bugs and feature requests. 

The Technical Committee provides the DocBook 5.1 schema in other schema languages, including W3C XML Schema and an XML DTD, but the RELAX NG Schema is the normative schema. 

TC Description: 

The DocBook Technical Committee maintains the DocBook family of schemas. 

Public Review Period:

The public review starts 23 March 2015 at 00:00 UTC and ends 21 April 2015 at 23:59 UTC. 

This is an open invitation to comment. OASIS solicits feedback from potential users, developers and others, whether OASIS members or not, for the sake of improving the interoperability and quality of its technical work.

Reviewers may provide comments directly from the comment-tag version of document. The file

docbook-v5.1-csprd01-COMMENT-TAGS.html

contains the HTML version of the draft with a “[comment?]” link next to each section heading. Clicking on this link will launch your email application and begin a message to docbook-comment <at> lists.oasis-open.org with the specific section number and title in the subject line. Simply enter your comment and click send.

Note that you must be subscribed to the comment mailing list before sending feedback. Instructions on how to subscribe can be found at https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=docbook.

URIs:

The prose specification document and related files are available here:

HTML (Authoritative):

HTML with inline tags for direct commenting:

Editable source: 

PDF: 

RELAX NG Schemas: 

Schematron Schemas:

XML Catalog:

NVDL Schema:

DocBook V4.x conversion tools:

ZIP distribution file (complete):

For your convenience, OASIS provides a complete package of the prose document and related files in a ZIP distribution file. You can download the ZIP file here:


Additional information about the specification and the OASIS DocBook TC can be found at the TC's public home page:


Comments may be submitted to the TC by any person through the use of the OASIS TC Comment Facility which can be used by following the instructions on the TC's "Send A Comment" page, or directly at:


Comments submitted by TC non-members for this work and for other work of this TC are publicly archived and can be viewed at:


All comments submitted to OASIS are subject to the OASIS Feedback License, which ensures that the feedback you provide carries the same obligations at least as the obligations of the TC members. In connection with this public review of "DocBook V5.1", we call your attention to the OASIS IPR Policy [2] applicable especially [3] to the work of this technical committee. All members of the TC should be familiar with this document, which may create obligations regarding the disclosure and availability of a member's patent, copyright, trademark and license rights that read on an approved OASIS specification. 

OASIS invites any persons who know of any such claims to disclose these if they may be essential to the implementation of the above specification, so that notice of them may be posted to the notice page for this TC's work.

========== Additional references:

[1] OASIS DocBook TC


RF on Limited Terms 

--

/chet  
----------------
Chet Ensign
Director of Standards Development and TC Administration 
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393 

Check your work using the Support Request Submission Checklist at http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html 

TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin

Follow OASIS on:
LinkedIn:    http://linkd.in/OASISopen
Twitter:        http://twitter.com/OASISopen
Facebook:  http://facebook.com/oasis.open
Test User | 26 Feb 18:07 2015
Picon

Status of bug #281: allow xi:include in set

Hello All,

It was reported that xi:include was not allowed in <set>. At
http://sourceforge.net/p/docbook/rfes/281/ it says that the bug is
"fixed for 5.1".

When jing validates my document against the DocBook 5.1CR3 RELAX NG
schema (docbookxi.rng), it reports:
docs.xml:8:34: error: element "xi:include" not allowed here; expected
the element end-tag or element "setindex"


   ,----
   | <?xml version="1.0"?>
   | <set xmlns="http://docbook.org/ns/docbook"
   |      xmlns:xi="http://www.w3.org/2001/XInclude"
   |      xml:lang="en"
   |      version="5.0">
   |   <info>
   |     <title>Set title</title>
   |   </info>
   |   <xi:include href="book1.xml"/>
   |   <xi:include href="book2.xml"/> <!-- line 8 -->
   | </set>
   `----
The document will validate if there is only one xi:include in the <set>
so the sample document above is illegal.

Is there in fact a version of the DocBook schema that will accept the
document above?

Regards,
Test User.
Bob Stayton | 18 Feb 19:13 2015
Picon

DocBook Technical Committee Meeting Non-Minutes: 18 February 2015

No meeting in February as we failed to reach quorum.

Norm earlier reported that he submitted the appropriate tickets to OASIS 
to begin the Docbook 5.1 standards process.  We will discuss its 
progress next month.

--

-- 
Bob Stayton
Sagehill Enterprises
bobs <at> sagehill.net
Chet Ensign | 17 Feb 21:30 2015

Your request for CSD and 30 day public review for DocBook v5.1 has been received

Members of the DocBook TC, 

Your requests to publish the Committee Specification Draft for DocBook v5.1 and release it for public review have been received. You can find the TC Admin JIRA tickets tracking this at https://issues.oasis-open.org/browse/TCADMIN-2077 and https://issues.oasis-open.org/browse/TCADMIN-2078

I will let you know when we start work on these tickets. Should be in a day or two. Meanwhile, let me know if you have any questions on the tickets or the next steps. 

--

/chet   [§] 
----------------
Chet Ensign
Director of Standards Development and TC Administration 
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393 

Check your work using the Support Request Submission Checklist at http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html 

TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin

Follow OASIS on:
LinkedIn:    http://linkd.in/OASISopen
Twitter:        http://twitter.com/OASISopen
Facebook:  http://facebook.com/oasis.open
Markos | 17 Feb 20:01 2015
Picon

Re: Translate words in html files.

On 17-02-2015 13:46, Michael.Urban <at> jpl.nasa.gov wrote:
> Your message dated: Tue, 17 Feb 2015 12:45:42 -0200
>    
>> Hi,
>>
>> Which document I need to edit to change the words that are generated in
>> html format?
>>
>> I don't know the details of the Docbook structure. I'm just a user.
>>
>> For example, I would like to produce html documents in Esperanto, then I
>> would like to change:
>>
>> *Table of Contents ->  Indekso
>>      
> I looked into doing this some years ago but could not get a consensus
> from Esperantists on best translations.  Anyway, I think you want to add
> a file, eo.xml, to the stylesheet's 'common/' directory, and add a
> suitable line to l10n.xml
>
> (Is 'indekso' the right word for 'Table of Contents'?  Isn't 'Enhavoj'
> better?  'Next' could better be 'sekva' or even 'sekve')
>
>
>    
Hi Michael and Bob

I discovered that there is already an eo.xml file in the directory:
/usr/share/xml/docbook/stylesheet/docbook-xsl/common

But when I put in the header of the source text (hackakvoj.xml) the 
<article lang = "eo"> the following error appears:

$ jw hackakvoj.xml
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#html
Working on:
/home/nei/c2o/fontes_xml/eo/akvo/hackakvoj/hackakvoj.xml
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/dbl10n.dsl:280:10:E: 
L10N ERROR:
generate-toc-in-front
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/dbl10n.dsl:425:12:E: 
L10N ERROR:
gentext-intra-label-sep
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/dbl10n.dsl:472:12:E: 
L10N ERROR:
gentext-label-title-sep
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/dbl10n.dsl:425:12:E: 
L10N ERROR: gentext-intra-label-sep
<DIV
CLASS="mediaobject"
 ><P
 ><IMG
SRC="bildoj/email_graf.png"></P
 ></DIV
 ><P
 >&#13;</P
 >Done.

Should I change in the header of  source file the line?
"/usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd"

Any tip?

Thanks,
Markos

Source file (hackakvoj.xml):

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"/usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd">

<article lang="eo">

<articleinfo>
<title>Water - AKVO - Integrada Rigardo</title>
<authorgroup>
<author><firstname>Markos</firstname>
<affiliation>
<address>
</address>
</affiliation>
</author>
</authorgroup>
<pubdate>Januaro 2015</pubdate>
</articleinfo>

<sect1>
<title>Sugestoj estas bonvena!</title>
<figure><title>retadreso:</title>
<mediaobject>
<imageobject>
<imagedata fileref="bildoj/email_graf.png"/>
</imageobject>
</mediaobject>
</figure>
</sect1>

<sect1>
<title>Akvo - kio estas?</title>
<para></para>
</sect1>

</article>
Markos | 17 Feb 15:45 2015
Picon

Translate words in html files.

Hi,

Which
document I need to edit to change the words that are generated in html format?

I don't know the details of the Docbook structure. I'm just a user.

For example, I would like to produce html documents in Esperanto, then I would like to change:

Table of Contents -> Indekso
Revision History -> Revizioj
Prev -> Antaŭa
Home -> Hejmo
Next -> Proksima
Bibliography -> Bibliografio
Books -> Libroj

And so on.

Any help?

Thanks,
Markos



Gmane