add custom homepage intro

[cs01]

It would be nice if the homepage allowed some more context to be written. For example, passing the path to an arbitrary markdown file, such as the README.md, or any other arbitrary content.

Example call:

pdoc --index README.md --html mypackage

[kernc]

Besides module-level docstrings rendering before the API reference, we support .. include:: reST directive.

I.e., in your main module:

"""
Some introductory text ...

.. include:: ../README.md
"""
...

[cs01]

Thanks that definitely helps. I have some html in my markdown and it looks like it has some trouble formatting it. Any tips?

[kernc]

Should be fixed in master. 😳 Thanks!

[cs01]

Thanks! That is definitely better. There is still some abnormal formatting though.

From this markdown source code

**Documentation**: https://cs01.github.io/pygdbmi/
**Source Code**: https://github.com/cs01/pygdbmi

[kernc]

Should be fixed in master. Thanks again! And keep them coming! 😆

[cs01]

Nice, thanks for all the quick responses. 👍