pdfname: Name a PDF file using information from the pdfinfo command

[ mit, pdf, program ] [ Propose Tags ] [ Report a vulnerability ]

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]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1, 0.1.1, 0.1.2, 0.1.3, 0.2, 0.3
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]
Tested with ghc ==8.2.1
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 repo head: git clone https://github.com/asr/pdfname
Uploaded by AndresSicardRamirez at 2017-07-30T06:11:23Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Executables pdfname
Downloads 4177 total (25 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2017-07-30 [all 3 reports]

Readme for pdfname-0.3

[back to package description]

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.