docfx icon indicating copy to clipboard operation
docfx copied to clipboard

[Bug] The title is not displayed in the bookmark hierarchy in a PDF document

Open MrDmitrij opened this issue 1 year ago • 5 comments

Describe the bug A title starting with the Cyrillic characters "Ш" or "Щ" is not displayed in the bookmark hierarchy of a PDF document. image

To Reproduce

  1. Create a TOC file with a name starting with the Cyrillic characters "Ш" or "Щ". image

  2. Follow the instructions to generate a PDF from the documentation.

  3. Open the PDF file and view the bookmark hierarchy.

Expected behavior The bookmark hierarchy in PDF should be displayed correctly using the Cyrillic characters "Ш" or "Щ".

Context (please complete the following information):

  • OS: Windows
  • Docfx version: [e.g. 2.75.3]

MrDmitrij avatar Mar 06 '24 16:03 MrDmitrij

A title starting with the Cyrillic characters "Ш" or "Щ" is not displayed in the bookmark hierarchy of a PDF document.

~~On my environment. it can't reproduce problems.|~~ ~~I've create toc files that contains "Ш" /"Щ" chars and save file with UTF-8 encoding.~~ ~~Is it able to provide minimum reproducible source files?~~

It can be reproduced by following toc.yml file.

- name: Introduction
  href: introduction.md
- name: Getting Started
  href: getting-started.md
- name: Ш
  href: getting-started.md

filzrev avatar Mar 07 '24 10:03 filzrev

Yes, the name of the TOC node must begin with the characters "Ш" or "Щ".

MrDmitrij avatar Mar 07 '24 11:03 MrDmitrij

PDF bookmarks problems seem to be caused by PdfPig library. I've created a separate issue at PdfPig repository. https://github.com/UglyToad/PdfPig/issues/789

filzrev avatar Mar 09 '24 11:03 filzrev

PdfPig bookmark problems are resolved by #9783.

This issue will be resolved in next docfx release.

filzrev avatar Mar 12 '24 07:03 filzrev

Проблемы с закладками PdfPig решены с помощью #9783 .

Эта проблема будет решена в следующем выпуске docfx.

Thank you very much for your wonderful work!)

@filzrev, please tell me when docfx is planned to be released?

MrDmitrij avatar Mar 12 '24 08:03 MrDmitrij

It's expected to be fixed with latest docfx version (v2.76.0).

@MrDmitrij Is it able to confirms problems are fixed in latest version?

filzrev avatar Apr 08 '24 23:04 filzrev

It's expected to be fixed with latest docfx version (v2.76.0).

@MrDmitrij Is it able to confirms problems are fixed in latest version?

@filzrev Yes, the problems are fixed in the docfx version (v2.76.0). Everything works well.

Thank you for your excellent work! =)

MrDmitrij avatar Apr 29 '24 07:04 MrDmitrij

@MrDmitrij Thanks for your confirmation. Please close issue if no additional problems.

filzrev avatar Apr 29 '24 10:04 filzrev