Improve pdoc rendering

[mhils]

Hi there!

Thanks for the excellent project - it's a nice feeling to work with code that then again makes use of one's own project. 😄

I noticed that you have an interesting single-page configuration for pdoc which is slightly awkward with pdoc's folder structure expectations. I just pushed a new pdoc release which supports this a bit better, here are the accompanying changes for arxiv.py. 😃

[lukasschwab]

👋 Hi! Thanks for your work––pdoc is great.

Well-spotted. Maybe it's a mistake in how I designed this package, but pdoc's index wasn't super useful for this project––it just lists one module, arxiv, so I figured I'd pull that module's docs page out to replace the index. Not sure that this is typical, but glad to hear it's better supported now!

Reviewing...

[lukasschwab]

LGTM! Merging...

[lukasschwab]

One note: it is nice to have fuzzy search in the sidebar, even for a package this simple. I'll keep an eye on your changelog in case you re-add it!

Using sed to modify the relative path was a hack, of course.

[mhils]

Yeah, I see where you are coming from. The intention here was that users are already familar with their browser's builtin search, and not showing the in-page search makes it clear that there is nothing else that can be searched. :) I'll gather a bit more feedback, if it turns out that folks universally still want fuzzy search, we may just re-add it. :)

[mhils]

Well-spotted. Maybe it's a mistake in how I designed this package, but pdoc's index wasn't super useful for this project––it just lists one module, arxiv, so I figured I'd pull that module's docs page out to replace the index. Not sure that this is typical, but glad to hear it's better supported now!

pdoc always generates a module index for consistency, but doesn't link to it if only one module is being documented. In your case it detected two modules - arxiv (arxiv/__init__.py) and arxiv.àrxiv (arxiv/arxiv.py) - which is why the link was there.

FWIW you could also simplify your package to a single file (mv ./arxiv/arxiv.py ./arxiv.py; rm -rf ./arxiv), but I didn't want to impose any structural changes to your work here. :)