npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

handgen

v1.1.2

Published

Handout Generator package that has a Handout class that exposes a createHandout method for generating handout pdfs from jpg, png and/or pdf. https://www.npmjs.com/package/handgen

Downloads

1

Readme

Handout Generator

Bugs:

  • Some pdf pages come out with the wrong orientation in the final handout.pdf
    • I am unable to find a smooth solution. The pdf-lib library I use has not been maintained for 2 years. If a slide is in the wrong rotation, only way is to rotate every single slide/page of the powerpoint/pdf manually or by using a program.

To Add:

  • Support for pptx

(README WIP)

Handout Generator was created to give more options to creating a handout like the ability to create a handout from the command line (TUI) and the ability to customize the template of the handout (ex. # of images, # of lines, # of textfields, their positions, their size and etc.).

However, as of now, only the TUI portion of the feature has been implemented. Customizability will be added after the frontend is finished.

Major Goals

  1. Create a website that will allow people to create custom templates and generate handouts using a GUI (also allow people to download the custom templates as JSON and allow the templates to be imported into the TUI version: handgen)
    1. Reason on the focus for a GUI to create templates is because the only way I can think of to create a custom template without a GUI is to create a JSON file from scratch and importing that into the program via a flag, but that can be really annoying and frustrating to debug for the end user if something goes wrong.
  2. Create the backend with user authentication & database for storing custom templates.

Table Of Contents:

How To install:

Instructions for Global Installation:

  • handgen uses 4 flags: -i, -o, -default, -online
    • -i (required)
      • Specifies the path to the asset directory where all of the source images & pdfs are going to be at.
    • -o (optional)
      • Specifies the path of the pdf file produced by handgen
      • When flag is not specified, the default path is in the same directory handgen is executed, and the pdf name will be called "handout.pdf".
    • -default (optional)
      • Specifies the id of one of the default handout templates
      • When flag is not specified, the default ID will be "ThreeTraitLine".
    • -online (optional)
      • Not available yet, but it also specifies the id of a handout template from cloud.
      • When flag is not specified, the program will use the default template specified above in "-default".
      • -default and -online may not be used as flags at the same time.

Default Template IDs:

One Image Per Page

Two Image Per Page

  • TwoTraitNothing
    • A portrait mode template with two pictures, one picture on top and one picture on bottom.
  • TwoScapeLine
    • A landscape mode template with two pictures, one picture to the left and one picture to the right, and contain lines below each picture.
  • TwoScapeField
    • A landscape mode template with two pictures, one picture to the left and one picture to the right, and contain a field below each picture.

Three Image Per Page

  • ThreeTraitLine [DEFAULT]
    • A portrait mode template with three pictures to the left and lines to the right of each picture.
  • ThreeTraitField
    • A portrait mode template with three pictures to the left and a textfield to the right of each picture.
  • ThreeScapeLine
    • A landscape mode template with three pictures and lines below each picture.
  • ThreeScapeField
    • A landscape mode template with three pictures and a textfield below each picture.

Four Image Per Page

Fundamentals - How It Works

Before we delve into how to use handgen in a JS project, we first have to go over the components and the structures that a handout template use to create a handout pdf:

  • Page
  • Pictures
  • Lines
  • Textfield
  • Text

What is a template?

  • A template is the building block used to build a component (the actual page/picture/line/etc.)
  • A template specifies the attributes of of a component.
    • For example, for a line component, you might specify the width and height of a picture component.
  • All templates comes from JSON objects.

Page Template

  • A page template contains the following components: pictures, lines, textfield and page number. It is also possible to tweak the width or height of a page template.
  • There can be more than one page template in a handout template. For example, on one page, you might want three pictures, and on another page, you might want one picture instead.

Pictures

  • A picture template can be an image (png, jpg, jpeg) or a pdf.
    • This means that both images and pdf can be crammed (embedded and/or minified) into the handout pdf.
  • The type for a picture contains the following properties (or attributes): width, height, x and y coordinates.

Lines

  • A line template is a straight line with the color black.
  • The type for a line contains the following properties: x1, y1, x2, y2 coordinates.

Textfield

  • A textfield template is a rectangular box where the inside of the box is writeable with a keyboard.
  • The type for a textfield contains the following properties: width, height, x and y coordinates.

Page Number

  • A page number template specifies the location where a page number is located on a page.
  • The type for a page number is called a Label, and a Label contains the following properties: size, x and y coordinates.
  • Planned on being optional

Explanation for Handout Class

To use the Handout class. First, you need to instantiate a handout

import { Asset, TemplateRepo, Handout } from 'handgen';

const handout = new Handout();

There is only 1 method exposed from Handout, and that is createHandout(assets, templateID, repo).

  • assets: Asset[] -> Contains an array of assets, which are the images, pdf and/or pptx that you would like to insert into the resulting handout pdf.
    • Type Asset is a type that specifies that an object must contain two properties: "type" and "bytes".
      • type is a string property that holds the extension of the asset that got turned into a byte.
      • bytes is the buffer of the asset (image or pdf file).
  • templateID: string -> Currently only supports default provided template ID.
  • repo: TemplateRepo -> Specifies if the template is coming from local (default templates) or from remote (online templates)
    • Type TemplateRepo is a string of either "default" or "online";