v4.3.0

New features

With this version, Percollate gains the ability to interpret Atom and RSS web feeds. When a feed is passed as an operand, every entry in the feed gets its own article, and you can decide if you keep them in one bundle or split them into individual files with the --individual flag:

# single EPUB file with all the entries in the feed
percollate epub https://example.com/posts.xml

# one HTML file, with images embedded, for each entry in the feed
percollate html --inline --individual https://example.com/posts.xml

Web feeds come in many shapes and forms, please log an issue or comment on the attached discussion for cases where a feed is interpreted incorrectly.

v4.2.4

Fixes

• Handle Blogger (*.blogpost.com) full-size images better in cases where the wrapping <a> element links to what looks like an image but is in fact a HTML page with an <img> element inside. Previously this led to broken images.

Other changes

• When embedding images with the --inline flag, preserve the original src / srcset values in the corresponding data-original-* attributes.
• Updated @mozilla/readability to 0.6.0 (changelog), along with a few other runtime dependencies.

v4.2.3

Fixes

• Handle images whose URLs don’t end in a file extension that allows us to identify the image’s MIME media type. In these cases, use the generic image MIME type (e.g. in inline data: URLs when the --inline flag is used) and the .image file extension (e.g. when bundling external resources for EPUBs). Support for these may vary with the browser / EPUB reader. (#174)

v4.2.2

Fixes

• Adds an --unsafe flag, allowing to bypass some JSDOM validation to process slightly-invalid HTML pages (#177)

v4.2.1

Fixes

• Fetching article images (when using the --inline flag, or when producing EPUBs) now sends the Referer header as the browser would when rendering the article (using the strict-origin-when-cross-origin referrer policy) (#172). Note that when producing HTML or PDF documents of web pages containing images that require a Referer header, you’ll need to use the --inline flag.
• Use a fallback when slugifying an article title results in the empty string.

v4.2.0

New features

Compress entries in the EPUB file with the DEFLATE algorithm at maximum level of compression (#169).

v4.1.1

New features

Adds the --toc-level=<level> option. By default, the table of contents is a flat list of article titles. With the --toc-level option the table of contents will include headings under each article title (<h2>, <h3>, etc.), up to the specified heading depth. A number between 1 and 6 is expected. Using --toc-level with a value greater than 1 implies --toc.

v4.0.5

Bug fixes

• Fixes handing of nested <pre> tags on the Rust reference one-pager (#165)

v4.0.4

Bug fixes

• Updated to [email protected] and fixed the loading of language patterns for hyphenation when percollate is used as a npm package (See #163, hyphenopoly#207). With thanks to @mnater, @yashha.

v4.0.3

Bug fixes

• Fixes usage of mdast-util-gfm to allow serializing HTML <table> elements to Markdown when using percollate md (#161)