Allow custom documenters in autosummary

[epruesse]

Is your feature request related to a problem? Please describe.

I'd like to have autosummary be able to recognize autodoc documenters other than the built-in ones. E.g. celery tasks. Celery brings it's own documenter [1] in an extension, but the typ of task is not recognized.

[1] http://docs.celeryproject.org/en/latest/_modules/celery/contrib/sphinx.html#TaskDocumenter

Describe the solution you'd like

The code below could be turned into a loop with configurable inputs:

sphinx/sphinx/ext/autosummary/generate.py

Lines 192 to 198 in d501bc1

	ns['members'] = dir(obj)
	ns['functions'], ns['all_functions'] = \
	get_members(obj, 'function', imported=imported_members)
	ns['classes'], ns['all_classes'] = \
	get_members(obj, 'class', imported=imported_members)
	ns['exceptions'], ns['all_exceptions'] = \
	get_members(obj, 'exception', imported=imported_members)

The list could be automatically, or manually, extended with further documenters, via conf.py or from other extensions.

Describe alternatives you've considered

• configure via conf.py
• configure from other extension
• determine directly from registered documenters

(The last would be great - although a question is how to know what is available when adapting the jinja template)

[epruesse]

@tk0miya Would it be worth coming up with a PR for this?

[tk0miya]

@epruesse Sorry for late response. Yes, please!

Note: autosummary already knows registered documenters. Simply it does not use them to generate template variables.

[mansenfranzen]

@epruesse @tk0miya I would like to make some progress on this issue. I could provide a PR myself but don't want to duplicate efforts if there is an existing PR already.

[mansenfranzen]

@tk0miya @epruesse Just a friendly reminder if you could provide a short feedback if there has been any PR or approach already for the current issue (see my previous response).