Documentation Monster
See also topic links not being generated successfully for Index topic type
Gravatar is a globally recognized avatar based on your email address. See also topic links not being generated successfully for Index topic type
  Richard Kaye
  All
  Oct 1, 2026 @ 06:36am

Or maybe because it's the top of the tree? I speculate idly. See the ginormous screenshot.

This is an html snippet from the generated index.html doc:

<h3 class="outdent" id="seealso">See also</h3>
	Getting Started
Contact Support
What&#39;s new in RFC Auction Systems v3
FAQs
How the Help Center Works
                </article>

And here's a snippet from a topic where the seealso is good:

    <h4 class="outdent" id="seealso">See also</h4>
    <div class="see-also-container">
        <div><a href="/help/How-the-Help-Center-Works.html">How the Help Center Works</a></div>
<div><a href="/help/Contact-Support/Setting-up-a-Service-Desk-Web-Portal-Account.html">Setting up a Service Desk Web Portal Account</a></div>

    </div>
                </article>
Gravatar is a globally recognized avatar based on your email address. re: See also topic links not being generated successfully for Index topic type
  Rick Strahl
  Richard Kaye
  Oct 1, 2026 @ 07:57am

Odd - tried this out a minute ago and I saw exactly what you're seeing.

Then tried it again with different topics and it worked just fine, and now I can't make it fail again.

First time I was using all top level header topics.

I keep poking at it and see if I can figure out why it's not working sometimes. Maybe there's some text that breaks the Html in the text but of course I can't dupe it now.

+++ Rick ---

Gravatar is a globally recognized avatar based on your email address. re: See also topic links not being generated successfully for Index topic type
  Richard Kaye
  Rick Strahl
  Oct 1, 2026 @ 12:24pm

If I'm reading the snippets correctly, the see-also-container div did not get generated? The one obvious difference to me is the topic type for the top of the tree topic. Did I use the word topic enough in that sentence? Let me know if there's anything else I can contribute.

Gravatar is a globally recognized avatar based on your email address. re: See also topic links not being generated successfully for Index topic type
  Rick Strahl
  Richard Kaye
  Oct 2, 2026 @ 08:48am

If you can repo reliably let me know...

I can't make it fail anymore.

+++ Rick ---

Gravatar is a globally recognized avatar based on your email address. re: See also topic links not being generated successfully for Index topic type
  Richard Kaye
  Rick Strahl
  Oct 5, 2026 @ 11:07am

Happy Monday.

I've regenerated and deployed multiple times. The see also contents in my main/index/top topic renders as plain text and not actual topic links. Let me know how you want to proceed.

Gravatar is a globally recognized avatar based on your email address. re: See also topic links not being generated successfully for Index topic type
  Rick Strahl
  Richard Kaye
  Oct 7, 2026 @ 08:07am

Ok figured it out. There were a couple of templates that weren't calling the See Also fix up code:

  • Index
  • Header

Fixed now, but you can just copy the following from the topic template and overwrite the old SeeAlsoTopic code:

{{% if (!string.IsNullOrEmpty(Model.Topic.SeeAlso)) { }}
    <h4 class="outdent" id="seealso">See also</h4>
    <div class="see-also-container">
        {{ Helpers.FixupSeeAlsoLinks(Topic.SeeAlso) }}
    </div>
{{% } }}

Key is the FixupSeeAlsoLinks() call which parses the text into links if matches can be found.

Fixed in the next update but you can fix the templates since that's the only change for now.

+++ Rick ---

Gravatar is a globally recognized avatar based on your email address. re: See also topic links not being generated successfully for Index topic type
  Richard Kaye
  Rick Strahl
  Oct 7, 2026 @ 08:31am

Thanks! Glad I was able to get you enough clues to find.

And the file to edit, just to confirm, is index.dmhtml, correct? header.dmhtml appears to have that function with the proper logic.

Gravatar is a globally recognized avatar based on your email address. re: See also topic links not being generated successfully for Index topic type
  Rick Strahl
  Richard Kaye
  Oct 7, 2026 @ 09:59am

I've updated the download with the latest templates...

If you manually fixed, fix the matching topic template that fails for the topic type where it doesn't work...

+++ Rick ---

Gravatar is a globally recognized avatar based on your email address. re: See also topic links not being generated successfully for Index topic type
  Richard Kaye
  Rick Strahl
  Oct 8, 2026 @ 09:08am

I'm all set with this one, thanks!

© 1996-2026