adam/vscode-front-matter
1
0 Fork 0
mirror of https://github.com/estruyf/vscode-front-matter.git synced 2026-11-03 17:12:21 +01:00
Code Issues 77 Packages Projects Releases Wiki Activity

Enhancement: Make page title in lists configurable (title from front matter instead of folder/file name) #255

New Issue
Closed
opened 2026-10-05 02:36:04 +02:00 by adam · 3 comments
adam commented 2026-10-05 02:36:04 +02:00
Owner
Copy link
Copy source

Is your feature request related to a problem? Please describe.
This might be specific to GoHugo. On content lists in the side panel of the dashboard, I can see lists of "recently modified" pages. The list for the blog section (which is created from page bundles) looks relatively ok (using the folder name of each page bundle which is the title with dashes), the one for tags has _index.md as title.

Sample content structure in my website repo

Describe the solution you'd like
It might be useful if there would be a configuration option to tell Front Matter how to retrieve the title for lists. In most cases that might be the title frontmatter as opposed to file/folder names.

I can think of three values:

  • title of the file
  • title of the folder
  • title front matter value of markdown file in page bundle

I think it might be complicated to do when a page bundle has multiple markdown files. On the other side, the lists on the dashboard itself all have valid titles (even for the tags), so internally that information is somehow parsed/prepared.

Describe alternatives you've considered
There is no alternative in regards to GoHugo, as the tags-folder is an internal taxonomy and it can't be switched between single files or page bundles. It has to be tags/tagname/_index.md to work properly.

Additional context
20220412-19:44:55-Selection-001

**Is your feature request related to a problem? Please describe.** This might be specific to GoHugo. On content lists in the side panel of the dashboard, I can see lists of "recently modified" pages. The list for the blog section (which is created from page bundles) looks relatively ok (using the folder name of each page bundle which is the title with dashes), the one for tags has `_index.md` as title. [Sample content structure in my website repo](https://github.com/davidsneighbour/kollitsch.de/tree/main/content) **Describe the solution you'd like** It might be useful if there would be a configuration option to tell Front Matter how to retrieve the title for lists. In most cases that might be the `title` frontmatter as opposed to file/folder names. I can think of three values: - title of the file - title of the folder - title front matter value of markdown file in page bundle I think it might be complicated to do when a page bundle has multiple markdown files. On the other side, the lists on the dashboard itself all have valid titles (even for the tags), so internally that information is somehow parsed/prepared. **Describe alternatives you've considered** There is no alternative in regards to GoHugo, as the tags-folder is an internal taxonomy and it can't be switched between single files or page bundles. It has to be `tags/tagname/_index.md` to work properly. **Additional context** ![20220412-19:44:55-Selection-001](https://user-images.githubusercontent.com/83281/162966537-11cbce9f-aa49-4601-a5f8-ffe0733ec71c.png) <!-- github-sync-id:1201809854 -->
adam closed this issue 2026-10-05 02:36:04 +02:00
adam commented 2026-10-05 02:36:05 +02:00
Author
Owner
Copy link
Copy source

By default, the recently modified section will show the file name. If the file name is index.md, it will show the folder name instead. The reason why the current file or folder name is used, is for performance reasons, as otherwise an additional file read is required.

These _index.md index pages typically do not get changed, so will only appear in the list when you update them. We could include an additional read for these index pages, but not sure if this would be beneficial.

Question: Are you going to put additional content in your tags folder? Or is this only going to be used for the roll-up of your tags/taxonomy?

By default, the recently modified section will show the file name. If the file name is `index.md`, it will show the folder name instead. The reason why the current file or folder name is used, is for performance reasons, as otherwise an additional file read is required. These `_index.md` index pages typically do not get changed, so will only appear in the list when you update them. We could include an additional read for these index pages, but not sure if this would be beneficial. Question: Are you going to put additional content in your `tags` folder? Or is this only going to be used for the roll-up of your tags/taxonomy? <!-- github-comment-id:1096742651 -->
adam commented 2026-10-05 02:36:06 +02:00
Author
Owner
Copy link
Copy source

I am adding content for the tags that are important. This is mostly used to have an introduction or a "tag thumbnail" defined via frontmatter.

I think in regards to GoHugo it might make sense to copy the treatment of index.md to _index.md. They are relatively similar in regards to their contents.

PS: The thing is, in any other usage of _index.md in GoHugo it's an index file, or collection, in sense of a list page. For taxonomies it's the content file. That might even be an issue that GoHugo could fix by using index.md instead of the underscored file name.

see: https://gohugo.io/content-management/taxonomies#add-custom-metadata-to-a-taxonomy-or-term

I am adding content for the tags that are important. This is mostly used to have an introduction or a "tag thumbnail" defined via frontmatter. I think in regards to GoHugo it might make sense to copy the treatment of `index.md` to `_index.md`. They are relatively similar in regards to their contents. PS: The thing is, in any other usage of `_index.md` in GoHugo it's an index file, or collection, in sense of a list page. For taxonomies it's the content file. That might even be an issue that GoHugo could fix by using `index.md` instead of the underscored file name. see: https://gohugo.io/content-management/taxonomies#add-custom-metadata-to-a-taxonomy-or-term <!-- github-comment-id:1096772699 -->
adam commented 2026-10-05 02:36:07 +02:00
Author
Owner
Copy link
Copy source

Will be testable in the latest beta

Will be testable in the latest beta <!-- github-comment-id:1096854080 -->
Sign in to join this conversation.
No Branch/Tag Specified
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
adam (Adam Wojcieszonek)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: adam/vscode-front-matter#255