Přemysl Eric Janouch
e8752e53ac
Publishing my old invoice layouter in a reusable scripting-based form, rather than an annoyingly fixed binary. Because Lua compiled for C++ might be hard to find, we provide a wrap. Curiously, only GitHub releases seem to contain onelua.c, which is a very handy file. We could have also subprojected libqr, which is in the public domain, however the other main dependencies are also LGPL like libqrencode is. And it is likely to be installed. The user manual also serves as a test.
82 lines
2.5 KiB
Plaintext
82 lines
2.5 KiB
Plaintext
pdf-simple-sign
|
|
===============
|
|
|
|
'pdf-simple-sign' is a simple PDF signer intended for documents produced by
|
|
the Cairo library (≤ 1.17.4 or using PDF 1.4), GNU troff, ImageMagick,
|
|
or similar.
|
|
|
|
I don't aim to extend the functionality any further. The project is fairly
|
|
self-contained and it should be easy to grasp and change to suit to your needs.
|
|
|
|
Packages
|
|
--------
|
|
Regular releases are sporadic. git master should be stable enough.
|
|
You can get a package with the latest development version using Arch Linux's
|
|
https://aur.archlinux.org/packages/pdf-simple-sign-git[AUR],
|
|
or as a https://git.janouch.name/p/nixexprs[Nix derivation].
|
|
|
|
Documentation
|
|
-------------
|
|
See the link:pdf-simple-sign.adoc[man page] for information about usage.
|
|
The rest of this README will concern itself with externalities.
|
|
|
|
image:https://pkg.go.dev/badge/janouch.name/pdf-simple-sign@master/pdf["PkgGoDev", link="https://pkg.go.dev/janouch.name/pdf-simple-sign@master/pdf"]
|
|
|
|
Building
|
|
--------
|
|
Build dependencies: Meson, Asciidoctor, a C++11 compiler, pkg-config +
|
|
Runtime dependencies: libcrypto (OpenSSL 1.1 API)
|
|
|
|
$ git clone https://git.janouch.name/p/pdf-simple-sign.git
|
|
$ cd pdf-simple-sign
|
|
$ meson builddir
|
|
$ cd builddir
|
|
$ ninja
|
|
|
|
Go
|
|
~~
|
|
In addition to the C++ version, also included is a native Go port,
|
|
which has enhanced PDF 1.5 support:
|
|
|
|
----
|
|
$ go install janouch.name/pdf-simple-sign/cmd/pdf-simple-sign@master
|
|
----
|
|
|
|
and a crude external VFS for Midnight Commander, that may be used to extract
|
|
all streams from a given PDF file:
|
|
|
|
----
|
|
$ GOBIN=$HOME/.local/share/mc/extfs.d \
|
|
go install janouch.name/pdf-simple-sign/cmd/extfs-pdf@master
|
|
----
|
|
|
|
To enable the VFS, edit your _~/.config/mc/mc.ext.ini_ to contain:
|
|
|
|
----
|
|
[pdf]
|
|
Type=^PDF
|
|
Open=%cd %p/extfs-pdf://
|
|
----
|
|
|
|
Lua PDF generator
|
|
~~~~~~~~~~~~~~~~~
|
|
Build dependencies: Meson, a C++17 compiler, pkg-config +
|
|
Runtime dependencies: C++ Lua >= 5.3 (custom Meson wrap fallback),
|
|
cairo >= 1.15.4, pangocairo, libqrencode
|
|
|
|
This is a parasitic subproject located in the _lpg_ subdirectory.
|
|
It will generate its own documentation.
|
|
|
|
Contributing and Support
|
|
------------------------
|
|
Use https://git.janouch.name/p/pdf-simple-sign to report bugs, request features,
|
|
or submit pull requests. `git send-email` is tolerated. If you want to discuss
|
|
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
|
|
|
|
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
|
|
|
|
License
|
|
-------
|
|
This software is released under the terms of the 0BSD license, the text of which
|
|
is included within the package along with the list of authors.
|