[Libreoffice-ux-advise] [Bug 150164] PDF exporter's "Export outlines as named destinations" does not export outlines, but bookmarks

[bugzilla-daemon at bugs.documentfoundation.org]

https://bugs.documentfoundation.org/show_bug.cgi?id=150164

--- Comment #12 from gabriel.crabbe at outlook.com ---
> Do you have any intuition/opinion about which might be a preferred choice?
> For example, would the first be less ambiguous than the second?

It's always hard to opine on how something might be perceived by someone
unfamiliar with the subject matter (https://xkcd.com/2501/ comes to mind). That
said, my impression is that "named destinations" is unambiguous enough by
itself.

To make it clear that the "PDF" is not disambiguating "named destinations", but
simply being explicit for maximum clarity (as tips are ought to do), one could
rephrase it as: 

  Enable the checkbox to export the bookmarks (targets of references) in your
  document as named destinations in the PDF.

> seems like it is included as a way to explain what "bookmarks" means -- but if
> that is the reason, it does not seem like a good use of extended tip.

My main concern was to disambiguate the term "bookmarks". I actually looked for
a definition that I could reuse in the "Insert Bookmark" help page
(https://help.libreoffice.org/7.5/en-US/text/swriter/01/04040000.html), but
could not find any.

I understand your reticence to define the term here, especially since it
doesn't seem to be defined anywhere else. Maybe "the bookmarks (not to be
confused with the headings)" as an explicit disambiguation? Another possibility
would be to only include the parentheticals (either one) in the help page but
not the tip.

> "You can then create URL links to these locations in the PDF document."

This is indeed more explicit. Perhaps even:

  This allows you to link to the corresponding locations in the PDF through an
  URL.

Putting it all together, I get:

  Enable the checkbox to export the bookmarks (not to be confused with the
  headings) in your document as named destinations in the PDF. This allows you
  to link to the corresponding locations in the PDF through an URL.

> You are welcome to change the summary, but nothing appears to have changed.

I changed the title from "PDF exporter's "Export outlines as named
destinations" should export outlines, not bookmarks" back to "PDF exporter's
"Export outlines as named destinations" does not export outlines, but
bookmarks". Is the change not visible to you?

> If you think the idea deserves consideration, then please file a new bug report.

I think it does, and it is my intention to do so as soon as this issue is
resolved. That way, I'm hoping to avoid most of the confusion surrounding the
term "bookmarks".

> Is the intended behavior of this option:
> (a) to only export LO bookmarks, or 
> (b) should "names of objects" be interpreted as referring to the "Name"
> property of images, tables, frames, and OLE objects, which could plausibly be
> exported as named destinations.

If it turns out that (b) is the desired behavior, I would advise to split it
into its own checkbox (i.e. make it a new feature, like the aforementioned
"export outlines") and keep the current behavior.

The reason for my concern is that, as I understand it, these names live in
different namespaces, which is not the case for named destinations. Therefore,
bookmarks with the same name as another object might have their named
destinations renamed, breaking existing references. The user should then be
given the option not to export unneeded destinations, hence the additional
checkbox.

-- 
You are receiving this mail because:
You are on the CC list for the bug.