How collectionbuilder/collectionbuilder-csv works
Main Components
a) Input Layer:
• CSV Metadata Files (in _data/)
• Digital Objects (in objects/)
• Configuration Files (_config.yml and other YAML files)
b) Processing Layer (Jekyll Static Site Generator):
• Layout Templates (_layouts/)
• Components (_includes/)
• SASS Styling (_sass/)
• JavaScript Processing (_includes/js/)
• Ruby Plugins (_plugins/)
c) Output Layer:
• Generated Static Website
• Visualization Components
• Search Interface
• Asset Management
Data Flow
• CSV Metadata → Jekyll Processing → Generated Pages
• Digital Objects → Asset Processing → Generated Collections
• Configuration Files → Site Structure → Final Output
Component Interactions
• How _includes/ components are used by _layouts/
• How plugins process data
• Demonstrate integration with external libraries
Specific Implementation Details
• Rectangle: Core Components (Jekyll, Data Storage)
• Rounded Rectangle: Processing Units
• Hexagon: External Libraries (Bootstrap, Leafletjs, DataTables)
Visualization Layer
• Generation (Leafletjs)
• Gallery Views (Spotlight)
• Search Functionality (Lunr.js)
• Data Tables
• Timeline Features
Architectural Patterns to Emphasize
• Static Site Architecture
• Component-Based Design (_includes/ structure)
• Template Inheritance (_layouts/ hierarchy)
• Asset Pipeline (SASS → CSS, JS processing)
[Input Layer]
• ↓
[Processing Layer]
• ↓
[Visualization Layer]
• ↓
[Output Layer]
Important Notes
• Version control integration (GitHub)
• Build process
• Integration points with external services
• Metadata processing flow
• How themes and customization work