Skip to content

Unable to set landing page #8231

@ghost

Description

Operating System: Windows

DocFX Version Used: 2.59.4

Template used: ?

    "template": [
      "default",
      "_templates/last-modified"
    ],

Steps to Reproduce:

  1. Use the following root toc (resource: DocFX page) to set a markdown doc in a nested folder as the home page for localhost:8080. My understanding is that the root toc.yml generates the top nav bar, and nested toc.ymls generate the vertical left bar. Combining them doesn't seem like a good idea.
- name: Troubleshooting Guides
  href: tsgs/toc.yml
  topicHref: tsgs/aadlcm-oncall-handbook/lcm-dependency-map.md
  1. Here's the nested /tsgs/toc.yml:
- name: AADLCM OnCall handbook
  items:
  - name: AAD LCW OnCall HandBook
    href: aadlcm-oncall-handbook/aad-lcw-oncall-handbook.md
  - name: LCM Dependency Map
    href: aadlcm-oncall-handbook/lcm-dependency-map.md
  1. Run DocFX locally on the docfx.json in the root folder.

Expected Behavior:

Should see the Markdown article specified by the topicHref as the landing page.

Actual Behavior:

I get an index listing:
image

Metadata

Metadata

Assignees

No one assigned

    Labels

    tocNavigation components like menus, TOC and breadcrumbs

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions