[XXE] titlepage generation (XMLmind 5.4.1)

2013-11-26 Thread Jeff Hooker
Hello Hussein,

I’m using XMLmind > Convert to generate both webhelp and javahelp from 
ditamaps, but am having a small issue with the title page.

PMC uses a custom element in the bookmeta area (pmc_iso) to store its ISO 
information, which is what I want to reproduce on the titlepage and in the 
footers (yes, know the footers are going to be an issue). I have the content 
reproducing on the title page, but my questions are as follows:


1.   How do I make the title page the first link of TOC? At the moment is 
just floats in the project, and if I didn’t go looking for it in the directory 
of HTML produced by the ditac I’d never know it existed.

2.   There is a persistent “Legal Notice” title on the titlepage that I 
can’t seem to eradicate; I can find where it is sourced from in the 
localization strings, but can’t see how it’s ending up on the title page. I see 
nothing in the ditamap that should be triggering this. I have found and 
modified the autoTitlePage template to draw in my ISO information, but can’t 
figure out where the Legal Notice information title is being called.

Thanks,
Jeff.

Jeff Hooker, Technical Leader, Technical Communications
PMC-Sierra, Inc., 8555 Baxter Way, Burnaby BC  V5A 4V7
(Tel)  604.415.6000 x 2625
(Cell) 778-855-7406



--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Re: [XXE] titlepage generation (XMLmind 5.4.1)

2013-11-26 Thread Hussein Shafie

On 11/26/2013 05:32 PM, Jeff Hooker wrote:


I’m using XMLmind > Convert to generate both webhelp and javahelp from
ditamaps, but am having a small issue with the title page.

PMC uses a custom element in the bookmeta area (pmc_iso) to store its
ISO information, which is what I want to reproduce on the titlepage and
in the footers (yes, know the footers are going to be an issue). I have
the content reproducing on the title page, but my questions are as follows:

1.How do I make the title page the first link of TOC? At the moment is
just floats in the project, and if I didn’t go looking for it in the
directory of HTML produced by the ditac I’d never know it existed.


There is no real ``title page'' in XHTML-based formats like  webhelp and 
javahelp. You are in fact talking about what's generated before the 
frontmatter topics. Let's call this: the ``title page'' chunk.


The ``title page'' chunk is not intended to be part of the TOC. So what 
you want is not possible without modifying the XSLT stylesheets.


However it's possible to have frontmatter topics which immediately 
follow the ``title page'' chunk and which will be output in the same 
HTML page (preferably called "index.html") to be part of the TOC.


This can be achieved by a clever use of:

* chunk="to-content"

* copy-to="index.html"

* XSLT stylesheet parameter extended-toc=both (not sure this is 
supported  by the version of ditac which is included in XXE 5.4.1). See 
http://www.xmlmind.com/ditac/_distrib/doc/manual/xsltParams.html#xsltParams__extended-toc


Actual example:

---
  

  
...



  
---

which gives you:

* http://www.xmlmind.com/ditac/_distrib/doc/manual/webhelp/index.html

* http://www.xmlmind.com/ditac/_distrib/doc/manual/manual.jar





2.There is a persistent “Legal Notice” title on the titlepage that I
can’t seem to eradicate; I can find where it is sourced from in the
localization strings, but can’t see how it’s ending up on the title
page. I see nothing in the ditamap that should be triggering this. I
have found and modified the autoTitlePage template to draw in my ISO
information, but can’t figure out where the Legal Notice information
title is being called.



“Legal Notice” is the title which is automatically generated for a 
referencing a notices topic (see 
http://docs.oasis-open.org/dita/v1.2/os/spec/langref/notices.html). For 
example a .ditamap containing something like this:


---

  ...
  
  ...

---

or like this:

---

  ...
  
  ...

---

--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support