Document Structure

kdx document print <file.kddb> [flags]

kdx document print invoice.kddb

root
└── page
    └── content-area
        ├── line
        │   └── word: Invoice
        ├── line
        │   ├── word: Date:
        │   └── word: 2024-01-15
        ├── paragraph
        │   ├── line
        │   │   └── word: Item
        │   └── line
        │       └── word: Description
        └── line
            ├── word: Total:
            └── word: $1,234.56

# Show only top 2 levels
kdx document print invoice.kddb --depth 2

root
└── page
    └── content-area

# Print page 1 only
kdx document print invoice.kddb --page 1

# Print page 3 with limited depth
kdx document print invoice.kddb --page 3 --depth 4

kdx document print invoice.kddb --features --depth 2

root
└── page
    [spatial:bbox=0,0,612,792]
    └── content-area
        [spatial:bbox=50,50,562,742]

kdx document select <file.kddb> <selector>

# Find all paragraphs
kdx document select doc.kddb "//paragraph"

┌────┬───────────┬──────────────────────────────────────┬───────┐
│ ID │   TYPE    │               CONTENT                │ INDEX │
├────┼───────────┼──────────────────────────────────────┼───────┤
│ 15 │ paragraph │ This is the first paragraph of text. │ 0     │
│ 28 │ paragraph │ Another important paragraph here.    │ 1     │
│ 45 │ paragraph │ The final paragraph with conclusion. │ 2     │
└────┴───────────┴──────────────────────────────────────┴───────┘

# Find all pages
kdx document select doc.kddb "//page"

# Find all lines
kdx document select doc.kddb "//line"

# Find all words
kdx document select doc.kddb "//word"

# Find all tables
kdx document select doc.kddb "//table"

# JSON output
kdx document select invoice.kddb "//paragraph" -o json

# YAML output
kdx document print invoice.kddb -o yaml

[
  {
    "id": 15,
    "type": "paragraph",
    "content": "This is the first paragraph of text.",
    "index": 0
  },
  {
    "id": 28,
    "type": "paragraph",
    "content": "Another important paragraph here.",
    "index": 1
  }
]

# Quick overview
kdx document print invoice.kddb --depth 3

# Count paragraphs
kdx document select invoice.kddb "//paragraph" -o json | jq 'length'

# List all page numbers
kdx document select invoice.kddb "//page" -o json | jq '.[].index'

# Check if lines exist
kdx document select problematic.kddb "//line"

# View full structure with features
kdx document print problematic.kddb --features

# Check specific page
kdx document print problematic.kddb --page 2 --features

# Find all words (useful for searching)
kdx document select doc.kddb "//word" -o json | jq '.[] | select(.content | contains("Invoice"))'

# Check page count
PAGE_COUNT=$(kdx document select doc.kddb "//page" -o json | jq 'length')
echo "Document has $PAGE_COUNT pages"

# Verify table structure exists
TABLES=$(kdx document select doc.kddb "//table" -o json | jq 'length')
if [ "$TABLES" -gt 0 ]; then
  echo "Found $TABLES tables"
fi

# Report structure summary for all documents
for kddb in *.kddb; do
  PAGES=$(kdx document select "$kddb" "//page" -o json 2>/dev/null | jq 'length')
  PARAGRAPHS=$(kdx document select "$kddb" "//paragraph" -o json 2>/dev/null | jq 'length')
  echo "$kddb: $PAGES pages, $PARAGRAPHS paragraphs"
done