The pdfname package

[Tags:mit, program]

The pdfname command-line program names a PDF file using the author, year of creation and title information extracted from the pdfinfo program.


[Skip to Readme]

Properties

Versions 0.1, 0.1.1, 0.1.2, 0.1.3, 0.2
Change log CHANGELOG.md
Dependencies base (>=4.9.1.0 && <4.11), directory (>=1.3.0.0 && <1.4), filepath (>=1.4.1.1 && <1.5), optparse-applicative (>=0.14.0 && <0.15), pdfinfo (>=1.5.4 && <1.6), text (>=1.2.2.2 && <1.3) [details]
License MIT
Copyright Andrés Sicard-Ramírez 2017
Author Andrés Sicard-Ramírez with contributions by Juan Pedro Villa-Isaza.
Maintainer Andrés Sicard-Ramírez <asr@eafit.edu.co>
Category PDF
Home page https://github.com/asr/pdfname#readme
Bug tracker https://github.com/asr/pdfname/issues
Source repository head: git clone https://github.com/asr/pdfname
Uploaded Fri Jul 21 03:37:41 UTC 2017 by AndresSicardRamirez
Distributions NixOS:0.1.3
Downloads 144 total (144 in the last 30 days)
Votes
0 []
Status Docs not available [build log]
Last success reported on 2017-07-21 [all 3 reports]
Hackage Matrix CI

Downloads

Maintainer's Corner

For package maintainers and hackage trustees

Readme for pdfname

Readme for pdfname-0.2

pdfname Hackage version

Description

The pdfname command-line program names a PDF file using the author, year of creation and title information extracted from the pdfinfo program.

Prerequisites

Installation

The program can installed with the following commands:

$ cabal update
$ cabal install pdfname

Usage

Just run pdfname on your PDF file.

How is the FileName Chosen?

Given the author, year of creation and title information extracted from the pdfinfo program (fields Author, CreationDate and Title, respectively) the name of the PDF file will be

author-year.title.pdf

where author and title are the strings obtained after making certain substitutions (e.g. remove whitespace, translate non-ASCCI characters and remove TeX/LaTeX specific information) to the information shown by the pdfinfo program.

Example. Let's suppose that running pdfinfo on the file foo.pdf shows the following (fictional and incomplete) information:

$ pdfinfo foo.pdf
Title:          Introducction to the <TEX>$\lambda$</TEX>-Calculus
Author:         Per Martin-Löf
CreationDate:   Fri Apr  9 07:14:01 2010

Now, running pdfname on that file will create the new file

/tmp/martin-lof-2010.introduction-to-the-lambda-calculus.pdf

Bug Reporting

Use the bug tracker for reporting bugs.

If your bug includes a PDF file it is not necessary to disclose nor to attach the file. All that it is necessary is the minimal PDF metadata required for triggering the bug. There are various GUI, online and command-line tools for modifying the PDF metadata.

Known Errors

If a PDF file or its metadata information is damaged pdfname (via the pdfinfo library) generates an error. Known errors are the followings:

fd:5: hGetContents: invalid argument (invalid byte sequence)
Error: May not be a PDF file (continuing anyway)
Error: PDF file is damaged - attempting to reconstruct xref table...
Error: Couldn't find trailer dictionary
Error: Couldn't read xref table

If you get a different error message, please report it.