Category "python-sphinx"

Sphinx unable to import some modules

I am using to generate documentation for codebase. While building the docs, I could see that they were built for some modules only and many were left undocument

Get autosummary to produce a flat representation

If I have a file foo.baz.py: from foo.bar.baz import Quux, Quuux __all__ = ['Quux', 'Quuux'] I'd like to document the api as follows: Baz === .. currentmodul

autodoc: workaround when "cannot import module"

The package I want to document with Sphinx contains pure Python modules (ok) + a C/C++ library bind using pybind11. There are a lot of dependencies that can not

Sphinx: how to show attributes as in scipy

Let's say we have the following module testmodule.py with a TestClass definition: """This is a test module""" class TestClass: """ This is a simple des

How to set opengraph metadata tags for a sphinx document?

I'm looking to add meta tags to my sphinx document for the opengraph properties. I see that sphinx has this meta directive .. meta:: :description: The Sphinx

Getting "Extension error (sphinx.environment.collectors.toctree)" when adding section nodes in Sphinx extension

I am trying to write a new Sphinx extension. A minimum example of an extension that does something similar to what I want is from docutils import nodes from doc

How to include external file as Sphinx documentation similar to a code block?

How to include external file as Sphinx documentation similar to a code block? And how can I make it style the syntax color?

How to use custom CSS on a default Sphinx theme?

I'm creating documentation in Python with the Sphinx default theme agogo. I would like to use the topic directive to put a box around important information but

Sphinx Extensions (numpydoc)

NOTE Added After: I finally got numpydoc working. It was also a python 2 problem. I ran 2to3 on it and now it seems to be working. OK, I've spent an entire d

Can the XeLaTeX builder be used with Sphinx?

Although the end-problem that this would solve is a TeX one (installing a new font for PDF output), this particular solution that I'm looking for is a Sphinx is

How can I use automodule or autoclass for Sphinx in a markdown file?

I understand the Sphinx supports markdown or .md files optionally, which works great for me for my supplimental documentation. What I am trying to do is use the