App-PDF-Link
view release on metacpan or search on metacpan
res/pod/pdflink.pod view on Meta::CPAN
Borders are always drawn for links without icons.
=item B<--gfunder>
Drawing the icon images uses the page transformations in effect at the
end of the page. If these were not neatly restored, the graphics may
be misplaced/scaled/flipped.
By using B<--gfunder>, the images are placed behind the page
but this only works for transparent pages.
This option is only relevant when adding links to external files. With
B<--embed> the problem does not occur.
=item B<--targets=>I<FILE1> [ B<;> I<FILE2> ... ]
Explicitly specifies the target files to link to. In this case no CSV
is processed and the input PDF(s) are updated (rewritten) unless
B<--pdf> is used to designate the output PDF name.
=item B<--help>
Prints a brief help message and exits.
=item B<--man>
Prints the manual page and exits.
=item B<--ident>
Prints program identification.
=item B<--version>
Prints program identification and exits.
=item B<--verbose>
Provides more verbose information.
=item I<directory>
The directory to process. Defaults to the current directory.
=back
=head1 ICONS
B<pdflink> has a number of icons built-in for common file types.
Associations between a filename extension and an icon can be made with
the B<--icons> command line option.
For example,
--icons=pdf=builtin:PDF
This will associate the built-in icon PDF with filename extension C<pdf>.
Alternatively, an image file may be specified to add user defined icons.
--icons=pdf=builtin:myicons/pdficon.png
The following icons are built-in. By default, only MuseScore and
iRealPro icons are associated and all other filename extensions will
be skipped. When pdflink is run with command line option B<--all>, all
built-in icons will be associated and all matching files will get
linked.
=over
=item PDF
Associated to filename extension C<pdf> (generic PDF document).
=item PNG
Associated to filename extension C<png> (PNG image).
=item JPG
Associated to filename extensions C<jpg> and C<jpeg> (JPG image).
=item MuseScore
Associated to filename extension C<mscz> (MuseScore document).
=item iRealPro
Associated to filename extension C<html> (iRealPro link in HTML document).
While technically this is wrong, this is the way iRealPro data is
handled on Android and iPad.
=item BandInABox
Associated to filename extensions C<mgu>, C<mg1> and so on (Band-In-A-Box document).
=item MXL
Associated with filename extension C<xml> and C<musicxml> (MusicXML).
=item XML
Associated with filename extension C<xml> (generic XML document).
=item Document
Fallback icon for unknown filename extensions.
=item Border
Alternative fallback icon for unknown filename extensions.
=back
=head1 LIMITATIONS
Some PDF files cannot be processed. If this happens, try converting
the PDF to PDF-1.4 or PDF/A.
Files with extension B<html> are assumed to be iRealPro files and will
get the iRealPro icon.
Unknown extensions will get an empty square box instead of an icon.
Since colon C<:> and slash C</> are not allowed in file names, they
are replaced with C<@> characters.
If the icons come out at the wrong place or upside down, try
B<--gfunder>.
=head1 AUTHOR
Johan Vromans E<lt>jvromans@squirrel.nlE<gt>
=head1 COPYRIGHT
( run in 0.597 second using v1.01-cache-2.11-cpan-df04353d9ac )