AL icon indicating copy to clipboard operation
AL copied to clipboard

ALDoc Header Navbar covers entire content of the page

Open ngiessel opened this issue 1 year ago • 0 comments

When building documentation using ALDoc, the entire page is covered by the header. The problem seems to be that all level 2 navigation items are shown in the header.

image

To Reproduce I've just followed the ALDoc instructions.

  • Make sure prerequisites are met. https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/help/help-aldoc-generate-help
  • Extract ExampleExtension.zip which contains an app.json, HelloWorld.al and the compiled .app file.
  • run aldoc.exe init -o {destination} -t {fullPathToExample.app}
  • run aldoc.exe build -o {destination} -s {fullPathToExample.app}
  • run docfx build {destination}\docfx.json
  • run docfx serve {destination}\_site and open the page

Expected behavior The page should look something like this. (This was achieved using the browser devtools.) image

Actual behavior The header includes level 2 navigation items, covering the site's content. image

Versions:

  • AL Extension that contains aldoc.exe: 12.6.936426
  • DocFX: I have tried several versions, including the latest (2.75.3), older ones and the last supported version as per ALDoc documentation (which is 2.70.0).
  • dotnet SDK: 6-8 are installed

ngiessel avatar Mar 11 '24 12:03 ngiessel