Hi Hussein, I think I explained this poorly in the first email.
There are two issues I cannot resolve: 1) The two topics in the frontmatter do not publish in HTML. They are valid, and publish with the PDF output. 2) Does DITA Converter require a command line argument to create those two topics? If it does, then the syntax in the documentation is not clear to me and I could use a couple examples or another explanation. Thank you, Pat On Thu, Jul 3, 2025 at 3:18 AM Hussein Shafie <[email protected]> wrote: > I'm sorry but I cannot reproduce the problem you describe. I tried to > reproduce it using this bookmap: > --- > <?xml version="1.0" encoding="UTF-8"?> > <!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA BookMap//EN" > "http://docs.oasis-open.org/dita/dtd/bookmap.dtd";> > <bookmap xml:lang="en-US"> > <title>DITA sample topics and bookmap</title> > > <frontmatter> > <topicref href="dita-sample/readme.dita" > navtitle="Double-click this line to open" status="changed"/> > </frontmatter> > > <chapter chunk="by-topic" href="dita-sample/topic1.dita" > locktitle="yes"> > <topicmeta> > <navtitle>A sample <xmlelement>topic</xmlelement></navtitle> > </topicmeta> > > <topicref href="dita-sample/tables.dita"> > <topicmeta> > <navtitle>Tables</navtitle> > </topicmeta> > </topicref> > </chapter> > > <chapter href="dita-sample/task1.dita"/> > > <chapter href="dita-sample/reference1.dita"/> > > <appendix href="dita-sample/concept1.dita"/> > </bookmap> > --- > > I ran: > --- > ditac -f xhtml5 -frontmatter toc,figurelist -p chain-pages both -p > number all out/html/dita-sample.html dita-sample.ditamap > --- > > And I got a Table of Contents, a List of Figures, the frontmatter > section before the first chapter. > > > > --> The -frontmatter command-line option is useful in the case of a DITA > plain map. In the case of a bookmap, I would rather add a booklists to > the frontmatter. Example: > > --- > <frontmatter> > <booklists> > <toc/> > > <figurelist/> > </booklists> > > <topicref href="dita-sample/readme.dita" > navtitle="Double-click this line to open" status="changed"/> > </frontmatter> > --- > (booklists can be before or after your topicrefs.) > > Works fine too and this without any -frontmatter toc,figurelist > command-line option. > > > > --- > PS: Note that all the elements found in your DITA bookmap have class="- > XXX". This is not useful if your DITA source files start with a > <!DOCTYPE> (W2C XML schema and RELAX NG schema declarations work too). > This is quite error prone because if a @class value is incorrect (e.g. > missing space at the end of it), ditac will fail to process the element. > > > > Patrick W. wrote: > > Thank you for the assistance, Hussein. > > > > Can you also help clarify the command line syntax for frontmatter? I have > > read through and tried to interpret the command and examples in Chapter 3 > > of the DITA Converter documentation - > > > https://www.xmlmind.com/ditac/_distrib/doc/manual/commandLine.html#commandLine > > > > The client has a bookmap with a frontmatter section that does not > > publish, containing two topics. I cannot seem to find the correct command > > line instructions to generate the <frontmatter> topics in HTML. > > The (Windows) command line below produces the table of contents and a > list > > of figures. But when I add the -frontmatter option, no syntax variation I > > try seems to work. > > bin\ditac.bat -r resources -frontmatter toc,figurelist -addindex -plugin > > BRP -format html -p xsl-resources-directory res > > out\XYZ_Plugin\XYZSampleMap\index.html > > X0000447154_copy\BRX0000447154.ditamap > > > > Thank you for your help. > > Pat Wright > > > > > > The map is constructed: > > <booktitle class="- topic/title bookmap/booktitle "> > > <mainbooktitle class="- topic/ph bookmap/mainbooktitle ">Model > PRO > > 130 > > </mainbooktitle> > > </booktitle> > > ............................... > > <frontmatter class="- map/topicref bookmap/frontmatter " > id="X001048"> > > <topicref class="- map/topicref " format="dita" > > href="ARX0000447155.dita" id="d7013e15" > > navtitle="Operator’s Guide" scope="local" type="concept"> > > <topicmeta class="- map/topicmeta "> > > <navtitle class="- topic/navtitle ">Operator’s > > Guide</navtitle> > > </topicmeta> > > </topicref> > > <topicref class="- map/topicref " format="dita" > > href="ARX0000227596.dita" id="d7013e19" > > navtitle="Know Before You Go" scope="local" toc="no" > > type="concept"> > > <topicmeta class="- map/topicmeta "> > > <navtitle class="- topic/navtitle ">Know Before You > > Go</navtitle> > > </topicmeta> > > </topicref> > > </frontmatter> > > >
-- XMLmind DITA Converter Support List [email protected] http://www.xmlmind.com/mailman/listinfo/ditac-support
