Note: This page has been deprecated and replaced by Setup Your Site. Please refer to the new documentation for the latest workflow.
Customizing Using CollectionBuilder Options
Because it is built on top of CollectionBuilder, you have a large number of ways to update your site using CollectionBuilder options.
CollectionBuilder has extensive documentation covering its customization options. Here’s an overview of options:
CollectionBuilder Documentation Guide
Theme Options
The _data/theme.yml
file controls display options that impact every page of your site. These settings affect global options in your website, so it’s important to review each one as you create your site.
- Theme Options Overview - Main page explaining theme configuration
- Home Page Configuration - Configure your collection’s home page features, including featured images and banner settings
- Browse Page Configuration - Options for the browse layout
- Item Page Configuration - Settings for individual item pages
- Navbar Configuration - Custom navbar options
Page Config
CollectionBuilder’s navigation features and visualization pages are configured via “config” CSV files located in your project’s “_data” directory. These config files usually have the prefix “config-“ and tend to be more detailed than the options in “theme.yml”.
- Customization Overview - Learn about config files
- Collection Settings - Configure metadata sources and page generation
- Navigation Config - Create and customize your site’s navigation
- Map Configuration - Settings for the map visualization
- Metadata Configuration - Configure how metadata fields display
Edit Pages
Most pages in CollectionBuilder are placeholders for visualization features like “Browse” or “Subjects,” but you’ll want to edit “about.md” and potentially add more interpretive pages.
- Page Basics - Learn about page files and front matter
- Add Page - Instructions for adding new pages to your collection site, including required front matter variables and permalink configuration
- About Page - Customizing the about page
- Feature Includes - Using include features to enhance content
Additional Resources
- Discussion Forum - Get help from the CollectionBuilder community
- Video Tutorials - Watch instructional videos to help build your site