pdf-image-gen

Simple web app for generating a thumbnail image from a PDF document. Used to generate thumbnails displayed in the WGNHS publications catalog.

Live app: https://wgnhs.github.io/pdf-image-gen/

Development

Pre-requisites

• Git and Git Bash (if using Windows)

Note: This app relies on the WGNHS elements NodeJS package published at https://www.npmjs.com/package/@wgnhs/elements . The code for this package is located at https://github.com/wgnhs/wgnhs-elements . No installation via Node is needed - the package is accessed from https://cdn.jsdelivr.net/npm/@wgnhs/elements .

Publish changes

1. Clone this repository to your computer

    git clone https://github.com/wgnhs/pdf-image-gen.git
   

2. Move into the directory that contains the repo you just cloned

    cd pdf-image-gen
   

3. Checkout a new feature branch using Git

    git checkout -b my-feature-branch
   

4. Open index.html in the code editor of your choice, make desired changes and save.

5. Add, commit and push the changes using Git.

    git add index.html
    git commit -m "Updates to make this app even better"
    git push origin my-feature-branch
   

6. Sign into Github and navigate to this repository https://github.com/wgnhs/pdf-image-gen

7. Click Pull requests then New pull requests (or go to https://github.com/wgnhs/pdf-image-gen/compare)

8. Leave base:master, set compare to your working branch, ex compare:my-feature-branch and click Create pull request

9. Add any additional comments in the Description box click Create pull request

10. Click Merge pull request, then click Confirm merge

11. After the pull request is successfully merged, the built-in Github pages build deployment action will be triggered. This action builds the code and publishes it https://wgnhs.github.io/pdf-image-gen. Progress of this action also appears https://github.com/wgnhs/pdf-image-gen/actions .

Historical note

This app was previoulsy run on dev.wgnhs.wisc.edu , on port 8081, from an off-the-shelf Docker NGINX Alpine image. While there's record that the app once ran there and was stopped in March 2025, there's no record of the code that was running or its Docker config.