Content:File relations: Difference between revisions
No edit summary |
|||
(18 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{TOCright}} | {{TOCright}} | ||
= | ==Overview== | ||
File relations, like the name implies, are relations between files on AniDB. There are two types of file relations; [[#File-File Relations|File-File]] and [[#File-Ep Relations|File-Ep]]. | |||
File relations, like the name implies, are relations between files on AniDB | |||
The former tells how two different files relate and the later tells how a file relates to different episodes. | The former tells how two different files relate and the later tells how a file relates to different episodes. | ||
== File | ==File-Ep Relations== | ||
Imagine yourself with a file that spans two, or more, episodes. Until the introduction of file relations the only way to add this file to AniDB was to create a special episode that would hold your file. | Imagine yourself with a file that spans two, or more, episodes. Until the introduction of file relations the only way to add this file to AniDB was to create a special episode that would hold your file. | ||
Now, for those kinds of files you can add file-ep relations. | Now, for those kinds of files you can add file-ep relations. | ||
=== How to create a File | === How to create a File-Ep relation === | ||
To create a file relation between a file and an episode you just need to follow these steps. | To create a file relation between a file and an episode you just need to follow these steps. | ||
Line 20: | Line 17: | ||
# Press "Add" and you are done. | # Press "Add" and you are done. | ||
== File<-> | === Percentage ranges for file-ep relations === | ||
File-episode relations follow the rules of [https://en.wikipedia.org/wiki/Number_line number lines] for all [https://en.wikipedia.org/wiki/Integer integer numbers] in the inclusive range <code>[0,100]</code>. In simpler terms, ranges should be directly connected. Examples: | |||
2 file release, each covering 1/2 of the episode: | |||
[0,50] --> 0% to 50% for part 1 | |||
[50,100] --> 50% to 100% for part 2 | |||
3 file release, each covering 1/3 of the episode: | |||
[0,33] --> 0% to 33% for part 1 | |||
[33,67] --> 33% to 67% for part 2 | |||
[67,100] --> 67% to 100% for part 3 | |||
4 file release, each covering 1/4 of the episode: | |||
[0,25] --> 0% to 25% for part 1 | |||
[25,50] --> 25% to 50% for part 2 | |||
[50,75] --> 50% to 75% for part 3 | |||
[75,100] --> 75% to 100% for part 4 | |||
==== Explanation of number lines when used for AniDB episode ranges ==== | |||
[[File:Number line 4 inclusive.png|border]]<br> | |||
'''Correct:''' Ranges cover the entire number line when they are directly connected, as is the case with <code>[0,25]</code>, <code>[25,50]</code>, <code>[50,75]</code>, and <code>[75,100]</code>; there are no gaps in the number line.<br><br> | |||
[[File:Number line 4 exclusive.png|border]]<br> | |||
'''Incorrect:''' If the ranges are not directly connected, as in the case with <code>[0,25]</code>, <code>[26,50]</code>, <code>[51,75]</code>, and <code>[76,100]</code>, the values in the range <code>(25,26)</code> (e.g. 25.00000000001 to 25.99999999999), <code>(50,51)</code>, and <code>(75,76)</code> would be incorrectly excluded. | |||
==File-File Relations== | |||
Often you find yourself with files that are meant be together, for example you have a subtitle file for a video file. Until the introduction of file-relations the only way you had to show this connection was to add a file comment. Users would then have to open the file information page to be able to read your comment. Currently the new system allows you a greater degree of file relation possibilities. | Often you find yourself with files that are meant be together, for example you have a subtitle file for a video file. Until the introduction of file-relations the only way you had to show this connection was to add a file comment. Users would then have to open the file information page to be able to read your comment. Currently the new system allows you a greater degree of file relation possibilities. | ||
=== Types of file relations === | === Types of file relations === | ||
Currently there are the following possible file relations: | |||
* '''external-sub-for'''; to relate a subtitle file to its respective video file. | |||
* '''newer-ver-of'''; to indicate that there's a newer version of a given file (kind of like the current versioning system). | |||
* '''external-sub-for''' ; to relate a subtitle file to | * <s>'''bundle'''; to indicate that a group of two, or more, files are related, and normally, needed in group.</s> Deprecated | ||
* '''newer-ver-of''' ; to indicate that there's a newer version of a given file (kind of like the current versioning system) | * '''op/end-for'''; indicates that a given video file is an opening or ending to another video file. | ||
* '''bundle''' ; to indicate that a group of two, or more, files are related, and normally, needed in group | * '''external-audio-for''' ; to relate an audio file to it's respective video file. | ||
* '''op/end-for''' ; indicates that a given video file is an opening or ending to another video file | * '''uses material from'''; to relate a reencoded, remuxed, or other compiled file, to original source files. For example, if a remuxed file uses subs from file X and video from file Y, link the remuxed file to files X and Y. | ||
* '''external-audio-for''' ; to relate an audio file to it's respective video file | * '''chapter-linker for'''; to relate "play-all" files to the associated video files. | ||
* '''other''' ; covers file relations that don't fit the other categories | * '''other'''; covers file relations that don't fit the other categories. | ||
=== Rules === | === Rules === | ||
These are the rules for using file relations: | These are the rules for using file relations: | ||
* '''external-sub-for''' ; can only be used to relate a | * '''external-sub-for'''; can only be used to relate a ''subtitle'' file to a ''video'' file (as in, you need to select the subtitle file and add a file relation to the video file from within the subtitle file page). | ||
* '''newer-ver-of'''; can only be used to relate files of the ''same type'' (video-video), that are from the ''same episode'' and from the ''same, or related, groups''. | |||
* '''newer-ver-of''' ; can only be used to relate files of the | * '''bundle'''; this kind of relation could be used, for example, to relate an idx to a srt file. | ||
* '''op/end-for''' ; can only be used to relate | * '''op/end-for'''; can only be used to relate ''video'' files that belong to a ''Opening/Ending/Credits'' or an ''Other'' Episode to ''video'' files that belong on a ''Normal'' or ''Special'' Episode | ||
* ''' | * '''external-audio-for'''; can only be used to relate a ''audio'' file to a ''video'' file (as in, you need to select the audio file and add a file relation to the video file from within the audio file page). | ||
* '''other''' ; this one covers every other cases. Though if | * '''uses material from'''; can link most filetypes together. | ||
* '''chapter-linker for'''; can link most filetypes together. Example: {{short|f413388|<nowiki>"Suzumiya Haruhi no Yuuutsu" chapter linker by [Hitsuji]</nowiki>}} | |||
* '''other'''; this one covers every other cases. Though if ''in doubt it's best to ask'' in IRC or in forum. | |||
{{eyecatch|Note|You can not relate generic files, create a relation between the same file or link files from different anime.}} | |||
=== How to create a File-File relation === | |||
To create a file relation between two files you just need to follow these steps. | To create a file relation between two files you just need to follow these steps. | ||
# If you haven't so, add both files | # If you haven't so, add both files | ||
# Open the file information page for the file that is related to the other file (for a external-sub-for you go to the subtitle file page) | # Open the file information page for the file that is related to the other file (for a external-sub-for you go to the subtitle file page) | ||
# Click on | # Click on ''new file relation'' on the lower part of the page | ||
# On the Add File-File Relation page select the type of relation and the related file | # On the Add File-File Relation page select the type of relation and the related file | ||
# Press | # Press ''Add'' and you are done | ||
[[Category:Guidelines]] | [[Category:Guidelines]] |
Latest revision as of 21:06, 14 May 2023
Overview
File relations, like the name implies, are relations between files on AniDB. There are two types of file relations; File-File and File-Ep. The former tells how two different files relate and the later tells how a file relates to different episodes.
File-Ep Relations
Imagine yourself with a file that spans two, or more, episodes. Until the introduction of file relations the only way to add this file to AniDB was to create a special episode that would hold your file. Now, for those kinds of files you can add file-ep relations.
How to create a File-Ep relation
To create a file relation between a file and an episode you just need to follow these steps.
- Add the file to the first episode it belongs
- Open the file information page for your file, by clicking in it's fid
- Click on "new episode relation" on the lower part of the page
- On the Add File-Ep Relation page fill the percentage of the given episode the file covers and select the episode
- Press "Add" and you are done.
Percentage ranges for file-ep relations
File-episode relations follow the rules of number lines for all integer numbers in the inclusive range [0,100]
. In simpler terms, ranges should be directly connected. Examples:
2 file release, each covering 1/2 of the episode: [0,50] --> 0% to 50% for part 1 [50,100] --> 50% to 100% for part 2
3 file release, each covering 1/3 of the episode: [0,33] --> 0% to 33% for part 1 [33,67] --> 33% to 67% for part 2 [67,100] --> 67% to 100% for part 3
4 file release, each covering 1/4 of the episode: [0,25] --> 0% to 25% for part 1 [25,50] --> 25% to 50% for part 2 [50,75] --> 50% to 75% for part 3 [75,100] --> 75% to 100% for part 4
Explanation of number lines when used for AniDB episode ranges
Correct: Ranges cover the entire number line when they are directly connected, as is the case with [0,25]
, [25,50]
, [50,75]
, and [75,100]
; there are no gaps in the number line.
Incorrect: If the ranges are not directly connected, as in the case with [0,25]
, [26,50]
, [51,75]
, and [76,100]
, the values in the range (25,26)
(e.g. 25.00000000001 to 25.99999999999), (50,51)
, and (75,76)
would be incorrectly excluded.
File-File Relations
Often you find yourself with files that are meant be together, for example you have a subtitle file for a video file. Until the introduction of file-relations the only way you had to show this connection was to add a file comment. Users would then have to open the file information page to be able to read your comment. Currently the new system allows you a greater degree of file relation possibilities.
Types of file relations
Currently there are the following possible file relations:
- external-sub-for; to relate a subtitle file to its respective video file.
- newer-ver-of; to indicate that there's a newer version of a given file (kind of like the current versioning system).
bundle; to indicate that a group of two, or more, files are related, and normally, needed in group.Deprecated- op/end-for; indicates that a given video file is an opening or ending to another video file.
- external-audio-for ; to relate an audio file to it's respective video file.
- uses material from; to relate a reencoded, remuxed, or other compiled file, to original source files. For example, if a remuxed file uses subs from file X and video from file Y, link the remuxed file to files X and Y.
- chapter-linker for; to relate "play-all" files to the associated video files.
- other; covers file relations that don't fit the other categories.
Rules
These are the rules for using file relations:
- external-sub-for; can only be used to relate a subtitle file to a video file (as in, you need to select the subtitle file and add a file relation to the video file from within the subtitle file page).
- newer-ver-of; can only be used to relate files of the same type (video-video), that are from the same episode and from the same, or related, groups.
- bundle; this kind of relation could be used, for example, to relate an idx to a srt file.
- op/end-for; can only be used to relate video files that belong to a Opening/Ending/Credits or an Other Episode to video files that belong on a Normal or Special Episode
- external-audio-for; can only be used to relate a audio file to a video file (as in, you need to select the audio file and add a file relation to the video file from within the audio file page).
- uses material from; can link most filetypes together.
- chapter-linker for; can link most filetypes together. Example: "Suzumiya Haruhi no Yuuutsu" chapter linker by [Hitsuji]
- other; this one covers every other cases. Though if in doubt it's best to ask in IRC or in forum.
Note | You can not relate generic files, create a relation between the same file or link files from different anime. |
How to create a File-File relation
To create a file relation between two files you just need to follow these steps.
- If you haven't so, add both files
- Open the file information page for the file that is related to the other file (for a external-sub-for you go to the subtitle file page)
- Click on new file relation on the lower part of the page
- On the Add File-File Relation page select the type of relation and the related file
- Press Add and you are done