From 3350516623348f356456f21cfc0694f36e94aeaf Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Fri, 3 Sep 2021 03:01:08 +0000 Subject: CTAN sync 202109030301 --- macros/latex/contrib/kdpcover/README.md | 35 +++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 macros/latex/contrib/kdpcover/README.md (limited to 'macros/latex/contrib/kdpcover/README.md') diff --git a/macros/latex/contrib/kdpcover/README.md b/macros/latex/contrib/kdpcover/README.md new file mode 100644 index 0000000000..a3fe02d0f9 --- /dev/null +++ b/macros/latex/contrib/kdpcover/README.md @@ -0,0 +1,35 @@ +[![make](https://github.com/yegor256/kdpcover/actions/workflows/latexmk.yml/badge.svg)](https://github.com/yegor256/kdpcover/actions/workflows/latexmk.yml) +[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/kdpcover/blob/master/LICENSE.txt) + +This LaTeX class I use to format covers for [my books](https://www.yegor256.com/books.html), +which I sell [on Amazon](https://www.amazon.com/Yegor-Bugayenko/e/B01AM1QMDK). +The problem this class solves is [the necessity](https://kdp.amazon.com/en_US/help/topic/G201953020) +to change the size of the cover PDF respectfully +to the number of pages in the book — the bigger +the book, the larger must be the cover. The provided class makes necessary +calculations on-fly, using the [`qpdf`](http://qpdf.sourceforge.net/) tool. Obviously, +you need to have it installed. Also, you must +run `pdflatex` with the `--shell-escape` option, in order to allow LaTeX to run `qpdf`. + +First, [install it](https://en.wikibooks.org/wiki/LaTeX/Installing_Extra_Packages) +from [CTAN](https://ctan.org/pkg/kdpcover) +and then use in the preamble: + +```tex +\documentclass[pdf=my-book.pdf]{kdpcover} +\begin{document} +% Here you print the cover as you wish, but I recommend +% you to use the commands available in the class, such as: +\putSpine{my book, vol. 1} +\putAuthor{Yegor Bugayenko} +\end{document} +``` + +The full example and all commands are available in the +[`kdpcover.tex`](https://github.com/yegor256/kdpcover/blob/master/kdpcover.tex) file. + +If you want to contribute yourself, make a fork, then create a branch, +then run `make` in the root directory. +It should compile everything without errors. If not, submit an issue and wait. +Otherwise, make your changes and then run `make` again. If the build is +still clean, submit a pull request. -- cgit v1.2.3