Hi all,

There's a side issue with the webhelp-fast.xls: the sidebar ToC does not
expand to the currently viewed chapter if you use the navigation bar or
direct URLs to move between sections. It just shows a static, fully
collapsed ToC.

I have patched this with a javascript which auto-expands the sidebar ToC to
reveal the currently viewed section. The script is now up on GitHub at:
https://github.com/vkaroly/webhelp-expander

I'm quite curious to see how Mary dealt with this problem, as it would be
better to solve this in customization. I'm not sure if we really need all
the trouble with assigning and detecting unique IDs though: the script
works fine checking the reported URL of the current page against the URLs
the sidebar elements point to, it doesn't need any additional pointers
(generated ID and such). Maybe a similar solution can be applied to the
build logic?

Best regards,
Karoly

On Tue, Sep 9, 2014 at 11:41 AM, Fekete, Róbert <robert.fek...@balabit.com>
wrote:

> Hi Frank,
>
> using the webhelp-fast stylesheets from this thread reduces the build
> time immensely:
> https://lists.oasis-open.org/archives/docbook-apps/201310/msg00003.html
>
> (It does not solve the problem of including the ToC in every file, though.)
>
> Rober
>
> On Mon, Sep 8, 2014 at 4:14 PM, Wegmann, Frank
> <frank.wegm...@softwareag.com> wrote:
> > That is most interesting, especially now that I tested a worst-case
> scenario using a single <set> document being 42.6 MB large. This took full
> 12 hours to generate all HTML pages (yes, I used a larger JVM heap space).
> Now this is still something that could somehow be handled, not without
> pain, of course, but it's a question of job scheduling. However, the
> resulting HTML files all contain the complete TOC of the set so each of the
> 4,450 HTML files is around 200 kB, totaling 8.7 GB.
> > Perhaps I'm missing some runtime setting here, but of course the TOC
> should be present just once. Is that possible?
> > BTW, I also created a PDF file from the set: Processing time was
> adequate, but decent, and the 9,738 pages came out just fine.
> >
> > Now, Mary, if you managed to develop a solution that operates on book
> level but creates a WebHelp for a complete set, then it would be beneficial
> probably not only for me, if you could tell us about it.
> >
> > Thanks,
> > Frank
> >
> > -----Original Message-----
> > From: Mary Tabasko [mailto:taba...@telerama.com]
> > Sent: Samstag, 6. September 2014 01:42
> > To: docbook-apps@lists.oasis-open.org
> > Subject: RE: [docbook-apps] Fwd: Thanks!
> >
> > Frank Wegmann said:
> >
> >> our documentation sets often consist of many "modules"
> >> resulting in as many DocBook files (and as many PDF files), but to
> >> produce a single WebHelp for all of them it seems the only way is to
> >> wrap all DocBook files into a single <set>. Is that correct?
> >> Because I feel this is not really an option, since some sets comprise
> >> several thousand pages and we might run into serious performance
> >> trouble.
> >
> > That's exactly what we did. We have several "book"-level documents, from
> which we generate individual PDFs, and for the Webhelp (and for the MSHelp
> before it), we simply had a "set"-level document that included the
> "book"-level documents. For the product for which we did this, there were
> three PDFs, with page counts of (rounding up) 700, 800, and 40 (just 40)
> pages. These were wrapped into one "set" for one of our Webhelp
> "documents". I was able to keep the processing of this helpset (HTML and
> indexing) to about 2 minutes, though we are NOT profiling.
> >
> > Just for grins, I may try running one of our "monster" docs (we have a
> couple that are over 2000 pages as PDF) through it, but we have no plans to
> provide those as HTML, so I haven't bothered yet.
> >
> >> (And, Mary, yes, I'm quite obviously interested in your WebHelp
> >> experiences as well...)
> >
> > I'm amazed at the level of interest!
> >
> > I will put together my notes -- is it OK to send a PNG (screenshot) to
> this list, so you can see what it looks like??
> >
> >
> > -- Mary Tabasko
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
> > For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
> >
> >
> > Software AG – Sitz/Registered office: Uhlandstraße 12, 64297 Darmstadt,
> Germany – Registergericht/Commercial register: Darmstadt HRB 1562 -
> Vorstand/Management Board: Karl-Heinz Streibich (Vorsitzender/Chairman),
> Dr. Wolfram Jost, Arnd Zinnhardt; - Aufsichtsratsvorsitzender/Chairman of
> the Supervisory Board: Dr. Andreas Bereczky - http://www.softwareag.com
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
>
>

Reply via email to