docsy: Docsy theme with latest submodule -- puts right-hand ToC in the wrong location

With the latest submodule, the right-hand TOC appears in the wrong place:

With an earlier version of the Docsy submodule, it all “works fine”

The difference:

Git commit f82dd5ef works
Git commit 6e6061b does not

The relevant PR is https://github.com/google/docsy/pull/554

Unknown. When I run git submodule update -f --init, it checks a later (but not the latest) commit,

43a70b21d

Workaround

Include a git checkout f82dd5e in the netlify.toml file:

[build]
publish = "public"
command = "cd themes/docsy && git submodule update -f --init && git checkout f82dd5e && cd ../..   && hugo"

About this issue

Original URL
State: closed
Created 3 years ago
Comments: 37 (5 by maintainers)

Commits related to this issue

[NO-TICKET] Fix right-hand ToC issues - Based on https://github.com/google/docsy/issues/626 — committed to cobalthq/cobalt-product-public-docs by mjang-cobalt 3 years ago

Most upvoted comments

Yes, Gareth’s mostlydocs site is a good example of that approach! It’s got a lot less heavy customization than the original JustDocs so it means you’re less likely to find yourself with project-specific files/features that go out of sync with or are broken by Docsy updates.

LisaFC on Aug 19, 2021

I managed to fix my issue at LisaFC/justdocs#8 by using the layouts/_default/baseof.html suggested by @pschrey2.

aidan-wood-43 on Aug 7, 2021

I just got permission to publicly release the repo that I’m using https://github.com/cobalthq/cobalt-product-public-docs. Now I can ask my questions on a more substantive basis (aka, you can now see the mistakes I’ve made 😉 )… Thanks for the suggestions that I haven’t checked yet, and I’ll let you know when I do (though I’m a little busy atm)

mjang-cobalt on Aug 2, 2021

Ok, managed to reproduce “menus go weird with latest submodule” with Just Docs (which has not been updated in ages) but not with a more recently updated site.

Let me see what the difference is…

LisaFC on Jul 15, 2021