HTTP server will not serve images

[MrSurly]

Expected Behavior

Images are served by http server

Actual Behavior

Images return a 302 and a URL that ultimately results in a 404.

Steps to Reproduce

1. Generate documentation that has images
2. Run the http server

Additional info

Starting pdoc server on localhost:8080
pdoc server ready at http://localhost:8080
127.0.0.1 - - [08/Oct/2020 19:05:00] "GET /modelgen.modelgen/ HTTP/1.1" 200 -
127.0.0.1 - - [08/Oct/2020 19:05:00] "GET /modelgen.modelgen/img/screw_hole.svg HTTP/1.1" 302 -
127.0.0.1 - - [08/Oct/2020 19:05:00] "GET /modelgen.modelgen/img/screw_hole.svg/ HTTP/1.1" 404 -

Note that accessing the files directly via file:// works as expected.

• pdoc version: 0.9.1

[kernc]

Thanks! The culprit seems to be these lines:

pdoc/pdoc/cli.py

Lines 225 to 228 in d8b9dbc

	# Redirect '/pdoc' to '/pdoc/' so that relative links work
	# (results in '/pdoc/cli.html' instead of 'cli.html')
	elif not self.path.endswith(('/', '.html')):
	return self.redirect(self.path + '/')

Let me think about it. 🤔 PR welcome!

[MrSurly]

I gave it a shot (a PR), but it seems to render on-the-fly rather than rendering to a directory, so it didn't really work out.

[kernc]

Well yeah, it's a HTTP server: 😃

pdoc/pdoc/cli.py

Line 155 in d8b9dbc

class _WebDoc(BaseHTTPRequestHandler):

I'd say the branch condition above needs to be modified to account for other files that are not module documents and maybe default to SimpleHTTPRequestHandler.do_GET() behavior for those files (if _WebDoc inherits from SimpleHTTPRequestHandler instead, maybe simply super().do_GET() can be called).

[fr34q]

I am also facing this issue ( #268 ).

Not 100% sure if it makes a difference for the solution but the issue is also there when generating the documentation with pdoc3 --html. The browser also does not find the image, and this should all be static content I believe?

[kernc]

Since with --html pdoc just converts markdown ![alt](image) to HTML <img src="image" alt="alt">, I believe it's a question of relative path addressing. Where is the image located relative to the document? Have you tried to address it relative to the project root or the CWD?

[fr34q]

I guess the problem is that the images are not copied at all into the output directory. I used relative adressing, e.g. test.svg when the image is located in the same folder as the python file. In #268 I also described a minimal example to reproduce it.

[tausiq2003]

can i contribute please assign me