EpubChapterize

A tool to split out chapters from ePub documents. Initially just for Project Gutenberg ePub3s.

Setup

To set up the project, follow these steps:

1. Clone the repository:

   git clone https://github.com/yourusername/EpubChapterize.git
   cd EpubChapterize

2. Create a virtual environment:

   python -m venv venv

3. Activate the virtual environment:

   • On macOS/Linux:

     source venv/bin/activate

   • On Windows:

     venv\Scripts\activate

4. Install the required dependencies:

   pip install -r requirements.txt

5. Install additional language models for spaCy (if needed):

   Depending on the languages you plan to process, you may need to install specific spaCy language models. Use the following commands to install them:

   • For English:

     python -m spacy download en_core_web_trf

   • For German:

     python -m spacy download de_dep_news_trf

   • For Italian:

     python -m spacy download it_core_news_trf

   • For Spanish:

     python -m spacy download es_dep_news_trf

   • For French:

     python -m spacy download fr_dep_news_trf

   If you are not using spacy then skip this step

Usage

This tool is primarily designed to extract chapters from Project Gutenberg ePub3 files. It works by analyzing the navigation structure, matching headers, and attempting to identify chapter divisions. Note that it may also include some preamble content, and its accuracy is not guaranteed.

To use the tool, run:

python chapterize.py /path/to/your/epub/files/ 

or

python chapterize.py 

which will use the books directory by default

Notes

• The tool is not perfect and may require manual adjustments to the output.
• It is currently a standalone script but may be packaged in the future.
• Feel free to fork the repository and modify it as needed.

Contributing

If you encounter any issues, please raise a ticket in the repository. Contributions are welcome!