Skip to content
/ dagtoc Public

A command-line tool for adding, getting and deleting TOC of pdf.

License

Notifications You must be signed in to change notification settings

TD-Sky/dagtoc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🦀 dagtoc 📖

A command-line tool for adding, getting and deleting contents of pdf

Introduction

dagtoc uses MuPdf as the underlying PDF operator.

Installation

Language package managers

  • Install via cargo:

    $ cargo install dagtoc

Archlinux

  • Install from source code:

    $ paru -S dagtoc
  • Or install binary:

    $ paru -S dagtoc-bin

Usage

I will show how to use dagtoc with the files in demo directory.

TOC

The carrier format for TOC is KDL which is an excellent document language for forest structure.

Outline looks like:

- <title> <page>

If it has suboutlines, they are written as the children of node:

- <title> <page> {
    - <title1> <page>
    - <title2> <page>
    ...
}

You can nest them certainly! See Makefile.kdl for a real TOC.

Add TOC

$ dagtoc -a Makefile.kdl Makefile-NOTOC.pdf -o Makefile.pdf

Additionally, you can use -x to specify the page number offset (+/-) for added TOC. It would help you amend the TOC whose page numbers are all offset by the same constant. Page outbound error will occur if the number of any page is reduced to non-positive number.

Delete TOC

$ dagtoc -d Makefile.pdf -o Makefile-NOTOC.pdf

Get TOC

$ dagtoc -g Makefile.pdf > Makefile.kdl

Additionally, you can use -x to specify the page number offset (+/-) for got TOC. It would help you amend the TOC of pdf whose page numbers are all offset by the same constant. Page number will be empty if it is reduce to non-positive number.

Check TOC

$ dagtoc -c Makefile.pdf

Checking the page numbers are increasing and not empty in the pdf.

Remember dagtoc

dagtoc = delete-add-get-TOC

About

A command-line tool for adding, getting and deleting TOC of pdf.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages