# sphinx_gallery.sorting

## Sorters for Sphinx-Gallery (sub)sections

Sorting key functions for gallery subsection folders and section files.

### Classes

class `sphinx_gallery.sorting.``ExampleTitleSortKey`(src_dir)

  Sort examples in src_dir by example title.

  Parameters

    src_dir (str) – The source directory.

#### Examples using `sphinx_gallery.sorting.ExampleTitleSortKey`

class `sphinx_gallery.sorting.``ExplicitOrder`(ordered_list)

  Sorting key for all gallery subsections.

  This requires all folders to be listed otherwise an exception is raised.

  Parameters

    ordered_list (list, tuple, or generator) – Hold the paths of each galleries’ subsections.

  Raises

    ValueError – Wrong input type or Subgallery path missing.

#### Examples using `sphinx_gallery.sorting.ExplicitOrder`

class `sphinx_gallery.sorting.``FileNameSortKey`(src_dir)

  Sort examples in src_dir by file name.

  Parameters

    src_dir (str) – The source directory.

#### Examples using `sphinx_gallery.sorting.FileNameSortKey`

class `sphinx_gallery.sorting.``FileSizeSortKey`(src_dir)

  Sort examples in src_dir by file size.

  Parameters

    src_dir (str) – The source directory.

#### Examples using `sphinx_gallery.sorting.FileSizeSortKey`

class `sphinx_gallery.sorting.``NumberOfCodeLinesSortKey`(src_dir)

  Sort examples in src_dir by the number of code lines.

  Parameters

    src_dir (str) – The source directory.

#### Examples using `sphinx_gallery.sorting.NumberOfCodeLinesSortKey`