Comic Folder's Structure

Thank you for using my comic parsing APP! This guide will help you understand how to organize your folder structure so that the APP can correctly parse your comic content.

Basic Folder Structure

Our APP uses a three-level hierarchical structure to organize comic content:

  1. Main Folder: Represents a complete comic series
  2. Subfolders: Represents each individual comic book in the series
  3. Image Files: Represents each page in the comic

Folder Naming and Sorting

Comic Book Sorting (Subfolders)

Subfolders are sorted by name by default. To customize the sorting order, we provide a special naming convention:

1
number_name

For example:

  • 1_Volume One
  • 2_Volume Two
  • 10_Volume Ten

Important Note: When using the “number_name” format, the APP will automatically omit the number and underscore during parsing, displaying only the “name” part. This allows you to control sorting while keeping the display names clean.

Comic Page Sorting (Image Files)

Image files are also sorted by name. To ensure the correct page order, we strongly recommend using simple numerical naming:

1
1.jpg, 2.jpg, 3.jpg...

Cover Image Setting

If you want to set a specific cover image for a comic book, simply place an image file named thumbnail.png (or thumbnail.jpg/thumbnail.jpeg/thumbnail.webp) in the subfolder.

Special Notes:

  • This specially named image will be used as the cover display for that comic book
  • The cover image will not be counted as a content page in the comic
  • Supported cover image formats are the same as regular pages: jpg, jpeg, png, webp

Supported Image Formats

The APP currently supports the following image formats:

  • JPG/JPEG
  • PNG
  • WEBP

Complete Example

A standard comic folder structure example:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
My Comic Series/
├── 1_Volume One/
│ ├── thumbnail.jpg
│ ├── 1.jpg
│ ├── 2.jpg
│ └── 3.jpg
├── 2_Volume Two/
│ ├── 1.png
│ ├── 2.png
│ └── 3.png
└── 3_Volume Three/
├── 01.webp
├── 02.webp
└── 03.webp

By organizing your folders according to this structure, the APP will correctly recognize “My Comic Series” as a complete comic series containing three independent comic books: “Volume One”, “Volume Two”, and “Volume Three”, each with 3 pages of content, and “Volume One” has its own dedicated cover images.

Enjoy using the APP!

作者

徐炜楠

发布于

2025-03-26

更新于

2025-03-26

许可协议