Netlify preview fails, but this was expected.

@deining - thanks for this. I'm willing to give this a spin. Could you please resolve conflicts (though maybe it is best to wait for #1218 to be merged first).

FYI, v0.5.0 will be released soon. This PR is targeted for a subsequent release (probably v0.6.0).

Could you please resolve conflicts.

Done.

FYI, v0.5.0 will be released soon. This PR is targeted for a subsequent release (probably v0.6.0).

Great. I can contribute to the documentation and will assist in case of any questions/issues.

@deining - Shouldn't github.com/google/docsy/dependencies entries be removed from go.mod and go.sum?

Yes, very true.

Also running hugo mod tidy would be a good idea as well, no?

Done with commit 396d76d.

Thanks for the updates.

Have you tested this locally, and if so how? I can't get it to work, whether with using a (slightly modified) version of docsy-example or starting from scratch, again following a modified version of the instructions https://www.docsy.dev/docs/get-started/docsy-as-module/start-from-scratch/.

Thanks for the updates.

You are welcome.

Have you tested this locally,

Yes.

and if so how?

I started a new site from scratch, created a clone of docsy beside the newly created site repo and used hugo.work to refer to the local docsy theme repo. Similar do what I proposed in another PR from me. Everything ran smoothly, the site was up and running in no time 😄 .

I can't get it to work

I prepared a branch for you on my fork of the docsy-example repo. Please try this:

git clone -b docsy-as-single-module https://github.com/deining/docsy-example docsy-as-single-module-test
hugo server

This works for me out of the box. Can you please give this a try?

This works for me out of the box. Can you please give this a try?

Yes, it works, thanks!

I also got it to work with a docsy.work file.

This works for me out of the box. Can you please give this a try?

Yes, it works, thanks!

I also got it to work with a docsy.work file.

Great to hear that!

Do you deem this PR production ready and ready for subsequent merging?
What is still missing and what are the next steps?

Do you deem this PR production ready and ready for subsequent merging?
What is still missing and what are the next steps?

Almost there! I'd like to address #1217 (comment) first.

In case you missed my nested comment @deining:

How can I check what's in hugo module cache?

In case you missed my nested comment @deining:

No I didn't miss it!

How can I check what's in hugo module cache?

Find out your cache dir (on my Unix system, this is /home/username/.cache/hugo_cache):

hugo config | grep cachedir

Have a look there, directories you should possibly look at:

~/.cache/hugo_cache/modules/filecache/modules/pkg/mod/github.com/deining/[email protected]/

and maybe also

~/.cache/hugo_cache/modules/filecache/modules/pkg/mod/github.com/twbs/[email protected]+incompatible/
~/.cache/hugo_cache/modules/filecache/modules/pkg/mod/github.com/!fort!awesome/[email protected]