]> git.bitcoin.ninja Git - youtube-dl/commitdiff
[extractor/common] Document chapter and series fields
authorSergey M․ <dstftw@gmail.com>
Wed, 30 Dec 2015 21:10:44 +0000 (03:10 +0600)
committerSergey M․ <dstftw@gmail.com>
Wed, 30 Dec 2015 21:10:44 +0000 (03:10 +0600)
youtube_dl/extractor/common.py

index 65520744799013fbaa756d171cb10bff8a3e693e..c443daf2001633acc02a39c5571e2f804e3a5f0e 100644 (file)
@@ -200,6 +200,26 @@ class InfoExtractor(object):
     end_time:       Time in seconds where the reproduction should end, as
                     specified in the URL.
 
+    The following fields should only be used when the video belongs to some logical
+    chapter or section:
+
+    chapter:        Name or title of the chapter the video belongs to.
+    chapter_id:     Number or id of the chapter the video belongs to, as an integer
+                    or unicode string.
+
+    The following fields should only be used when the video is an episode of some
+    series or programme:
+
+    series:         Title of the series or programme the video episode belongs to.
+    season:         Title of the season the video episode belongs to.
+    season_id:      Number or id of the season the video episode belongs to, as an
+                    integer or unicode string.
+    episode:        Title of the video episode. Unlike mandatory video title field,
+                    this field should denote the exact title of the video episode
+                    without any kind of decoration.
+    episode_id:     Number or id of the video episode within a season, as an integer
+                    or unicode string.
+
     Unless mentioned otherwise, the fields should be Unicode strings.
 
     Unless mentioned otherwise, None is equivalent to absence of information.