Tags System

[SnowyJaguar1034]

I really like the look and feel of WikiDocs for my homelab but the one pain point I have is the lack of a tags system; for example I have the following sections:

• hardware
• software
• services

"Server A" would likely make an appearance in all 3 sections:

• the hardware components it has,
• the software it runs and;
• the services it provides.

At the moment, there's no way I can easily tie all these different places together, in an intuitive way at least. I could manually write tags in the top or bottom of the content files but I see that as error prone.

My idea, since the directory's already map out the content structure, is to add a tags.[insert filetype] or options.[insert filetype] to the directory's. These could be edited via the same WYSIWYG editor, maybe in a submenu or side panel, and be invisible to the user.

My reason for options.[insert filetype] is that you could use this to declare other customisations for a page, such as:

• a different slug
• a different colour
• the pages tags
• a option to hide the page from the nav bar (making it only accessible via a link)

My initial thought for the filetype was .yml but i guess .env, .toml or really anything else could work. These properties could be declared in a high level file in the root directory but I think shorter documents in each content directory better fits with the current file structure.

Edit 01: Just to be clear this discussion page is focusing on the tag system idea, the other usecases of an options file are merely examples I thought could justify it.

Edit 02: Misc formatting and spelling fixes

Edit 03: Sentence structure edits to make the paragraphs more readable.

[Zavy86]

very interesting, we have to brainstorm a little to find the best implementation way..

[SnowyJaguar1034]

Thanks for considering the idea! 😄
I know the implementations I proposed may not be the best but I'd welcome feedback once you've had a chance to brainstorm.

[SnowyJaguar1034]

@Zavy86 I don't mean to be pushy snd I know development takes time but; I was wondering if you (or maybe one of the other contributers have had a chance to brainstorm a little on a implementation method for this?
I've seen an "issue" for creating shirtger slugs so maybe this could tie in to that in some way

[leomoon]

So the main focus of wikidocs is portability and not having a DB.

Not having a DB introduces some challenges like adding a tag feature.

I'll see how we would do this.

[Zavy86]

maybe like the sitemap we can parse all documents searching for #tags, build an array and store it into a JSON file..
but if the wiki has many files we could get some performance issues!
or parse only the current file when saving and append data to the JSON tags index file?

possible file structure:

[
{
"doc": "homepage"
"tags": [
"home",
"wiki"
]
},
{
"doc": "path/of/doc"
"tags": [
"test"
]
}
]

or simply use the search function to search hashtags without indexing?