Thanks for your work providing this tool. I ended up here looking for an alternative to python stapler.

There's a lot of good and important stuff on the README.

Please add one or two lines, at the top of the README with the most important stuff. How to install it.

It might be obvious to you, a python developer, but not for a potential end user. Is it using "pip install xyz" ? Will it work with pipx ? Are there any "official" packages for Linux distro xyz ?

Thanks in advance.

Closes #1

Added a test input in book-rotate.md as well.

I've been using pdftk a lot recently, but pystitcher definitely works better for me. Thanks for working on it!

Thanks for the great code, it worked well for me putting books back together from chapters in Elsevier. The only issue I had was that it required using Python 3.9 at a minimum. I initially had an error under Python 3.7, complaining about line 56 of skeleton.py with reference to argparse.BooleanOptionalAction ; I lost the actual error message e.g see here for related.

Starting Integration tests. Currently tracks:

• [x] Sticher functionality by generating all test files
• [x] Number of pages in these test files
• [x] Bookmarks (title/destination page number)
• [x] Bookmark level
• [x] PDF metadata
• [x] Attributes: Rotation
• [x] Attributes: Page Selection
• [x] Run CI tests on GitHub Actions
• [x] Generate coverage reports

Missing testcases:

• [ ] Remote fetching (Will take this up later)
• [x] Custom Title
• [x] H2/H3 as bookmarks
• [x] Disable cleanup and validate

[Personal Data Protection Bill, 2019](1.a.pdf){: zoom=FitWidth}

Other options:

    Inherit - Inherit zoom
    FitPage - Fit page width+height
    FitWidth - Fit page width
    FitHeight - Fit page height
    ##% - Zoom to ##% eg 50% = 50% zoom

# Title

- [chapter 1](https://example.com/chapter1.pdf)
- [chapter 2](https://example.com/chapter2.pdf)

Download the PDFs, cache them and merge accordingly.

Want to be able to add page numbers to the generated PDF with font configuration. Use case - Printouts. Once this is done, easy to add a Table of Contents too. #6

I was exploring and found this as one option: https://github.com/vlad-anisov/numbering2pdf/blob/main/numbering2pdf/numbering2pdf.py It uses reportlab to generate empty numbered PDFs and merges those pages with the existing pages one by one.

Happy to work on this issue, if you suggest a preferred method (given your research) to implement this.

Currently, we switch our CWD to the markdown file directory, and don't reset it back. Playing around with chdir is bad and causes issues.

Fix this to instead use paths relative from the markdown file directory.

Within the markdown, provide a way to declare pages that get rendered as stand-alone pages as well.

<!-- This only goes in bookmark-->
# Cover

![Cover](cover.pdf)

# Colophon

```
# Hobbit
## There and back again
## By JRR Tolkein
```{: inline=1}

![Foreword](foreword.pdf)

Renders a cover, a single page with the 3 lines as above, and then the foreword. So the colophon ends up linking to the middle text section

# Title

- [chapter 1](https://example.com/chapter1.html)
- [chapter 2](https://example.com/chapter2.html)

Download the source HTML, run it through readability, then render as PDF and merge accordingly.