Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Titles: front-matter and headings not in the toc #50

Open
eine opened this issue Jan 8, 2020 · 1 comment
Open

Titles: front-matter and headings not in the toc #50

eine opened this issue Jan 8, 2020 · 1 comment

Comments

@eine
Copy link
Contributor

eine commented Jan 8, 2020

This issue is to ask two questions about titles in this theme.

On the one hand, title fields in the front-matter of markdown files in content seem to be ignored. I removed them and I found no difference in the output. If this is the expected behaviour, I'd ask to consider changing it so that title fields are used as # headings. Naturally, this would imply removing explicit # headings, to avoid duplication.

On the other hand, I didn't find how to add headings which are not included in the TOC (sidebar). I could use <h1>Title</h1> instead of # Title. However, doing so breaks the dynamic behaviour of the sidebar: level 1 items are shown only, none of them is expanded/collapsed.

Hence, I think that these two questions might be tightly related, since applying the former would probably break the sidebar.

@bep
Copy link
Owner

bep commented Jan 8, 2020

This is more or less a direct port of Slate, and I think this behaves the same here as there. I haven't thought too hard about this, but changing this would certainly be a somewhat breaking change. If enough people shout "yes, please", then we can do it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants