Week 1 Building a Digital Archive using CollectionBuilder
Building a Digital Archive using CollectionBuilder
CollectionBuilder Workshop 1 - Part 1
Digital Collections & Storytelling with CollectionBuilder
In lesson one of this learning sequence learners will gain experience expressing how they think CollectionBuilder is an appropriate tool for their digital collections and storytelling project. The audience for this lesson includes teachers, researchers, students, and staff
Learning Objectives and Aligned Assessments
| Learning Objectives | Aligned Assessments |
|---|---|
| By the end of this class, you will be able to | |
| 1. Learner will express how CollectionBuilder is relevant to their digital collections and storytelling project | 1. Learners will express CollectionBuilder’s relevancy by sharing how they see the tool fitting their digital collection and storytelling needs |
ALIGNED STANDARDS/FRAMEWORK
ISTE Standards 1.6. Creative Communicator Students choose the appropriate platforms and tools for meeting the desired objectives of their creation or communication.
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. - Workshop Site |
| Learner Materials | - Zoom account or other virtual meeting tool that has web conferencing features for chat, audio, and video - Workshop Site: Materials related to this lesson are available on this site |
| Supplemental Materials | None |
LEARNING SEQUENCE OUTLINE
Before Class
Nothing is required for pre-class assessment.
During Class
| Estimated time | Topic/Material Covered | Activity/Delivery Method |
|---|---|---|
| 1. 5 minutes | Introductions | Learners will introduce themselves individually and answer the following questions: - What is your name? - What are your pronouns? - Why are you here for the workshop? |
| 2. 10 minutes | CollectionBuilder & Its Relevancy for Storytelling with Digital Collections | Lecture Brief slide lecture by the instructor that identifies: - Show how people are using CollectionBuilder for digital collections https://www.lib.uidaho.edu/digital/campushistory/ https://she-changed-world.cb.ncpedia.org/ - What CollectionBuilder is able to do out of the box Highlight CollectionBuilders features |
| 4. 15 minutes | About Your Digital Collections & Stories | Reflection Ask a few learners to verbally share how they see CollectionBuilder fitting their digital collection needs As learners share instructor should demo an example through a screen share Share a link to the resource guide/handout for learners to reference in the future. |
After Class
Via email or another virtual communication tool, share the resource guide/handout again with learners for future reference.
CollectionBuilder Workshop 1: Part 2 of 3 (GitHub)
Digital Collections & Storytelling with CollectionBuilder
Learning Sequence Description
In this workshop series you will learn how to create a website displaying a digital collection using free, open-source software (CollectionBuilder). This workshop series is appropriate for anyone who wants to learn to build their own website to display a digital collection, whether for a class, a grant, or a digital humanities project. You can also use this software to create a personal website showcasing your professional portfolio as an architect, designer, or artist. You should be comfortable learning new things, but no prior experience with web design is required.
We will begin by exploring what a digital collection is. We will help you set up an account on GitHub—the platform that will host our website for free—and show you a little bit about how interact with that platform. In the second hour of the workshop, you will learn to import sample data into a project. By the end of the session, you will have a live website!
You are encouraged to bring your own materials to the workshop if you already have materials for a digital collection prepared. Once you register, we will send you instructions on what materials to bring.
Learning Objectives and Aligned Assessments
| Learning Objectives | Aligned Assessments |
|---|---|
| By the end of this class, you will be able to | Workshop leaders will confirm that learners have |
| 1. create a GitHub account and public repository 2. create a commit and a quality commit message 3. view git history to see changes to the repository and git diff to see changes to files 4. create an issue in a GitHub repository 5. find and add collaborators in a repository |
1. created a GitHub account and repository 2. created a commit and a quality commit message 3. viewed git history to see changes to the repository and git diff to see changes to files 4. created an issue in a GitHub repository 5. found and added collaborators in a repository |
ALIGNED STANDARDS/FRAMEWORK
Prerequisite skills for 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 Modules | | 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. - Email account for creating GitHub account during in the session. | | Supplemental Materials | None |
LEARNING SEQUENCE OUTLINE
Before Class WHAT TO INCLUDE: Pre-class assessments; Pre-work to prepare for hands-on class time.
Students will be invited (but not required) to set up their GitHub account before class.
During Class
| Estimated time | Topic/Material Covered | Activity/Delivery Method |
|---|---|---|
| 1. 5 minutes | What is GitHub and why use it? | Brief lecture with slides |
| 2. 20 minutes | Students go through the 5 steps outlined in the learning objectives | Click along based on the 5 steps outlined above (also covered in Learn-Static module) |
| 4. 5 minutes | Final questions/review |
After Class WHAT TO INCLUDE: Summative Assessments; Plans for following-up with learners and those needing additional support; Extension of learning opportunities;
Via email or another virtual communication tool, share the Learn-Static guide again with learners for future reference.
CollectionBuilder Workshop 1: Part 3 of 3
CollectionBuilder Workshop
Digital Collections & Storytelling with CollectionBuilder
Learning Sequence Description In this workshop series you will learn how to create a website displaying a digital collection using free, open-source software (CollectionBuilder). This workshop series is appropriate for anyone who wants to learn to build their own website to display a digital collection, whether for a class, a grant, or a digital humanities project. You can also use this software to create a personal website showcasing your professional portfolio as an architect, designer, or artist. You should be comfortable learning new things, but no prior experience with web design is required.
We will begin by exploring what a digital collection is. We will help you set up an account on GitHub—the platform that will host our website for free—and show you a little bit about how interact with that platform. In the second hour of the workshop, you will learn to import sample data into a project. By the end of the session, you will have a live website!
You are encouraged to bring your own materials to the workshop if you already have materials for a digital collection prepared. Once you register, we will send you instructions on what materials to bring.
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. copy a GitHub repository and display it as a website. 2. define the term metadata. 3. identify the folders in a CollectionBuilder project where images and metadata are uploaded. 4. identify the _config.yml file and understand that it controls essential elements of how the website is configured and displayed. |
1. cloned a Collectionbuilder-GH repository and enabled the GitHub Pages function. 2. uploaded new images and accompanying metadata that changes the visible content of their website. 3. modified the _config.yml file in their repository so that the site displays their new material. 4. changed the title of the website to reflect its new contents. |
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. |
| 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.
Email account for creating GitHub account during in the session. |
| Supplemental Materials | Learner supplemental/optional materials.
Learner may bring their own digital images and metadata file to class in order to begin building a custom version of the workshop. Alternatively, we provide sample “custom” materials for students to practice on. These materials will consist of a number of small jpeg images, and one csv/Google sheet containing metadata in CollectionBuilder format, ready to upload to their website. |
LEARNING SEQUENCE OUTLINE
Before Class
When students register for the class we will include instructions for how to prepare their own custom images and metadata in advance of the first class. Alternatively, students will be given the option to meet with an instructor directly to develop images and metadata at any point before, during, or after the workshop series.
During Class
| Estimated time | Topic/Material Covered | Activity/Delivery Method |
|---|---|---|
| 1. 5 minutes | Transition or quick break | |
| 2. 5 minutes | Make your own CollectionBuilder template and display it as a website | 1. Start new project by creating a copy of the code on GitHub by clicking the “Use this Template” button, https://github.com/CollectionBuilder/collectionbuilder-gh 2. Enable GitHub pages, and add a link to your newly enabled page to the “about” part of your website. |
| 3. 10 minutes | How does this website know what images to display, and how can we change them? | Lecture: brief overview of the contents of the repository, clicking through. - README.md - notice link to instructions for using this template - _config.yml - notice that this controls elements of the site at a high level - _data folder - note the demo-metadata.csv file referenced in _config.yml - docs folder - instructions for using various parts of the website - objects folder - note the images, which correspond to the names in the metadata.csv and to the images on the website, and the readme.md file with instructions on adding images to your project - pages folder - note that the markdown pages here are not the final pages served by Jekyll. Rather, they instruct Jekyll on how to create the final html pages served by GitHub pages. Compare right click “view page source” image of html to the md file. |
| 4. 5 minutes | Configure your website | 1. Click on the _config.yml file in your new repository. 2. Update URL Variables and Site Settings sections for your new project |
| 5. 25 minutes | Upload your own custom or sample metadata and code | 1. Download the metadata-template.csv and metadata-info.csv files from the docs folder. 2. Find and download our sample metadata. [Link to sample metadata.] 3. Upload the images and commit. 4. Upload metadata to GitHub and commit. 5. Update _config.yml 6. Check the website, discover error/omissions. 7. Edit metadata in Google Sheets to fix error. 8. Re-upload/commit and confirm fix. |
| 6. 5 minutes | Final questions | Troubleshooting any errors, clarifying questions |
| 7. 5 minutes | Final wrap-up | 3/2/1 Reflection - 3 things you found interesting - 2 things you’ve learned - 1 thing you still have a question about |
After Class
Students will be directed via a follow-up email to CollectionBuilder documentation on how to create and deploy their website, with particular emphasis on how to create image files and accompanying metadata.
Students will also be given the option to meet with an instructor directly to develop images and metadata at any point before, during, or after the workshop series.