tarantool / tarantool/doc

Fix TOC in PDF assembly

Open
#4,195 0 comments 0 reactions 1 assignee View on GitHub

@lastoCHka42 is already working on this.

Since May 16, 2024.

internal
Dominant language
CSS
Stars
15
Forks
49
Avg merge
1d 13h
Merged PRs (30d)
3

Description

Problem: In all PDF files we have problems with subsections of the 1st section. Instead of staying subsections, they are promoted to the section level. For example, this structure:

1. Section
    1.1. Subsection A
    1.2. Subsection B
2. Section

is represented like this:

1. Section
2. Subsection A
3. Subsection B
4. Section

This affects not only TOC representation. The entire document is assembled with the wrong structure and section numbers.

Known workaround: create an empty file and define it as the first section in toctree.rst.

Reviewer: @lenkis

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.