Hi Mike, Jupyter uses napoleon in some of our docs. JupyterHub is one example. We more often use NumPy docstring format than Google.
If the project is open source, please send a link to your project. I would be happy to try to build. Carol --- Carol Willing Research Software Engineer Project Jupyter at Cal Poly State University, San Luis Obispo @willingc on GitHub and @willingcarol on Twitter [email protected] and [email protected] *Signature StrengthsEmpathy - Relator - Ideation - Strategic - Learner* On Thursday, September 28, 2017 at 5:34:04 PM UTC-7, [email protected] wrote: > > We're currently expanding a python development project and would like to > use Sphinx and the Napoleon extension to generate html documentation. > We've tried both Sphinx 1.4.1 and 1.7, and all we're getting is a copy of > the source code (and comments) in an html wrapper. I don't see any errors > when we run 'make html'. Are there some examples of python files with > Google docs markup AND the expected html output (screen shot is fine) > available? Also are there any open source projects that are using the > Napoleon extension with python source files that we could use as a detailed > example? We did modify the config.py to use sphinx.ext.napoleon. We were > expecting some of amount of formatting in the html output, based on the > comment markup. Thanks, Mike. > > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
