Administrator Manual: Difference between revisions

From UNB Archives and Special Collections
Jump to navigation Jump to search
No edit summary
No edit summary
Line 19: Line 19:
=== Using Category Tags ===
=== 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. Similar to [[Archives Manual#Linking within the wiki|linking]], categories are enclosed by double square brackets and placed at the bottom of the entry.
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/><center>'''Example:'''&nbsp;&#x5B;&#x5B;Category:Example&#x5D;&#x5D;</center>
 
'''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.'''
 
'''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 ( | )&nbsp;
<center>'''Example:'''&nbsp;&#x5B;&#x5B;Category:Example&#x5D;&#x5D;</center>
[[File:CategoryTag.png|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><br/>
<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.'''
*'''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).
*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).
 
 





Revision as of 14:29, 16 June 2014

This will contain a manual for Administrators of the wiki.

Editing Content

Organizing Content

As the wiki continues to expand, its organization will become increasingly complex and important to manage. These are some internal functions that will help make the organization of the wiki possible.

Categories

Categories can be used to effectively group related entries. Categories can be further divided into subcategories, which will allow for the gradual establishment of an organizational hierarchy within the wiki. This will facilitate browsing of the wiki by future readers.

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 ( | ) 

Example: [[Category:Example]]
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).




Templates

Here is how you would create a category like Page Under Development,

Create page: 
Category:Page_Under_Development

Add this line to the end of all pages that you want to put in the above category
[[Category:Page Under Development]]

Click on category to see all pages linked.


Modifying the Sidebar

The sidebar is essentially a list of pages dedicated to key topics.
As the wiki develops, changes will have to be made to the sidebar to accommodate subject developments. Changing the sidebar is as easy as modifying any other page, but it must be accessed in a particular manner.

The sidebar page can be found at:
http://unbhistory.lib.unb.ca/index.php/MediaWiki:Sidebar


To modify the sidebar, simply edit this page and add or remove the desired links.

To review how to add a new link visit the appropriate section in the Archives Manual.




Editing

  • On clicking “edit this page”, an editor is displayed. This is the WYSIWYG editor.
  • Start typing in the space below.
  • On finishing edits, click the Save Page button to save changes.

<img src="/images/2/2c/Screen_shot_2013-06-07_at_12.38.06_pm.png" _fck_mw_filename="Screen shot 2013-06-07 at 12.38.06 pm.png" _fck_mw_location="center" _fck_mw_type="border" alt="Screen shot 2013-06-07 at 12.38.06 pm.png" class="fck_mw_border fck_mw_center" /> </div>