Displaying "full topic" text on category page + access to subcategory from menu bar

In my community we have a very large FAQ. To make each question more easily accessible (for linking), we have broken it down into separate topics in a FAQ subcategory (it’s part of the “learning” top-level category).

Here’s what it looks like now, with the Air Theme and Categories Navbar component.

I’m trying to figure out how to do two things (neither look straightforward)

  1. add direct access to subcategories in the navbar through a dropdown
  2. display the topics in “full-text” mode, on desktop as well as mobile, so that people can just scroll down without opening the topics and read through everything if they feel so inclined.

How would you manage this?

Here’s what it looks like now:

And link if you want to see directly: FAQ - Diabète Félin

Thanks for your help!

Since that’s a separate component, you’d likely need to ask on the component’s topic.

So you want the full topic post to be in the topic card, not the excerpt?

The solution might require using another component I’m afraid :-/

Exactly — just like on a blog you would be able to display full posts on the home page rather than excerpts.

OR some other way to « collate » all the topics (without replies) into one single page.

I believe both can be done with Theme Components.

This might pose some performance issues since all topic posts are displayed (but can be mitigated with lazy loading?). If you have many topic’s like Meta, this might become unfeasible (unless you load more topics as the user reaches the bottom).

1 Like

It’s just for this category and maybe a couple of others with a limited number of topics.

So… I need to learn how to develop theme components? :face_with_peeking_eye::sweat_smile:

1 Like

What is the advantage of having these questions in separate topics instead of separate posts within one topic? One topic is scrollable in Discourse without any customization. And you could for example have a table of content in the first post

2 Likes

Or, if you have a budget, you can post in Marketplace.

1 Like

I’m also curious about that. Is the intention to keep each FAQ topic open for replies and discussion?

(Otherwise I might have suggested a single topic post with Table of Contents enabled. Then the whole thing would be scrollable, but also easy to navigate to section headings.)

I think disco-toc still works per post. I thought of this, too; it’s actually what I created on another Discourse forum. But I am not sure I would say that it’s easy to link to one of the questions in that case. Headings have anchors, so you can link to them, but once a new question is added within the FAQ, all heading IDs after that heading change, which breaks all the links. Then, finding these links in older support topics is not helpful anymore because they no longer take you to the right paragraph but only to the topic. That’s why I usually don’t link to the FAQ but quote it each time.

2 Likes

Ah, I hadn’t realized this. I’ll now keep it in mind before linking to any headings. :face_with_diagonal_mouth:

1 Like

It allows us to link to one of the questions directly and easily in responding to somebody. One of the issues we have in my community is that we have a large amount of documentation and it covers pretty much everything, but people are overwhelmed when they arrive (“my cat is dying”) and don’t read, and the people who respond are not very tech-savvy, so asking them to (on Facebook) copy and paste the link to a Google Doc in their response is too much – they just don’t do it.

Discourse makes it much easier for non-techy people to link to stuff inside the community: click the little linky button, start typing a keyword or the name of the thing you want to link to, and there you go. We want to make it easy to refer to people to a single item in the FAQ rather than the whole FAQ.

1 Like

yeah, no budget sadly, I’m already using my own money for the hosting :wink:

more seriously: if I want to get started cobbling something together to suit my needs, is there a category in Meta to get assistance with that? I don’t mean have somebody do it for me (I’m realistic), but answer “newbie dev” questions about how do I do xyz in my component, etc.

Sure, there’s a Dev category. You can also read up on developing stuff at Documentation > Developer Guides and Community wiki > Developers .

1 Like

That’s what we have on Google Docs: https://docs.google.com/document/u/0/d/1X4c1whNRQI32kuDFlYqOtaNFqw1R-CfzIv3quEuQYEU/

But the issue here is “creating a link to a section heading: if I click on the link button and start typing, is Discourse going to offer up section headings to link to directly, or only topics/categories?

Thanks, I’ll put that on my to-do then!

1 Like

No, you’re right, section headings won’t apply there. Sounds like you’re on the right track with FAQ topics.

1 Like

What about Discourse Doc Categories?

1 Like

Oh, I’d forgotten about that! That might help. Will put it on my list to look into. (My list is starting to be very long :cry:)

You can link to headings within a post like this: https://meta.discourse.org/t/configuring-the-default-sidebar-for-your-users/347764#p-1690272-adding-a-custom-section-13. The only problem is that the link will break if someone adds a new heading above that one.

You can also add manual anchors into posts like this: https://meta.discourse.org/t/markdown-links-to-anchors-not-working/150175/2. Those won’t break if a new heading is added.

I also bookmarked https://meta.discourse.org/t/i-created-a-bookmarklet-to-create-the-table-of-content-for-forum-posts/270961 when I was looking for the best solution for a FAQ.

Sorry ToddZ, this wasn’t a direct reply to your post.

2 Likes