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.
Examples using sphinx_gallery.gen_gallery.check_duplicate_filenames
¶
-
sphinx_gallery.gen_gallery.
check_spaces_in_filenames
(files)¶ Check for spaces in filenames across example directories.
Examples using sphinx_gallery.gen_gallery.check_spaces_in_filenames
¶
-
sphinx_gallery.gen_gallery.
collect_gallery_files
(examples_dirs, gallery_conf)¶ Collect python files from the gallery example directories.
Examples using sphinx_gallery.gen_gallery.collect_gallery_files
¶
-
sphinx_gallery.gen_gallery.
cost_name_key
(cost_name)¶
Examples using sphinx_gallery.gen_gallery.cost_name_key
¶
-
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
Examples using sphinx_gallery.gen_gallery.generate_gallery_rst
¶
-
sphinx_gallery.gen_gallery.
get_default_config_value
(key)¶
Examples using sphinx_gallery.gen_gallery.get_default_config_value
¶
-
sphinx_gallery.gen_gallery.
get_subsections
(srcdir, examples_dir, gallery_conf)¶ Return the list of subsections of a gallery.
Examples using sphinx_gallery.gen_gallery.get_subsections
¶
-
sphinx_gallery.gen_gallery.
parse_config
(app)¶ Process the Sphinx Gallery configuration.
Examples using sphinx_gallery.gen_gallery.parse_config
¶
-
sphinx_gallery.gen_gallery.
setup
(app)¶ Setup Sphinx-Gallery sphinx extension
Examples using 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.
Examples using sphinx_gallery.gen_gallery.summarize_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
Examples using sphinx_gallery.gen_gallery.touch_empty_backreferences
¶
-
sphinx_gallery.gen_gallery.
write_computation_times
(gallery_conf, target_dir, costs)¶
Examples using sphinx_gallery.gen_gallery.write_computation_times
¶
-
sphinx_gallery.gen_gallery.
write_junit_xml
(gallery_conf, target_dir, costs)¶