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. |
||
---|---|---|
cmd | ||
lpg | ||
.clang-format | ||
.gitignore | ||
go.mod | ||
go.sum | ||
LICENSE | ||
meson.build | ||
NEWS | ||
pdf-simple-sign.adoc | ||
pdf-simple-sign.cpp | ||
README.adoc | ||
test.sh |
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 AUR, or as a Nix derivation.
Documentation
See the man page for information about usage. The rest of this README will concern itself with externalities.
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.