Please see the Releases tab on GitHub for the changelog.
Here are the release notes for older versions, kept here for historical purposes.
- Use the value of the
--output
option as a prefix for file names when converting multiple files with the--individual
flag. - Switched
fetch
implementation fromgot
to the smallernode-fetch
package.
Fix -V / --version
argument parsing.
Fix template resolution issue introduced in 0.6.0.
- Upgraded to latest version,
and devendorized,@mozilla/readability; - Enhancement: remove
loading=lazy
attributes; - Bugfix: identify AMP version when the
rel
attribute has multiple, space-separated values. - Bugfix: add underlines to links in Apple Books
You can now generate (basic) EPUB and HTML with the epub
and html
commands, respectively.
Added the ability to read HTML content from stdin
with the -
operand; you can pass the original URL with the -u
/ --url
option.
Enhancement: expand <details>
elements.
Chore: upgrade dependencies to their latest version.
Prefer the AMP version of an article, if available. Details here.
Support for lazy-loaded images. (#71)
Increased Puppeteer navigation timeout to 2 minutes. (#80, thanks @butu5!). Also added a --debug
flag to print more information about the process.
Fixed URL encoding before fetching it. (#83, thanks @ncsing!)
Generate a Table of Contents page (#81, thanks @guybedo!) when using the --toc
option.
Fixes bug with the URL class not being globally available in Node < 10. (#64, thanks @tanmayrajani!).
Adds usage examples to the CLI help output. (#55, thanks @opw0011!)
Adds percollate/${version}
user-agent to prevent some HTTP 405 errors (#59).
We now perform relative to absolute URI conversion inside Percollate itself rather than rely on Readability (#33, thank you @ramadis, @tanmayrajani for the help!). This includes the srcset
attribute, which caused images to be broken on some sites (#58).
Made imagesAtFullSize
ignore Wikipedia image file links (#42).
Percollate now emulates a high-resolution display, which in some cases helps get the best quality image available.
Adds new enhancement, singleImgToFigure
, that transforms single images into <figure>
elements, using the image's alt
attribute as <figcaption>
.
Preserve anchor
class on hyperlinks, hide them when they're part of a heading. (A common pattern for Markdown to HTML tools).
Align ol
and ul
elements to match paragraph indentation.
- Fixes indentation of images wrapped in
<p>
tags (#48) - Adds basic styles for tables (#50), figures, definition terms, et cetera.
- Adds a better font stack, using CSS variables
- Better CLI feedback with ora (thanks @emersonlaurentino!)
- Bump required Node version to 8.6.0 (#45)
- Show help when no arguments provided or command chosen (#36, thanks @tanmayrajani!)
- Don't append the HREF for in-page anchors or anchors which have the full URL as their text content (#31)
- Started separating the CLI from the Node library, working towards a programmatic API (Thank you, @phenax!)
- Adds
--individual
flag to export many pages as individual PDFs (#38)
- Adds a default output file path when the
--output
option is omitted (#37)
- Added support for inline CSS styles via the
--css
option (#27)
- Added the ability to run
percollate
with the--no-sandbox
Puppeteer flag
- More print styles to handle blockquotes and
aria-hidden
elements; re: #19
- Adds article header, including byline, where it exists, and the source URL (#18)
- Some Wikipedia-specific enhancements: remove
edit
links next to headings. - Added more print styles to the default stylesheet.
- Fixes relative links (#12)
- Deprecates short names for some options (#16)
- Fixes template path resolution (#17) when percollate is installed globally
- Adds support for a custom page header/footer via the HTML template and CSS stylesheet
- Uses Puppeteer's
preferCSSPageSize
to make the page size and margins configurable from the CSS
- Only replace single image SRCs with their parent's HREF if the latter matches an image file
- Introduces separate commands. For now, the
pdf
command is implemented. - Adds the ability to specify a custom HTML template / custom stylesheet.
- Run
percollate
as a CLI tool that takes one or more URLs and bundles them into a single PDF file.