Allow multiple hook files about mkdocs

[oprypin]

There are many options for this:

• Just do the 2 actions in 1 function

• Use multiple files (wait, are you saying that multiple hooks files have a problem?)

• Use this upcoming feature, though I should double-check whether it actually works for hooks
  #3448

Or actually I know what it is - it's about on_page_read_source specifically. I think this event type is fundamentally broken, actually? The definition is "replace the default mechanism to read the contents of a page's source from the filesystem" - so yeah if you replace the mechanism once and read the original source file, and then replace the mechanism another time and read the original source file, that's exactly what will happen?

I was just looking through your hooks yesterday and saw that your usage would be much simpler served by on_page_markdown, that's definitely what you should switch to at the moment, and it would not have this problem at all.

[ofek]

Oh okay, that makes sense that I was using the wrong plugin type. My bad! Before I close this can you take a look at the PR that I merged to fix this? It works fine but I'm wondering what you think.

[oprypin]

The actionable thing for me is one of these:

• Deprecate on_page_read_source event type because I think there are better alternatives to it in every case

• Show an error if multiple handlers for it are added (it's the only event type that is incompatible with having multiple handlers)

So it's helpful that you brought this up

[oprypin]

look at the PR that I merged to fix this

Commented there-
yeah you can revert pypa/hatch#1065 and, in the previous state of the code, change each on_page_read_source to on_page_markdown and it's the same except you get the source directly instead of messing with abs_src_path. And, well, it will actually work