sphinx_gallery.gen_gallery¶
Sphinx-Gallery Generator¶
Attaches Sphinx-Gallery to Sphinx in order to generate the galleries when building the documentation.
Functions¶
-
sphinx_gallery.gen_gallery.
check_duplicate_filenames
(files)¶ Check for duplicate filenames across gallery directories.
-
sphinx_gallery.gen_gallery.
check_spaces_in_filenames
(files)¶ Check for spaces in filenames across example directories.
-
sphinx_gallery.gen_gallery.
collect_gallery_files
(examples_dirs, gallery_conf)¶ Collect python files from the gallery example directories.
-
sphinx_gallery.gen_gallery.
cost_name_key
(cost_name)¶
-
sphinx_gallery.gen_gallery.
generate_gallery_rst
(app)¶ Generate the Main examples gallery reStructuredText
Start the sphinx-gallery configuration and recursively scan the examples directories in order to populate the examples gallery
-
sphinx_gallery.gen_gallery.
get_default_config_value
(key)¶
-
sphinx_gallery.gen_gallery.
get_subsections
(srcdir, examples_dir, gallery_conf)¶ Return the list of subsections of a gallery.
-
sphinx_gallery.gen_gallery.
parse_config
(app)¶ Process the Sphinx Gallery configuration
-
sphinx_gallery.gen_gallery.
setup
(app)¶ Setup sphinx-gallery sphinx extension
-
sphinx_gallery.gen_gallery.
setup_module
()¶
-
sphinx_gallery.gen_gallery.
summarize_failing_examples
(app, exception)¶ Collects the list of falling examples and prints them with a traceback.
Raises ValueError if there where failing examples.
-
sphinx_gallery.gen_gallery.
touch_empty_backreferences
(app, what, name, obj, options, lines)¶ Generate empty back-reference example files.
This avoids inclusion errors/warnings if there are no gallery examples for a class / module that is being parsed by autodoc
-
sphinx_gallery.gen_gallery.
write_computation_times
(gallery_conf, target_dir, costs)¶
-
sphinx_gallery.gen_gallery.
write_junit_xml
(gallery_conf, target_dir, costs)¶