Add an outline to an existing PDF.
Navigating inside a PDF is improved by having an outline (like a table of contents, which is shown by most PDF readers in a sidebar).
This software uses the excellent (but complicated) itext7 library to achieve this.
You need to have any Java JDK installed that is version 11 or higher. The OpenJDK build by azul is a good choice.
./gradlew clean build
.\gradlew.bat clean build
The binary can be found under build/libs/pdf-easy-outline-1.0-all.jar.
First create the outline using a text editor. The file should contain Kotlin script that describes the outline.
Example:
outline("Title of book") {
entry("Chapter One - Journey", 4) {
entry("A start", 5)
entry("An example", 34)
}
entry("Chapter Two", 54) {
entry("Interesting bits", 55)
entry("Never mind the text", 78)
}
entry("Appendix A - Codes", 106)
}
Entries can be nested further without any limit (to my knowledge). There are also some more examples
in the examples folder.
When you have created the outline file call the program with the following arguments:
java -jar pdf-easy-outline-1.0-all.jar <outline-file> <input-file> <output-file>
This will take the outline in outline-file and the PDF without an outline input-file and create a
PDF with an outline in output-file.
An existing outline in input-file is removed.