Categories: Difference between revisions

From UNB Archives and Special Collections
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
'''Categories''' are used to organize related [[Entries and Pages|entries]] dispersed throughout the wiki.
'''Categories''' are used to organize related [[Entries and Pages|entries]] dispersed throughout the wiki. Categories can be further divided into [[#Creating Subcategories|subcategories]], which will provide for the gradual development of a hierarchical organization of pages within the wiki. This organization will facilitate future readers' browsing of the wiki.


= Creating a New Category =


Creating a new category is similar to creating a [[Entries and Pages|new entry]] - at the end of the wiki's URL, insert Category:Category_Title (using _ instead of spacing). If the category already exists, the administrator will be brought to a category page that lists all of the entries already tagged with that category tag; if the category does not exist, the administrator will notice the option to Create the new category page.
<br/><center>'''Example:''' [http://unbhistory.lib.unb.ca/index.php/Category:Example http://unbhistory.lib.unb.ca/index.php/Category:Example]</center>
<br/>[[File:NewCategory.png|center|800x200px]]


<div style="border:2px solid black; background-color:white"><br/><center>'''Note:''' Creators of category pages '''should avoid''' using special characters (&, #, @, $, %, *, etc...) in '''category titles''' because they may not function effectively.</center><br/></div>
= Using Category Tags =
 
After a category page has been created, entries can be added to that category page through the application of ''category tags''. Category tags appear at the bottom of an entry and any number of category tags can be assigned to a given entry.
 
<br/>'''RichTextEditor:&nbsp;'''Select the Category icon on the toolbar:&nbsp;
 
[[File:CategorySymbol.png|center|20x20px]]
 
*Enter the title of the category into the first field.
*The second field—Sortkey within category—allows for the reorganization of entries within the category page. If several entries assigned to a category begin with the same word, such as ''The'', the administrator should sort by the second word of the entry's title by placing this modified title into this field. '''This refers to the title of the entry being placed within a category, not the category itself.'''
 
<br/>'''WikiTextEditor:&nbsp;'''Similar to [[Archives Manual#Linking within the wiki|linking]], categories are enclosed by double square brackets and placed at the bottom of the entry. To establish a Sortkey, use a pipe ( | ) to separate the category from the modified title of the entry being added to it:&nbsp;
<center>'''Example:&nbsp;'''adding&nbsp;''The Great Gatsby''&nbsp;to the Example category<br/></center><center><span style="line-height: 1.6;">&#x5B;&#x5B;Category:Example|Great Gatsby&#x5D;&#x5D;</span></center><center><br/></center>
[[File:CategoryTag.png|center]]
<br/><div style="border:2px solid black; background-color:white"><center>If the category exists and has been entered correctly it will appear as a blue hyperlink (<span style="color:#0000CD;"><u>Buildings</u></span>); if it does not yet exist, the hyperlink will be red (<span style="color:#B22222;"><u>Example</u></span>). If the link is red, the administrator can quickly create a new category with this title by clicking that red link.</center></div>
*'''Remember: All titles in MediaWiki are case-sensitive. Always check the title of the source page if a link does not function.'''
*When creating the category page, spaces '''must''' be replaced by underscores ( _ ) - otherwise your web browser will (likely) treat your effort like a Google search. However, when assigning category tags, spacing can be used. MediaWiki will automatically replace the spacing with underscores (this can be observed by looking at the WikiTextEditor coding after saving a category tag with spacing).
 
=== Creating Subcategories ===
 
Subcategories can be created to help a broader themed category. These relationships can grow infinitely in either direction. Any category can belong to several broader categories, depending on the desired organizational structure.<br/>To create a subcategory, simple attach the category tag of the broader category to the subcategory.
<br/><center>'''Example:''' ''Fredericton'' and ''Saint John'' are desired subcategories of the '''Buildings''' category. To establish this, attach the '''Buildings''' category tag to the category page of the desired subcategories.</center><br/><br/>
 
 
<div style="border:2px solid black; background-color:white"><br/><center>'''Note:''' Creators of category pages '''should avoid''' using special characters (&, #, @, $,&nbsp;%, *, etc...) in '''category titles''' because they may not function effectively.</center><br/></div>

Revision as of 08:07, 2 July 2014

Categories are used to organize related entries dispersed throughout the wiki. Categories can be further divided into subcategories, which will provide for the gradual development of a hierarchical organization of pages within the wiki. This organization will facilitate future readers' browsing of the wiki.

Creating a New Category

Creating a new category is similar to creating a new entry - at the end of the wiki's URL, insert Category:Category_Title (using _ instead of spacing). If the category already exists, the administrator will be brought to a category page that lists all of the entries already tagged with that category tag; if the category does not exist, the administrator will notice the option to Create the new category page.


Example: http://unbhistory.lib.unb.ca/index.php/Category:Example


NewCategory.png

Using Category Tags

After a category page has been created, entries can be added to that category page through the application of category tags. Category tags appear at the bottom of an entry and any number of category tags can be assigned to a given entry.


RichTextEditor: Select the Category icon on the toolbar: 

CategorySymbol.png
  • Enter the title of the category into the first field.
  • The second field—Sortkey within category—allows for the reorganization of entries within the category page. If several entries assigned to a category begin with the same word, such as The, the administrator should sort by the second word of the entry's title by placing this modified title into this field. This refers to the title of the entry being placed within a category, not the category itself.


WikiTextEditor: Similar to linking, categories are enclosed by double square brackets and placed at the bottom of the entry. To establish a Sortkey, use a pipe ( | ) to separate the category from the modified title of the entry being added to it: 

Example: adding The Great Gatsby to the Example category
[[Category:Example|Great Gatsby]]

CategoryTag.png


If the category exists and has been entered correctly it will appear as a blue hyperlink (Buildings); if it does not yet exist, the hyperlink will be red (Example). If the link is red, the administrator can quickly create a new category with this title by clicking that red link.
  • Remember: All titles in MediaWiki are case-sensitive. Always check the title of the source page if a link does not function.
  • When creating the category page, spaces must be replaced by underscores ( _ ) - otherwise your web browser will (likely) treat your effort like a Google search. However, when assigning category tags, spacing can be used. MediaWiki will automatically replace the spacing with underscores (this can be observed by looking at the WikiTextEditor coding after saving a category tag with spacing).

Creating Subcategories

Subcategories can be created to help a broader themed category. These relationships can grow infinitely in either direction. Any category can belong to several broader categories, depending on the desired organizational structure.
To create a subcategory, simple attach the category tag of the broader category to the subcategory.


Example: Fredericton and Saint John are desired subcategories of the Buildings category. To establish this, attach the Buildings category tag to the category page of the desired subcategories.





Note: Creators of category pages should avoid using special characters (&, #, @, $, %, *, etc...) in category titles because they may not function effectively.