Week 3. Customizing your CollectionBuilder Project
Topics: Jekyll; config files; yml; Themes
In the final session of the workshop you will learn how to edit the theme.yml (found in your repository’s ‘_data/’ directory) to customize the visualizations and home page of your project. In the second half of the workshop, we will explore how to customize the content included on the browse, map, data, and item pages of your site.
Learning Objectives and Aligned Assessments
| Learning Objectives | Aligned Assessments |
|---|---|
| By the end of this class, you will be able to | By the end of class, participants will have |
1. Describe in broad terms how the theme.yml and config files control their project 2. Consult CollectionBuilder documentation as needed to learn how to make specific changes to your project. |
1. Updated your configuration files to remove the Map page from your web site navigation. 2. Removed the Location card from the home page of your project. |
ALIGNED STANDARDS/FRAMEWORK
ISTE 1.6b, “Students create original works or responsibly repurpose or remix digital resources into new creations.”
RESOURCES
| Resource Type | Links & Materials |
|---|---|
| Instructor Materials | - Internet-connected computer, ideally with video camera. - Zoom account or other virtual meeting tool that has web conferencing features for chat, audio, and video. - Learn Static Workshop Pages - GitHub account - Google account for using Sheets |
| Learner Materials | - Internet-connected computer, ideally with video camera. - Zoom account or other virtual meeting tool that has web conferencing features for chat, audio, and video. - Google account for using Sheets - The Week 3 Student Guide, Customizing your CollectionBuilder Project - Additional resources listed on the Student Materials page. |
LEARNING SEQUENCE OUTLINE
During Class
| Estimated time | Topic/Material Covered | Activity/Delivery Method |
|---|---|---|
| 1. 5 minutes | Icebreaker | 1. Possible icebreaker: ask participants to share their favorite music to work to. |
| 2. 5 minutes | Review of previous workshops | 1. Review how metadata drives website content, website structure, Markdown content |
| 4. 5 minutes | Website Structure | Introduce at a high level how the contents of the _data and _layouts folders control the website structure |
| 5. 15 minutes | Edit theme.yml | Walk participants through editing theme.yml file in the _data folder. 1. Edit home page image to add an image from the new collection 2. Mention Item Page Browser Buttons 3. Add “unknown” as a Subject stop word and note its effect on the word cloud. 4. Make Japan the center of the Maps page |
| 5. 15 minutes | Edit configuration csvs | Walk participants through editing config csvs. 1. —- 2. —–. 3. Remove Map and Location pages from the menu bar. |
| 6. 10 minutes | Edit Home Page | Introduce participants to the _layouts folder. 1. Remove Time and Locations cards from home-infographic.html |
| 7. 25 minutes | Open work time | Opportunity for participants to begin work on their own custom project, or to continue to customize their existing project. |
| 8. 10 minutes | Final wrap-up and questions | 3-2-1 exercise |
After Class Students will be directed via a follow-up email to the resources listed on the Student Materials page, including the Week 3 Student Guide, Customizing your CollectionBuilder Project