Course:ARST 556L/LIBR 514L/Wiki Editing Instructions
General
Make sure you're logged into the UBC Wiki. Sessions do time out, so if in doubt whether or not you're still logged in, please refresh the page first and check otherwise your work may not save. If you have been logged out, log in to the UBC Wiki in another tab and then try again to save your work.
Adding a New Page
In the left-hand sidebar of the UBC Wiki, click on "Create a New Page."
You're going to add a new Course page using the Course box near the bottom of the page. The box is prefilled with text that says "Course:" and you're going to add the class page/number "ARST_556L/LIBR_514L" so that it reads: "Course:ARST_556L/LIBR_514L".
Then you're going to add in the topic you're adding, using underscores _ for spaces and / for levels of page hierarchy. There are examples below under "Examples."
And you're going to keep going through the different levels of hierarchy until you get to where your new page should go, whether it's a topic, option, or student project page.
Delete the auto-generated text on the page and click on the "Wikitext" option in the header on the right to open up the source editor.
In another tab, open up the appropriate template page (linked below in the Templates section). Click on the "Wikitext" option in the header on the right to open up the source editor. Copy all of the text and paste it into the source editor on the page you're creating. You can then save and return to regular "Edit" mode to make adjustments a bit easier.
Fill out the template appropriately, following the instructions included on the template within the singular square brackets [ ]. Remove any sections and square brackets that don't apply to your new page.
Each level of page hierarchy should have its own corresponding page, so you may need to create pages earlier in the hierarchy before you can add the one you needed to originally.
Citations
To cite something on the page you're editing, simply click on the Cite button in the editing header, select the type of object you're citing, fill out the information, and click on Insert when you're done.
Templates
Examples
Topic page: Course:ARST_556L/LIBR514L/Metadata_Topics
Option sub-topic page: Course:ARST_556L/LIBR_514L/Metadata_Options/Applications
Option individual page: Course:ARST_556L/LIBR_514L/Metadata_Options/Applications/OHMS
Student project page: Course:ARST_556L/LIBR_514L/Metadata_Options/Applications/OHMS/My_Project_Here
Linking Other Pages
To insert a link, either to another page on the wiki or to an external website, you can use the link button in the top header or type in two left square brackets [[ and a popup will appear so you can search for and link wiki pages. Alternatively, to link Wiki pages you can enter the full title of the page you're linking without the space between the square brackets and page name, for example: [[ ARST_556L/LIBR_514L/Wiki_Editing_Instructions ]] and if you want the display text of the link to be different, you can add an alias after the page link by using this character | : [[ ARST_556L/LIBR_514L/Wiki_Editing_Instructions|Wiki_Editing_Instructions ]]
Main Class Page
Editing the Main Class Page
Page located here: ARST 556L/LIBR 514L
On the course page, in the header by the search bar, click on "Edit."
Change what you need to, then click "Save changes..." in the top-right.
If you're changing something structural to the composition of the page/course, run it by your instructor first.
Course Topics Pages
Adding a New Topic Page
Only add pages that do not exist and are added to the main course topics as the course develops over time.
Sections
Under General, include any general information about this topic that does not belong in one of the following sections.
If there are any subtopics, edit [Subtopic(s)] to either Subtopic or Subtopics depending on the number of them. Add a sub-heading1 underneath with the name of each subtopic for as many as are needed.
If there are no subtopics, delete this section.
Under the subtopic(s)'s name, add any basic information relevant to the subtopic. Do not place detailed information here as that should be placed on a new page dedicated to that subtopic that can then be linked to this section and the main course page.
Under Related Readings, include any relevant readings (required, recommended, or from your own research) in alphabetical order by author last name.
Under Class Notes, include any class notes in reverse chronological order by year and semester for this topic here. Use sub-heading 1 for the semester and year, then use bullet points underneath those subheadings for the notes themselves.
Editing an Existing Topic Page
Add extra information to the pages, following on to what is already available. Please don't duplicate information and read each entry before contributing to it.
If an existing page is rebranded, be very careful about changing names because everything linked after it will also need an update if you want consistency in the URLs.
Metadata Options Pages
Adding a New Option Page
Please only add options that do not exist already. Check under all of the subtypes of options before adding your new option. When adding a new subtype of option, make sure it can be mutually exclusive of the other subtypes already available.
For the titles of the pages, use the full version of the option. For example, if adding a page for LCSH, the page creation link should look like this: Course:ARST_556L/LIBR_514L/Metadata_options/Controlled_Vocabularies/Library_of_Congress_Subject_Headings
After the class name is the main topic (Metadata_Options), then the subtopic (Controlled_Vocabularies), and finally the option to be added (Library_of_Congress_Subject_Headings).
LCSH can be used as a text alias for the link once the page exists, for use in other pages and in the Metadata Network Table by linking the page then adding |LCSH after it.
For example: [[ Course:ARST_556L/LIBR_514L/Metadata_options/Controlled_Vocabularies/Library_of_Congress_Subject_Headings|LCSH ]]
Sections
Under Introduction, include any introductory information about the option that doesn't belong in one of the following sections.
Under Learning Resources, include any guidelines, tutorials, or other resources that you come across in your research. These items are not created by you, but can be created by third-parties to help folks navigate the option on the page. If there are many resources, please use sub-heading1 to create groups of similar types of resources. Please list resources alphabetically.
Under Related Readings, add in any relevant readings (required, recommended, or from your own research) in alphabetical order by author last name.
Editing an Existing Option Page
Add extra information to the pages, following on to what is already available. Please don't duplicate information and read each entry before contributing to it.
If an existing page is rebranded, be very careful about changing names because everything linked after it will also need an update if you want consistency in the URLs.
Student Projects
Adding a New Student Project Page
Please only add a new student project page for your own project as each student will be asked to add their project to the wiki and to the Metadata Network.
Sections
Under the Summary, include your project's key points/abstract.
Under the Purpose/Goal, include the why of your project and you can answer the following questions: What was your original research question or objective? Did you satisfy it?
Under the Lessons Learned, include what you learned going through this project and anything you wish you'd known at the beginning.
Under the Relations to Course, include how what you learned in the class related to your project and how your project related to what you learned in the course.
Information Box
To the right of the screen is the information box with text you can replace with information about your project.
Replace [Project Title] with your project's title.
Replace [Student Name] with your name.
In the cell to the right of Semester, add the semester you took the course. For example, 2022 Winter Term I
In the cell to the right of Instructor, add the instructor for your class. For example, Dr. Julia Bullard
In a cell underneath Metadata Topic(s), add any related metadata topic(s) to your project. You may need to hover your mouse over the information box and find the arrow on the side to select the option to add a row. For example, Metadata Design.
Editing an Existing Student Project Page
Add extra information, revise existing information, etc. so long as it's accurate to the project.
Note: Please only edit your own student project page for content. Fixing links, typos, and similar items are acceptable.
Metadata Network Table
Adding a Page to the Network
Once you've created the page you need to link to the table, in a new tab, go to the table's page.
Find where your page should go in the table and note the name of the row and which column number it will be. For example, for the Class Wiki, it's in the Metadata Topics table, in the Design row, and it's in the third column.
On the table's page click "Wikitext." Every box in the table has its own row, delineated by an | or !. Find the row title in the source editor - the line it's on is the equivalent of the first column. Navigate to the line that corresponds with the column where your project should go and add a link to your project on that line.
For example, without the spaces between the link and the double square brackets:
[[ Course:ARST_556L/LIBR_514L/Metadata_Design/Class_Wiki|Class_Wiki ]]
The above link includes "|Class_Wiki" at the end of the link as the display/alias text for the link.
Click on "Show Preview" just to check that the link is correct - it should display your link's alias text in the appropriate cell of the table. If it's not in the right place, click on "Go to Editing Area" to be returned to the editing screen and fix the placement.
Click on "Save Changes" and the table should update across all pages where it's been added to include your new page.
Adding a New Row or Column to the Table
You may need to add extra rows or columns to the table in order to add the page you're working on.
In the Wikitext, find the appropriate section of the table. For example, | rowspan="11"|'"Controlled Vocabularies*'"
To make the Controlled Vocabularies section contain more rows, change the number in this row as needed. For example, to add three rows, | rowspan="14"|'"Controlled Vocabularies*"'
For columns, it's the same idea. Find the topic and the colspan text next to it. colspan functions like rowspan but for columns, so if it's: ! colspan="4" |Student Projects then you can add 2 columns by changing the 4 to a 6. ! colspan="6" |Student Projects
Editing an Existing Network Page Connection
To edit content in the table, go to the table template page and edit the page. Locate the content you need to update and make your adjustments, using the information in Adding a Page to the Network. Preview the changes you've made to ensure it looks correct and works before you save it.