Content:File relations: Difference between revisions

From AniDB
Jump to navigation Jump to search
No edit summary
 
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{TOCright}}
{{TOCright}}
= What are File relations? =
==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, there are two types of file relations, [[Content:File_relations#File.3C-.3EFile_Relations|File<->File]] and [[Content:File_relations#How_to_create_a_File.3C-.3EEp_relation|File<->Ep]].
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<->Ep Relations ==
==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<->Ep relation ===
=== 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<->File Relations ==
=== 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:


Currently there are a total of six 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 it's respective video file
* <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 '''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)
* '''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).
* '''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)
* '''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 '''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
* '''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
* '''bundle''' ; this kind of relation could be used, for example, to relate an idx to a srt file
* '''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 '''in doubt''' it's best to '''ask''' in irc or in forum
* '''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>}}
'''Notes''': you can not relate generic files nor can you create a relation between the same file, you also can not link files from different animes.
* '''other'''; this one covers every other cases. Though if ''in doubt it's best to ask'' in IRC or in forum.


=== How to create a File<->File relation ===
{{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 "new file relation" on the lower part of the 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
# On the Add File-File Relation page select the type of relation and the related file
# Press "Add" and you are done
# 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.

  1. Add the file to the first episode it belongs
  2. Open the file information page for your file, by clicking in it's fid
  3. Click on "new episode relation" on the lower part of the page
  4. On the Add File-Ep Relation page fill the percentage of the given episode the file covers and select the episode
  5. 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.

  1. If you haven't so, add both files
  2. 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)
  3. Click on new file relation on the lower part of the page
  4. On the Add File-File Relation page select the type of relation and the related file
  5. Press Add and you are done