quarto-dev / quarto-dev/quarto

VS Code extension: Outline incomplete

Open
#363 11 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
645
Forks
62
Avg merge
17h 42m
Merged PRs (30d)
13

Description

Especially in longer documents, the VS code extension shows the outline only up to a certain point of the document. All further headlines are not recognised as such.

The problem is caused by paragraphs with nested lists, when using a a second indented list level. The problem is also visible when looking at the icons for collapsing paragraphs as in the following example:

image

The last icon the extension shows is in line 333. The headings in line 340 and 344 don't have one. And these headlines starting from this point down to the end of the document don't show up neither in the outline (the document has over 800 lines with many more headlines).

When I collapse the document using the icon in line 333, it collapses the complete rest of the document (not only the few lines belonging to that list).

Unfortunately, the problem is difficult to reproduce. It happens only in longer documents. So I haven't been able to make a MWE. And it isn't caused by every nested list. There are several nested lists above line 333, which work perfectly.

Unindenting the list items in lines 333 and 334 solves the problem as the following screen shot shows. Here the headlines in lines 340 and 344 are identified as headlines (and have therefore an icon to collapse them):

image

Contributor guide

No contributing guide indexed for this repository

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.

Research direction

No source files, tests, or entry points are named. Start by reproducing the issue in the VS Code extension with a long document containing nested lists, then inspect outline and folding behavior around the problematic list; done means later headings appear in the outline and collapsing that list does not collapse the rest of the document.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript, vscode
Domain
developer-experience, tooling
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.