Release Notes

4.2.0 (2022-11-10)

Fixes
- Fix bug preventing some Matplotlib figures from being converted to SVG and HTML (#127)

Fixes
- Set minimum page height to fill device screen
- Read page additional output options when publishing HTML and PDF

Fixes
- Remove call to fig.tight_layout() when converting Matplotlib figure to SVG for PDF

API
- Page now accepts max_width and output_options arguments
- Content classes no longer accept width or height arguments
New Features
- Output rendering options can now be configured at page level
- Additional markdown features recognised
Fixes
- JavaScript is now placed at end of page so HTML is loaded first
Page Style
- Removed unnecessary indentation
- Tables now render in minimal, clean style
- Improvements to sizing and centring of plots
- Cleaned up unnecessary HTML and CSS
- Majority of CSS attributes moved to esparto.css
Dependencies
- Pillow is now optional
- BeautifulSoup4 is now required
- Upper version limits removed from all
Other
- Type hints implemented with ~100% coverage

New Features
- Links to Bootswatch CDN for page themes
- Reorganise and add options to esparto.options
- Table of Contents generator for Page element
- Save and Load config options
- Define Columns and Cards as dict of {"title": content}
- Add or replace Content by positional index
New Layout Classes
- CardSection: Section with Cards as the default Content container
- CardRow: Row of Cards
- CardRowEqual: Row of equal width cards

New Layout class
- Card: Bordered container for grouping content
Updated Content class
- FigureMpl: SVG rendered plots now flex up to 150% of original size
Other
- Defined string and repr representations for current settings
- Updated CSS so maintain distance from header if main title is not defined
- Updated content adaptor to allow other Layout objects as valid children for Column

New Layout classes
- Spacer: make an empty column within a Row
- PageBreak: enforce a page break in printed / PDF documents
New Content class
- RawHTML: place raw HTML code in the page
Updated Content classes
- DataFramePd: add new CSS style to minimise row height
- FigureMpl: SVG rendered plots are now responsive and horizontally centred
New publishing features
- CSS stylesheet path can be passed to options.css_styles
- Jinja template path can be passed to options.jinja_template