search

Ellerbach / docfx-companion-tools

A suite of tools, pipelines templates to take the very best of DocFX
MIT License
66 stars 19 forks source link

Unexpected ERROR Not found #50

Closed davesmits closed 1 month ago

davesmits commented 8 months ago

I am trying to integrate doclinkchecker and I am getting this error

./platform/Admin/Action-Hub/BuildAnAction.md 54:1
***ERROR Not found: ~/.attachments/image-ac695c92-679c-4bb6-9ce8-f02e64d6308e.png

Now the problem is that the file is there. Its even visible when I publish the generated website.

image

I am just not sure how to troubleshoot this. I saw #12 brought support for ~

Ellerbach commented 8 months ago

Is it the only image like this? Or do you have others? Are you running DocFX with the proper root directory? Any minimal example to reproduce more than the screen capture? Like a minimum file code and the command line you are running (also from where)

davesmits commented 8 months ago

No; it's all images. At least looks like as I do end up with 321 errors.

I am only been trying to config it in azure devops and this what my YAML looks like

image

so the docfx,json is in the folder docfx_project

The structure in docfx file looks pretty simple?

image

I will try to run in locally.

mtirionMSFT commented 1 month ago

@davesmits sorry for the delay. I have added support for using the ~, but there is something you need to be aware off. As we don't know the location of the docfx.json file, we assume that file to be in the documentation root folder. That's the only thing we can check. If the docfx.json file is somewhere else, the actual generation of links in the DocFx processor might end up with wrong links.

As soon as PR #59 is merged I'll make sure to publish the change asap.