Skip to content

Instantly share code, notes, and snippets.

@steinuil
Last active August 29, 2015 14:06
Show Gist options
  • Save steinuil/05c978681a69a3448bda to your computer and use it in GitHub Desktop.
Save steinuil/05c978681a69a3448bda to your computer and use it in GitHub Desktop.
The Helvetica Scenario default naming scheme

This document defines how manga releases hosted on The Helvetica Scenario and the files inside them have to be named.

This is to avoid a cluserfuck of filenames, which only makes the user experience worse and makes finding files a mess.

Archives

The chapter archives (which should always be compressed in .zip as it's ubiquitous and open source) have to be named using this scheme:

Series Name v04c32x1 [Group Name]{r2}.zip

The elements mentioned in this example will be explained here:

Series/Oneshot Name

This is the series name.

It has the most common name for the series (the one with which the series is referred to on mangaupdates).

Volume (v##)

The volume number has to be indicated whenever the raws come from a tankoubon (this always being the case for Helvetica since we don't scanlate from magazine raws) in the v## format, where ## is the volume number with a padding zero if the volume number only has one digit.

As Helvetica does not work on series with three digit volume numbers, the scheme only calls for two digits.

Examples
Mushi-shi v14
Acony v03

Chapter (c###/c##)

The chapter number has to be indicated in the c### format (where ### is the chapter number with three padding 0).

For already finished series with less than 100 chapters the number can be indicated with c## instead.

Examples
The World God Only Knows v11c097
Acony v03c20

Extra (x#)

If the chapter is an extra/omake/whatever, it should be named the same as the previous chapter with an x# after the chapter number.

Examples
Acony v02c15
Acony v02c15x1 <--- Extra chapter

Group Name

The group name has to be be included whenever the scanlation group name is known, enclosed in square brackets.

Examples
Acony v02c13 [red rabbits]

Revision number {r#}

The revision number has to be indicated whenever the release is a revised version of an already released chapter.

It should always be put after the group name and enclosed in curly brackets.

Examples
Acony v03c19 [The Helvetica Scenario]{r2}

Usage

The naming scheme can be adaptated to various usages.

Chapter release

The chapter releases always have to be named using this scheme:

Series Name v04c32x1 [Group Name]{r2}.zip
Examples
Acony v02c15x1 [red rabbits].zip
Acony v03c19 [The Helvetica Scenario]{r2}.zip
Sora no Woto v01c06 [The Helvetica Scenario].zip

Volume batches

The volume batches (which should only comprehend one volume at a time) should be named like this:

Series Name v## [Group Name].zip

If the volume batch is made out of scanlations by different groups, all of them have to be indicated one after the other in order of appearance.

For example, if chapter 1 and 2 were scanlated by The Rabbit Reich, chapter 3 was scanlated by red rabbits, chapter 4 by The Rabbit Reich again and chapter 4 by The Helvetica Scenario, the volume batch name would be:

Series v01 [The Rabbit Reich][red rabbits][The Helvetica Scenario]

The volume batch should always be final, so the revision number mustn't be indicated.

Examples
Sora no Woto v02 [The Helvetica Scenario].zip
Acony v02 [The Rabbit Reich][red rabbits].zip

Edge cases

When dealing with a large amount of manga you easily stumble upon cases where normal naming rules can't be applied.

As Helvetica isn't such a large group and only scanlates a limited number of mostly normal manga, a lot of edge cases aren't really contemplated. When "porting" this scheme to other scanlation groups, one should consider the kind of manga the group in question is dealing with and edit this section to suit their needs.

Additional Information

The additional information field is to be included in parenthesis and comes right before the group name and after the volume/chapter/extra fields.

Oneshot

If the manga is a oneshot it must use this naming scheme:

Oneshot Name (Oneshot)[Group Name]{r#}.

Files

The files have to be named using the following scheme:

Acony/
+-- Volume 01/
|	+--	Chapter 01/
|	|	+--	000a.jpg
|	|	+--	000b.jpg
|	|	+--	001.jpg
|	|	|	[…]
|	|
|	+--	Chapter 02/
|	+--	Chapter 03/
|	+--	Chapter 03/
|	+--	Chapter 04/
|	|	+--	087.png
|	|	+--	088.png
|	|	+--	089.png
|	|	|	[…]
|	|	+--	107.png
|	|	+--	credits.png
|	|
|	+--	Chapter 05/
|	+--	Chapter 06/
|	+--	Chapter 06.1/
|
+--	Volume 02/
|	[…]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment