PDF Incremental Reading Workflow - bjsi/incremental-everything GitHub Wiki

Summary of the Complete PDF Workflow:

1. PDF Structure Setup

  • Parent folder (e.g., BTM) contains the PDF rem
  • Create child rems for each chapter
  • Add the PDF as a source to each chapter
  • Tag chapters as incremental

2. PDF Control Panel

  • Comprehensive management interface for all rems using the same PDF
  • Set page ranges for each chapter
  • Edit priorities inline with visual feedback
  • View reading histories
  • Make rems incremental without leaving the panel

3. Flexible Processing

  • Default behavior: Chapters with PDF source open in PDF Reader at configured page range
  • With "extractviewer" tag: Opens in ExtractViewer to process notes and children
  • Toggle between modes by adding/removing the tag

4. Key Features Implemented

  • Page range management with history tracking
  • Priority inheritance from ancestors
  • Color-coded priority visualization
  • Automatic page detection and tracking
  • Sorting by page ranges for logical progression

This creates a powerful incremental reading system where:

  • Long PDFs are broken into manageable chapters
  • Each chapter maintains its PDF connection for centralized management
  • Users can switch between reading the PDF and processing notes
  • Everything is tracked and organized in the PDF Control Panel

The workflow handles the complexity of managing large PDFs while maintaining the flexibility needed for effective incremental learning!

"extractviewer" tag

Usage: For your chapter rems with PDF sources:

  • Without tag: Opens PDF Reader (to the reading of the configured page range).
  • With "extractviewer" tag: Opens ExtractViewer to see notes and children.

This allows users to:

  • Keep the PDF source for centralized management in the PDF Control Panel
  • Switch to ExtractViewer when they want to process their notes
  • Toggle behavior simply by adding/removing the tag

The tag name "extractviewer" is clear and descriptive. Users can easily understand: "This rem will open in the extract viewer instead of the PDF reader."

The ExtractViewer tag implementation is now working correctly! Chapter 3 with both the PDF source and the "extractviewer" tag is properly opening in the ExtractViewer, showing your notes and allowing you to process them incrementally.