Issues sweep

New features

• NEW The --clean option has been added; this deletes any unused resources from the output
• NEW Covers! You can now add cover templates for increased presentation value.

Bug fixes and improvements

• FIXED Image paths in templates are now considered relative to the template file, rather than the datasource
• FIXED Back faces are now generated in the proper order for unconventional card sizes
• IMPROVED Generated output has been cleaned up and now takes less space
• IMPROVED Card cut guides are now re-used properly within the generated document, which means smaller output sizes
• CHANGED Columns are now passed to both front- and back templates; add either suffix @front-only or @back-only to limit to one or the other

Useful additions and bug fixes

New features

• NEW An optional header template can now be added with the --include-header option; e.g. --include-header=path/to/header.html
• NEW Set prototype rows in datasources using the ~-character in the @count column (see #122)

Bug fixes and minor improvements

• FIXED Datasources containing backs mixed with datasources not containing backs could cause two-sided synchronization problems when printing
• IMPROVED Every page now displays a title showing the datasources used for the page

Shiny new interface!

This release adds a nice and modern interface to the final build output, and provides useful additions/fixes to building projects. Also fixes some pesky bugs.

New features

• NEW The interface has had a complete overhaul and now looks better than ever!
• NEW Card backs can now be toggled directly from the interface
• NEW Card templates can now embed styles (see the new example)
• NEW Columns can now be excluded (surround the column in parentheses, e.g. rank,(name),text)
• NEW Building projects now reveal number of errors/warnings, build time and no longer shows duplicate warnings
• NEW Putting in the same template is no longer required for each and every card; just reference the previous one by pointing up ^ (see the new example)!
• NEW Automatically checks for new version

Bug fixes and minor improvements

• FIXED Template fields can no longer recurse infinitely
• FIXED Markdown formatting did not work as expected in some cases
• IMPROVED Template fields now use a standard format for increased consistency

Major release: Commands, Markdown and much more!

This release marks a major release, introducing a new and improved usage model with commands.

Additionally provides several internal improvements, the date field and partial Markdown support.

Notable changes

• NEW Commands introduced: use make and new to build and create new projects
• NEW Markdown can now be used in datasources to format text
• NEW Inline field has been added to include minified content
• NEW Date field has been added to easily show build date
• IMPROVED Program help/usage display has had a complete overhaul
• IMPROVED Empty fields are now removed
• FIXED Images are now properly copied to the output directory
• FIXED Command-line output is now displayed properly on Windows
• FIXED Cut guides are now displayed properly

Exclude rows and find unused definitions

This release provides some minor, but useful, additions that clears up various issues.

Notable changes

• NEW Rows can be excluded by pre-fixing a '#' character at the beginning of the line
• NEW The --preview argument has been added; use it to only render 1 of each card
• NEW A warning is now displayed when a project contains unused definitions
• NEW A warning is now displayed when a datasource contains invalid column names
• FIXED Image fields have had improvements to the way they resolve
• REMOVED The -f/--input-filename argument has been removed; it was unnecessary

Include, row references and better performance

Two very useful features have been added: the include field and the ability to reference columns from other rows!

This release also adds performance optimizations and a bunch of bug fixes.

Notable changes

• NEW Templates can now include commonly used parts so you don't have to maintain the same thing in a bunch of different places: just put down a {{ include 'another-file.html' }} and you're rolling! Note that this also works for column content!
• NEW Columns in other rows can now be referenced! This works just like other column references, except you add the number of the row you want, like this: {{ title #7 }}
• FIXED Images fields are now resolved properly in definitions.
• IMPROVED Images and resources are now only copied to the output directory if necessary.

Column references

Lots of new useful features!

Notable changes

• NEW Program argument --size has been added to allow setting a default card size
• NEW Other columns can now be referenced in data and works exactly like in templates
• NEW A new _card_copy_index field has been added- useful for numbering identical cards
• NEW Definitions now resolve image fields properly (with the exception of the _version field 😬, see #47)
• FIXED Toggles for showing or hiding footer and cut guides now work correctly
• FIXED Warnings about unused columns/fields now take column references into consideration before showing a warning

Interactive page output

This release brings improvements to general usage by adding interactivity to the generated pages. This is in the form of buttons to toggle certain things that previously had to be specified as a program argument.

Notable changes

• NEW Print button has been added for quickly reaching the print dialog
• NEW Page footer and cut guides can now be toggled directly on the pages
• NEW Page total is now shown on pages
• REMOVED Program arguments --disable-cut-guides and --disable-footer have been removed in favor of toggle buttons

Installable and bug-fix extravaganza!

This release makes cards.py installable! It also adds a lot of test cases, and as a result also provides a whole slew of bug fixes and smaller improvements.

Notable changes

• NEW Added setup.py which allows for installing the script for easy access anywhere on the command-line
• NEW Program argument --output-filename has been added to allow output with a different filename than index.html

Symbolic definitions and improved printing

This release includes support for symbolic definitions (or variables, references- whatever you prefer). It also improves printing by having more useful cut guides and a more useful footer.

Notable changes

• NEW Added support for symbol definitions. No more search-and-replace for oft-used values
• NEW Cut guides are now fit to the cards, allowing support for more card sizes in the future
• NEW Program argument --disable-footer has been added to hide the footer on pages
• IMPROVED Footer contents now includes more useful information (and looks better)
• IMPROVED Simpler CSS for tighter printing (note that Chrome creates the best result)
• REMOVED The meta.py module has been removed in preference of symbol definitions