I think the confusion and difficulty might be that the Index Topic has to be in a certain format, and this is not completely clearly stated in the documentation (top post)
I had installed this plugin myself, carefully following the instructions, but it wasn’t working in exactly the same way @dennisjbr was experiencing.
It might help to have an example of the Markdown required rather than linking to the Meta example, because the only key rule is that there MUST be a Markdown bulleted/numbered list. The docs say ‘a list’ but the word ‘list’ has an ordinary English usage which includes non-Markdown lists!
This will work as an Index Topic:
* https://meta.discourse.org/t/discourse-doc-categories/322376
* Some Arbitrary Text: https://meta.discourse.org/t/discourse-doc-categories/322376
This will not work:
https://meta.discourse.org/t/discourse-doc-categories/322376
Some Arbitrary Text: https://meta.discourse.org/t/discourse-doc-categories/322376
Beyond this you can use Markdown headings to create sections and use multiple lists, but nothing will appear in the sidebar unless there’s a Markdown list. I appreciate this is a bit obvious and may not have tripped up anyone else, but it did catch me out (stupidly or not) and I’m not new to Discourse, TCs and Plugins.
I have an AI persona for my documentation category. Has there been any thoughts on making an AI persona available for anons? I think at least, in a temporary, anonymous chat DM? Is this even possible?
When you visit a page that is very low in the index (requires scrolling to reach), the main page is also scrolled down to a position somewhere in the middle: for example on this doc item
Actually one should never consider something is “Obvious” when documenting anything. This kind of feedback is vital on any type of project to ensure clarity.
Anything written will typically make sense to the author due to their deep understanding of what they wrote. To others on the other hand it maybe less clear.
I myself dislike terms like “intuitive” as something is only intuitive if one has experiences using something similar.
NOOB here so I apologize in advance! I have been trying to figure this out on my own for a while now but I can’t find a solution anywhere.
I am trying to use this plug-in as a way to organize individuals user projects at the category level.
We are trying to create a forum that will have a bunch of different user projects on it. We originally had them all under category of “projects”, so when someone would click on projects they would see all the subcategory boxes listing out all the individual projects in a pretty UI look and feel (sudo project marketplace).
But by doing that we lose that one level of data organization because the individual projects start as subcategories instead of categories.
I was super excited when I found this plugin because I figured it would be perfect for organizing all the projects at the category level allowing us to have better data organization within the projects.
So I’m now creating individual projects as individual categories (fishing lure, project 2, project 3) and using the doc categories plug into basically create a table of contents of all the projects so that people can click on the new projects category that’s being run by the doc cat plugin and use the drop down menu to navigate through the subcategories and topics that we choose to list in the index topic.
Is there a way to have categories displayed in the middle column so that it resembles the view of “all categories” page in the normal discourse feed?
I want to have it so that when I click on the projects doc category that it lists all the projects on the left in the menu but then also displays them in the boxes in the main feed just like it does normally with subcategories. I was only allowed to put one image on this post so I put the image of the projects in the menu on the left and I would like to have the category boxes showing in the middle where my topic post is showing.
Since relative linking already works. Why not add it and eliminate any work from being needed needlessly? These are internal links after all and this would contribute to discourse’s parity as internal links also works variety of TC & plugins.
Thanks Hugh!
What you guys are doing with the subcats is on the right path, but I mainly wanted to get the UI to show Categories in the boxes in the middle column like it does with subcats.
I ended up finding and installing the sub-sub-cat plug-in. So now I’m using that plug-in to help me group subcategories so they are really acting as ‘categories’ because we have two levels of data distribution below them sub-sub-cats, and topics.
This met my main goal of increasing the amount of data distribution and organization levels within our user projects. So now I’m using the sub sub categories along with the plug-in to get the best of both worlds at the stub category level.
I was trying to create the project category with just the duck categories plug-in, but we didn’t like the UI of having just a menu off the left and nothing in the middle for the user to browse. So, I wanted to get the (projects which are categories) to display within a Category (all projects) like the subcats can do normally. (my pic in the last post of my mockup)
