SharePoint page display issues

Question

SharePoint page display issues

Closed this issue 4 months ago · 13 comments

Hi Martin Heusser
When I execute this script "BuildDocFxForSPO.ps1" to upload a file to a SharePoint document library, I open the index.aspx home page as follows, and I can't see the TOC, have you encountered this problem?

Answer 1 · 2023-12-11T08:05:54.000Z

I don't think I have. It's been a while since I created and tested this though. Let me check later and get back to you.

Answer 2 · 2023-12-11T09:58:53.000Z

Okay, thanks for the quick reply.

Answer 3 · 2023-12-14T07:11:24.000Z

@mozziemozz
Any update on this issue?

Thanks,
Eric Jia

Answer 4 · 2023-12-14T07:12:27.000Z

No, sorry it will take me some time to test this. Thanks for your understanding.

Answer 5 · 2023-12-14T07:18:14.000Z

No problem, if you are experiencing the same issue please let me know as well, thanks for the time.

Answer 6 · 2023-12-18T15:47:58.000Z

have you tried to serve the site locally? You probably have the same issue there? I looked at it today and it looks like the new DocFx version creates a new/empty project quite differently so it will require some work from me. I'll implement a required version check of DocFx to make sure that my scripts are working after I tested everything. Thanks for your patience.

Answer 7 · 2024-01-12T01:09:44.000Z

I haven't tried deploying it locally, only on SharePoint Online version. It's probably due to the version differences you mentioned. Since I'm not very familiar with this knowledge, I couldn't identify the specific problem.

Answer 8 · 2024-01-25T22:24:10.000Z

Hi @ericjia888 I pushed some updates today. Please remove the cloned repo from your system and clone again. Newer DocFx versions use a different init function so I created a default DocFx project using an older version and put that into the repo. .\Docs now contains a vanilla version and then the Initialize-AwesomeDocFx.ps1 applies changes to that.

You'll need to install DocFx Version 2.75.1 for it to work.

Answer 9 · 2024-04-03T09:28:15.000Z

Hi Martin Heusser
I've tested it and now this version is working, I'd like to ask if DocFx works with versions greater than 2.75.1 as well? I see that you have added a version check in your code, so if you want to iteratively update DocFx at a later stage it will be affected.

Thanks,
Eric Jia

Answer 10 · 2024-04-05T17:26:10.000Z

Hi Eric,

If you want to use a newer DocFx version, just update the version which is checked in the script to the version you're using, or remove the check entirely. You only need to run this script when you create a new project/docs site. After that, you can use a newer version to build the site.

Answer 11 · 2024-04-07T01:31:36.000Z

Okay, thanks for your help.

Answer 12 · 2024-04-09T09:42:17.000Z

Hi Martin Heusser
Do you know where the assignment logic for the docurl parameter is?
See that it's pointing to your GitHub URL.

Answer 13 · 2024-04-09T09:42:47.000Z

Hi Martin Heusser
Do you know where the assignment logic for the docurl parameter is?
See that it's pointing to your GitHub URL.