Giter VIP home page Giter VIP logo

pivotal_to_pdf's Introduction

pivotal_to_pdf -- print the stories from pivotal tracker to a PDF file

Build Status Code Quality

DESCRIPTION

This is a gem that can read a story from pivotal tracker and print into a 4x6 card so that you can print the card and stick to your physical story board.

I steal the part of code from http://ephemera.karmi.cz/post/622136360/create-printable-pdf-cards-for-your-pivotal-tracker-stor The difference is the code there print to a A4 paper with 4 stories on it. This gem prints one card at a time and the gem doesn't require an exported csv file.

INSTALL

$ [sudo] gem install pivotal_to_pdf

USAGE

First you need to create a .pivotal.yml under your home directory. On windows, have this file in %HOME%.pivotal.yml

a sample .pivotal.yml:

token: your-api-token-of-pivotal-tracker
project_id: your-ptroject-id
formatter: PivotalToPdf::Formatters::Default

The meaning of the formatter key will be explained in the next section

After install the gem, you can do:

  • pivotal_to_pdf current_iteration # print stories for the current iteration into a PDF file

  • pivotal_to_pdf story STORY_ID # print a single story specifed by ID into a PDF file

  • pivotal_to_pdf iteration ITERATION_NUMBER # print a single iteration specifed by the number into a PDF file

  • pivotal_to_pdf label LABEL_TEXT # print stories matching the specified label into a PDF file

Examples:

pivotal_to_pdf story 159898

pivotal_to_pdf current_iteration

pivotal_to_pdf iteration 42

pivotal_to_pdf label print-these

Type in

pivotal_to_pdf help

pivotal_to_pdf help <command>

for more usage information

The gem will then read the story/stories and print it into a PDF file

The points section will be printed only for features. Bugs and Chores don't have points

Printed a green bounding box for feature, a yellow box for chores and a red box for bugs

The gem assumes that you have https access to the pivotal tracker

Formatters

From the version 1.3.0, The gem supports alternative formatter other than the default one. In the .pivotal.yml file, if you define a key like

formatter: PivotalToPdf::Formatters:MyPrettyHtmlWriter

The gem will use PivotalToPdf::Formatters::MyPrettyHtmlWriter to generate the output.

This feature is associated to the issue #14. I basically rewrite the code to implement this myself.

The actual formatters live in a seperate gem so that only that gem needs to be updated when needed. Once that gem is updated, you can do:

$ gem update pivotal_to_pdf-formatters

to use the new formatters being added

##Contributors

pivotal_to_pdf's People

Contributors

ywen2 avatar ywen avatar carols10cents avatar mogul avatar jpshackelford avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.