Add napoleon extension for all_in_one_restructuredtext.py showcase file

[cmarqu]

(This PR is based on/includes #179.)

The recently merged #157 adds all_in_one_restructuredtext.py which needs the napoleon extension for some of its docstrings, but I had forgotten to include it in that PR (I don't have a setup where I can completely build the project locally).

[cmarqu]

Rebased to the updated #179.

[shirou]

@cmarqu Since I have merged #179, could you rebase on master branch?

[cmarqu]

@cmarqu Since I have merged #179, could you rebase on master branch?

Done.

[shirou]

LGTM. Thank you!

[stevepiercy]

Thanks for all your work on this.

I might maintain one of only three projects I know that pull in the Kitchen Sink files, the other being PyData Sphinx Theme and Sphinx Book Theme.

• https://github.com/plone/plone-sphinx-theme/blob/drop-sphinx-book-theme/scripts/kitchen_sink_update.py # This handles a FileNotFound error with new files and parent directories.
• https://github.com/pydata/pydata-sphinx-theme/blob/main/docs/scripts/update_kitchen_sink.py
• https://github.com/executablebooks/sphinx-book-theme/blob/master/docs/scripts/update_kitchen_sink.py

Ping @choldgraf and @drammock in case they want to update their update_kitchen_sink.py scripts and conf.pys to render the new beautiful API docs.

See also:

• https://github.com/sphinx-themes/sphinx-themes.org/pull/179/files#diff-e4cd7c68d172e50125f948b9d2eb7c7d730cb344eed598e8b94e65c6757af3ccR16
• Add dedicated file showcasing many Python and Sphinx features #157

[cmarqu]

I have just opened a draft PR for some smaller fixes in #182 that you may want to wait on.

[stevepiercy]

Not a problem for me. I run the Python script that pulls in changes to all the Kitchen Sink files, commit, push, open a PR, and merge.