Repository is archived
No commit activity in last 3 years
No release in over 3 years
Renders Trello backups to HTML files. Operates on backups created by https://github.com/jtpio/trello-full-backup
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.17
~> 10.0
~> 3.0
 Project Readme

Update:

Archived as I no longer regularly use Trello.

trello_backup_renderer

Generates HTML files for Trello boards from backups created by jtpio/trello-full-backup.

  • Unlike Trello's built-in print functionality, it includes all card cover images and comments for the board in a single document.
  • Can be run locally without authorizing a third-party service to access your Trello data.

You can view a sample file generated by the tool here.

(I am not affiliated with Trello in any way.)

Installation

$ gem install trello_backup_renderer

Usage

First, use jtpio/trello-full-backup to create a backup of your board. It's important to use the -t option.

Then find the folder in which the backup was created. This should contain a file BOARD_NAME_full.json, and folders such as 0_someLongLIstId. trello_backup_renderer uses the full.json file and also uses the files in the nested attachments directories, and depends on the folder name format that trello-full-backup generates. (It does not use the card.json or description.md files that trello-full-backup generates.)

Run the tool like this:

$ trello_backup_renderer PATH_TO_BOARD_BACKUP_DIR

This will create a BOARD_NAME_full.html file in the given directory. This file may contain relative links to the attachment files in that directory.

Options

A default stylesheet is embedded into the HTML file; if you don't want it included, use the --omit-styles option. You can also link to your own stylesheet using the --head-insert option:

$ trello_backup_renderer PATH_TO_BOARD_BACKUP_DIR --omit-styles --insert-head='<link href="path/to/stylesheet.css" rel="stylesheet">'

By default, the full name of every comment author is included along with the comment. If the board is private and has only one comment author, you may wish to omit their name. To do this, use the --hide-authorship option:

$ trello_backup_renderer PATH_TO_BOARD_BACKUP_DIR --hide-authorship

Supported Features

Currently only the following data is included in the generated HTML page:

  • Lists
    • Names
  • Cards
    • Covers (when they're attachments)
    • Names
    • Labels (name and color)
    • Descriptions (without formatting)
    • Comments (without formatting)

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

A script bin/scrub_test_data is included which can be run against a board backup directory to remove attributes and files which are unused by trello_backup_renderer and replace IDs and member names with placeholder values. This was used in creating the test data seen in spec/test_board. Warning: The scrub_test_data script deletes data from the specified directory in-place.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/brokensandals/trello_backup_renderer.

License

The gem is available as open source under the terms of the MIT License.