API Reference page title has large space before it

[has2k1]

Currently, the rendering of the API Reference / Index page is completed in the Blueprint. This part puts together the title and the rest of the page content; and a Renderer cannot affect this markup.

quartodoc/quartodoc/autosummary.py

Lines 645 to 651 in bfa8e8c

	_log.info("Summarizing docs for index page.")
	content = self.renderer.summarize(blueprint)
	_log.info(f"Writing index to directory: {self.dir}")
	final = str(
	Blocks([Header(1, self.title, Attr(classes=["doc", "doc-index"])), content])
	)

As a result, in qrenderer we cannot generate the right markup to avoid that different way quarto handles a title specified in the yaml frontmatter verses one that is derived from the top-level (#) header.

We can see the effect in these two pages.

quartodoc:

quarto:

Ref: #320 (comment)

[machow]

Ah shoot -- I noticed this recently in another package. I don't mind switching it so that rather than a # it sets a topmatter with title. quartodoc is not at a point where it intends to make everything extendable, so making the blueprint process accessible in the renderer is not a priority, but I'm happy to address any issues in behavior / bugs.

(I think quarto changed how it processes pages, so the # initial header is no longer read as a title)