UBC Wiki - User contributions [en]

Category:Library Facilities

2011-05-24T21:54:40Z

CynthiaNg: added category

wiki pages with information on the library's facilities including equipment and space.

[[Category:Services_Portal]]

Thread:User talk:Kifty/Re: Library:Glossary of Subject Searching

2011-05-24T21:18:51Z

CynthiaNg: New thread: Re: Library:Glossary of Subject Searching

Hey Jonathan,

The page [[Library:Glossary of Subject Searching]] was created during my last workshop with Woodward for Charlotte Beck. She was supposed to fix the formatting and add a category for it afterwards, but I suppose maybe she hasn't gotten around to it. I would just send her a small e-mail. Let me know if you need any other information.

Help:Converting Documents into Wiki Syntax

2011-04-29T05:52:40Z

CynthiaNg: Undo revision 88913 by Farhad (talk)

The following techniques should work with any document that can be read using the program of your choice, but generally addresses the possible needs of converting DOC and RTF files. If the following plugins do not work well for you, it is recommended that you copy/paste the text and format it with the help with the wiki toolbar.

As with the HTML converter, these converters are not perfect. You will likely have to correct small errors. For example, when converting a DOC file, you may find characters that do not convert properly, but can be easily changed with the "Replace All..." function in your text editor before copy/pasting into the wiki editing box.

==Open Office (Windows and Mac)==

The easiest way to convert documents for use on the UBC Wiki is to use [http://www.openoffice.org Open Office], the free, open-source replacement for Microsoft Word. Open Office documents can be saved directly in the MediaWiki format if you have installed the [http://extensions.services.openoffice.org/en/project/wikipublisher Sun Wiki Publisher].

===Installation===
# Download the [http://extensions.services.openoffice.org/project/wikipublisher Sun Wiki Publisher plugin] for OpenOffice.
# Go to Tools -> Extension Manager... and click on the "Add..." button. Find the file on your computer and click on "Open". The plugin should automatically install.

===Converting===
# Open the document you wish to convert.
# Go to File -> Export...
# Under "File Type:" choose "MediaWiki (.txt)" and save.
# Open the .txt file and copy/paste it into the editing box of the wiki page of your choice.

Note that images are not automatically exported. Images need to be saved then [[Special:Upload|uploaded]] to the wiki. Placeholders for them are inserted into the exported Wiki code though.

==Microsoft Word (Windows Only)==
After much testing, the following plugin seems to work well with DOC files (in Word 2003), but not so well with DOCX files (in Word 2007).

====Installation====
# Download the [http://www.mediawiki.org/wiki/Extension:Word2MediaWikiPlus Word2MediaWikiPlus] plugin.
# Open Word, and go to Tools... -> Options... -> Security -> Macro Security...
# Change "Security Level" to Medium.
# On the "Trusted Publishers" tab, make sure both boxes are checked.
# Inside the file you downloaded, open Word2MediaWikiPlus_Installer.doc and hit the "Enable Macros" button when you are prompted.
# Press the "Install or updated macro" button in the document. (It should automatically install the toolbar for it.)
# Go back to "Trusted Publishers" in Macro Security and uncheck "Trust access to Visual Basic Project".

====Configuring====
* Image path: You can change this to your preference. This is where images will be saved on export.
* URL wiki production system: http://wiki.ubc.ca

====Converting====
# Open the document you wish to convert.
# Click on the "Convert to Wiki" button in the toolbar.
# Settings
#* Article Name: This is the title that your article will have.
#* Article Category: Optional, uncheck it if you are uncertain. You may also search the wiki for possible categories, such as "Undergraduates" or "Researching".
#* Image Category: Optional. Delete any text in the second box if you are unsure of the categories.
#* Additional text for image description: Optional, but might help other people searching wiki images
#* Text Conversion: Generally you want to uncheck everything except "convert font size".
#* Target Wiki: Production System
#* Image Handling: Check "Image Extraction" if you do not already have a copy of the images as separate files.
#* Image Size: Generally, choose "use full size image"
# Press Convert! then copy/paste the resulting text into the wiki editing box, and save!
# [[Special:Upload|Upload]] any images to the wiki. If you rename any of the images before uploading, make sure to change the names on your wiki page as well.

[http://MediaWiki.org MediaWiki.org] also maintains a [http://www.mediawiki.org/wiki/Word_macros list of Word macros] that can be installed that can help convert a Word document into wiki markup.

[[Category: Help]]

Library:Wiki Documentation

2011-04-28T05:46:27Z

CynthiaNg: added apa section

__TOC__

==DPL==
A quick aside, most ideas/functions presented are typical of any wiki, but DPL is an extension that's been installed. Dynamic page lists are very useful and allow automated listing of wiki pages based on category, page title, space, etc. Here's the basic: [[Help:Dynamic_Page_Lists]]. A more complete documentation can be found on the [http://www.mediawiki.org/wiki/Extension:DynamicPageList_%28Wikimedia%29 DPL extension page].

==Library Space Permissions==
Only library staff can create/edit pages in the library space. However, there is not way to automatically add library staff, so it must be done manually (adding and removing). All web services staff should have administrator status for the library space. Simply go to the [[Special:UserRights|special user rights page]], search for the user (remember, it's capital sensitive like everything else in the wiki) and add them to the library space.

==Library:Home==
Perhaps the best way to start is from the [[Library:Home]] page.

The home page acts as a front or portal page to other pages as well as where we have displayed our wiki guidelines and guidelines on the use of the wiki. These guidelines fluctuate as the use of the various tools grow and discussions happen surrounding related issues.

===Future Guidelines Work===
Beyond these existing guidelines, there's a lot of interest in seeing standards or conventions established. In particularly, naming conventions (especially for categories, but possibly for pages too). Some relate to layout/content, which is discussed below.

===Library Home Pages===
As you can see, there are a few pages that have been created under which any library wiki page should be able to fit. The idea is that wiki pages in the library space can be easily found if it is properly categorized simply by browsing. Here are a couple of quick notes on the purpose of each page and how it's created.

*[[:Category:Library|All Library Pages]] - goes to the Library category page, which is the top level of the hierarchy (see below for further explanation)
*[[Library:Branches|Branches]] - page where a dpl has been created for each library branch that currently have their own category (i.e. many branches do not)
*[[Library:Committee_Pages|Committees and Groups]] - this is a manual list linking to the committee or group's "home" page
*[[Library:Help_For_You|Help & Services Portal]] - made with dpl lists. Help is divided into the various categories as organized on the actual [http://help.library.ubc.ca Help Portal], but Services is just one category as there are only a few pages that are fed from the wiki
*[[Library:Instructional_Materials|Instructional Materials]] - dpl list of various categories related to tutorials/instructional content in the library space
*[[Library:Learn_to_Use_the_Wiki|Learn to Use the Wiki]] - links to the library version of the using [[Help:Tutorial|wiki tutorial]]. As there is also a [[Library:WordPress_and_Wiki_Tutorial]] now, some consideration might go into having a page that lists wiki/wordpress/ltk/other(?) tutorials that are created by LSIT folks as well as a list of tutorials created by other UBC areas, such as [[Documentation:WordPress_Basics]]
*[[Library:LTK_Manual|LTK Manual]] - as the name suggests, link to the LTK user manual

==Library Space Organization==
===Subpages===
As with the general UBC wiki, the practice in making related pages is to use subpages. e.g. [[Library:Microforms]] is a big topical/resource page with related material or parts of this page being created as subpages e.g. [[Library:Microforms/AmericanFiction]]

===Deleting Pages===
Since pages cannot be deleted, the wiki administrator takes care of that. Mark pages for deletion using the template: <nowiki>{{Delete}}</nowiki>

===Categories===
Beyond the home page acting as a portal, categories that are typically being used in the library space has been organized into a kind of hierarchy. Obviously, since the wiki is not a strict child-has-only-one-parent structure, it can become much more complex.

As of April 2011, here's a diagram of how the categories are organized:
[[Image:wiki categories.png|alt=Library space wiki categories organization|890px]]

In most cases (so far), users do not categorize their own pages. Thus, it is up to someone in LSIT to do so. As the library space grows, categories will likely need reorganization/rearrangement (e.g. [[:Category:Library Units]] was only recently created). How that's done is up to the community in essence, but LSIT can provide a basis or direction perhaps for this simply by example. So far, it's really been a "create as needed to group pages or categories" approach. Higher up categories all lead back to the main [[:Category:Library]] allowing users to browse library related categories and pages in a more organized manner.

Currently, uncategorized library space wiki pages are listed using a DPL in the description of [[:Category:Library]] page.

===Future Organization?===
* Categories are generally assigned based on the most specific category (or categories) that are applicable, but users do not always do it this way (e.g. categorizing a page in both "Library Tutorials" and "Finding Library Resources"). So far, this has been left alone, but for better organization, more work may need to be done in explaining to our users best practices.
* So far, categories have only been added to uncategorized pages (i.e. no library related category). However, you would always want ''all'' the related categories to be applied to a wiki page. For example, a user may create a tutorial, such as Searching Web of Science, and categorize it only under their branch, say HSSD. Since this page has a library related category, it no longer shows up on uncategorized. However, this page should also have the category 'Searching Databases' on it for others to find it. More advanced DPL lists could be used to help with this, but this has not been set up as of yet.
* Some library users have also started using more general categories that so far have been considered outside the library's specific use. For example, Nursing, Literature, History, HSS (Humanities and Social Sciences), etc. No work has been done yet in organizing these categories, but for the greater UBC Wiki use, you may want to coordinate with the Wiki Administrator (in CTLT) to help organize these categories.

==Use of Tranclusion==
One of the most appealing parts of the wiki (other than being able to embed it on WordPress and LTK) is the use of template or [http://en.wikipedia.org/wiki/Transclusion transclusion] (or as some refer to it, importing of content, but this term doesn't reflect that it also imports layout/structure).

So far, it has mostly been used for the reuse/redistribution of guidelines and parts of wiki/wordpress tutorials.

In wider library usage, it has mostly been used to create searching tutorials (mostly databases) and then modifying the examples to gear it towards a specific course/topic. For example, here's the test case: [[Sandbox:Library/How_to_Search_Web_of_Science]] as the main template page and then example use case: [[Sandbox:Library/How_to_Search_Web_of_Science_Psychology_Examples]]

===Transclusion of Categories===
When a page is transcluded, normally everything is transcluded including categories. However, there are a couple of categories, particularly 'Library Website', 'Help Site' and 'Services Portal', where this is not desirable (because these categories should only refer to wiki pages that show up on the library website). To prevent something from being transcluded (here it's being used for categories but can eseentially be used for anything), use the <nowiki><noinclude></noinclude></nowiki> tag, literally telling wiki, 'do not include this portion' when transcluding. More detailed information can be found in the [[Help:Templates#Control_template_inclusion|Help Templates article]].

===Future Work===
1. The current [[Help:Templates]] article may be difficult for new wiki users to understand. Consider revising it to make it more understandable for library staff and other new users of UBC wiki.

2. As with preventing library website categories from being transcluded, work could be done in teaching library users that they may want to add the noinclude tag when the branch category is used as well, so that faculty pages for example are not added to their library branch category. Whether is a good idea needs further discussion.

3. Note: what is discussed below is still the same concept of template or transclusion, but here the focus is more on when someone wants to create a "new page" rather than simply changing small bits and pieces of text of an existing page.

One of the things the library can explore is the use of the more traditional sense of a template. That is a pre-set structure (in this case, wiki markup) already in place when someone creates a page. This will give a more uniform look to pages, especially those that might be used on the main library webpage. Good examples where this might be useful are course/user library guides, tutorials on searching resources (e.g. databases) or finding materials. The template may be layout and/or content based.

====Tutorials====
Whereas the current use allows users to make changes to an existing tutorial to fit topically, this is a suggestion for a broader layout template be used for all database tutorials for example, so that they all look similar. Try the Course [[UBC_Wiki:Create_a_New_Page|create a page]] (then preview) as an example. Taking searching databases as an example, there might be a set layout for the database name, interface/vender name (e.g. EBSCO), short description, list of subjects most useful for, link to database, access instructions, librarian contact info, etc. some of which could be in the side box at the top (much like the course template), then have some pre-set markup as a guide, but which is customizable. For example, <pre><nowiki>
==Basic Search==
# Step 1 here [Image:screenshot example.jpg|alt=description here]
# Step 2
#* Note for step 2

==Advanced Search==

==Print/Save/Export/E-mail Citations==

==Staying Current: Saved Searches, E-mail Alerts, & RSS Feeds==

==Other Useful Resources==
* [http://example.com name of website]
* [[Library:example page | name of another wiki page]]</nowiki></pre>

Much like the one for Course pages, obviously, instructions can also be added to the top of the page.

====User Guides====
These two guides for example: [[Library:UBC_Library_Resources]] and [[Library:Library_Resources_for_the_Faculty_of_Arts]] have similar content and layout (as of April 2011). Beyond the fact that these pages have almost identical content and should use transclusion, the layout is similar enough that you might want this layout to be a pre-set template for all user guides.

====Create a page box/form====
If desirable, the wiki administrator will be able to help to set up a "create a page" for the library (much like the Main/Course/Documentation/Sandbox space ones), which can then be added to the library home page (or take a look at the Create a page code).

==Workshops==
So far, workshops have been on request basis, with usually at least a basic workshop for those doing branch migration that see the need for wiki use. However, especially since summer is more quiet around campus, you might consider doing a couple of workshops where you just invite people in, create drop-in sessions (outside of the LSIT area where people can easily reach you), or coordinate with CTLT to sit in their drop-in session announcing to library staff that you will also be available at the same time. Or come up with some other event!

Workshops that people seem to be interested in:
* basic workshop orienting staff to the Library space (and other spaces), creating/editing pages
* Finding/using/adding/creating categories/subcategories, and organization of the Library categories
** Note: It's especially important for users to know that categories can be used by anyone in UBC Wiki (unlike pages in the Library space). For example, 'Music' is not a good idea, but 'Music Library' works.
* Transclusion/Templating

==Communications==
Although ideally to communicate about wiki page suggestion/issues are done through the discussion page or the user's talk page, many users do not make use of either (possibly because they are unaware of its function). The best way to discuss something is usually via e-mail, phone, or in person, and then also refer to and/or teach users to use the talk pages.

==Appendix==
Below is what I used to have on my own talk page. It's basically a list of pages that I worked on/created. It's especially useful since many of the in progress/draft ones do not have a category yet, and they are part of the Help Portal migration. Others, such as templates are particularly useful in helping with wiki maintenance.

* [[Library:Home]]

Templates
* [[Template:Update]]
* [[Template:Draft]]
* [[Template:Delete]]
* [[Template:TOC Limit]]

* [[Template:Hanging Indent]]
* [[Template:Citation Example]]
* [[Template:APA Citation]]

Categories
* [[:Category:Library]]
* [[:Category:Library_Tutorials]] with subcategories
** [[:Category:Finding Library Resources]]
** [[:Category:Researching at the Library]]
*** [[:Category:Searching_Databases]] (currently a subcategory of Researching)
* [[:Category:APA Style]]
* [[:Category:Need Updating]] (hidden category)
* [[:Category:EDST]]

'''Services Site pages:'''
* [[:Category:Services Portal]]

'''Help site pages:'''

* [[:Category:Help_Site]]
** [[:Category:Library_User_Guides]]
* [[Library:Help_For_You]]

Borrowing
* [[Library:Borrowing/From_non-UBC_Libraries]]

Finding
* [[Library:How_to_Find_Articles]] - JM

Researching
* [[Library:Course_Specific_Tutorials]] - TR
* [[Library:Searching_Databases]] - Dec 2010, not live on site
* [[Library:Evaluating_Print_Sources]] - approved by AG
* [[Library:Evaluating_Internet_Sources]] - approved by AG

For Learning Commons
* [[Learning_Commons:Chapman_Learning_Commons/APA_Style_Guide]] and [[:Category:APA Style]] from [http://www.library.ubc.ca/pubs/apastyle.pdf Getting Started with APA Style Guide] - documentation needed in creating custom style guide

'''Help Site In Progress:'''

Borrowing
* [[Sandbox:Library/Requesting_from_ASRS]] from [http://www.library.ubc.ca/home/asrs/how-to/ Instructions on Ordering from ASRS]

Finding
* [[Sandbox:Library_Finding_Videos]] from [http://www.library.ubc.ca/home/about/services/gtvid.html Guide to Videos, Films and DVDs]
* [[Sandbox:Library_Finding_Sound_Recordings]] from [http://www.library.ubc.ca/pubs/htfrec.pdf Guide to Sound Recordings] and [http://www.library.ubc.ca/pubs/gtwilson.pdf Guide to Wilson Recordings].
* [[Sandbox:Library/Finding_Maps]] from [http://www.library.ubc.ca/map/mapguide.html Guide to the Map & Atlas Collection], and [http://www.library.ubc.ca/map/mapfaqs.html Map & Atlas Collection FAQ's]
* [[Sandbox:Library/Finding_Microforms]] from [http://www.library.ubc.ca/microfrm/collections.html Microform Collections]
* [[Sandbox:Library/Finding_Newspapers]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=342 Newspapers and News Sources]
* [[Sandbox:Library/Finding_Primary_Sources]] from [http://www.library.ubc.ca/hss/primarysources.html Primary Sources] -> being moved to LTK?
* [[Sandbox:Library/Finding_Theses_and_Dissertations]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=37 FAQ: Dissertations and Theses]
* [[Sandbox:Library/Finding_Book_Film_%26_Theatre_Reviews]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=529 Book, Film, and Theatre Reviews] with A-Z list excluded (which should probably be developed in LTK)

Researching
* [[Sandbox:Library/Getting_Started_with_your_Research_Paper]] from [http://www.library.ubc.ca/home/about/instruct/tp-res.html Term Paper Research: Getting Started]
* [[Sandbox:Library/Finding_the_Right_Sources_for_Literature_Review]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=502 Finding the Right Information Sources For a Literature Review] - page best done with some parts on seperate pages or merged with existing pages and transcluding those sections
* [[Sandbox:Library/How_to_Search_Web_of_Science]] from [http://www.library.ubc.ca/life/instruction/pubs/webofscience.pdf How to Search Web of Science] - parameters added, Example [[Sandbox:Library/How_to_Search_Web_of_Science_Psychology_Examples]]
* [[Sandbox:Library/How_to_Search_PubMed]] is not [http://www.library.ubc.ca/life/instruction/pubs/pubmed.pdf How to Search PubMed]
* Searching the Web -> http://www.library.ubc.ca/home/websearch/quick.html

'''Ever changing test page:'''
* [[Sandbox:Library_Test_Page]] Currently dpl of pages that might need maintenance

'''Documentation:'''
* Parts of [[Help:Contents]]
* [[Library:When_to_Use_the_Wiki]]
* [[Help:Guidelines]]
* [[Library:Learn_to_Use_the_Wiki]] / [[Library:Wiki_Tutorial]]
* [[Help:Tutorial]]
* [[Help:Wiki_to_WordPress]]

===Old Work: APA Citation Guide===
One of the projects that was started last summer was to move the APA and MLA citation guides to the wiki, starting with APA. The idea was to break up the APA guide into really small pieces so staff/faculty could potentially create custom guides with the types of examples that they wanted (e.g. journal articles with or without DOI). It was for this project that various templates, categories, pages were created. However, as those working on the project became busy, it was put aside.

Library:Wiki Documentation

2011-04-28T05:42:23Z

CynthiaNg: /* Workshops */ added list of workshops

__TOC__

==DPL==
A quick aside, most ideas/functions presented are typical of any wiki, but DPL is an extension that's been installed. Dynamic page lists are very useful and allow automated listing of wiki pages based on category, page title, space, etc. Here's the basic: [[Help:Dynamic_Page_Lists]]. A more complete documentation can be found on the [http://www.mediawiki.org/wiki/Extension:DynamicPageList_%28Wikimedia%29 DPL extension page].

==Library Space Permissions==
Only library staff can create/edit pages in the library space. However, there is not way to automatically add library staff, so it must be done manually (adding and removing). All web services staff should have administrator status for the library space. Simply go to the [[Special:UserRights|special user rights page]], search for the user (remember, it's capital sensitive like everything else in the wiki) and add them to the library space.

==Library:Home==
Perhaps the best way to start is from the [[Library:Home]] page.

The home page acts as a front or portal page to other pages as well as where we have displayed our wiki guidelines and guidelines on the use of the wiki. These guidelines fluctuate as the use of the various tools grow and discussions happen surrounding related issues.

==Future Guidelines Work==
Beyond these existing guidelines, there's a lot of interest in seeing standards or conventions established. In particularly, naming conventions (especially for categories, but possibly for pages too). Some relate to layout/content, which is discussed below.

===Library Home Pages===
As you can see, there are a few pages that have been created under which any library wiki page should be able to fit. The idea is that wiki pages in the library space can be easily found if it is properly categorized simply by browsing. Here are a couple of quick notes on the purpose of each page and how it's created.

*[[:Category:Library|All Library Pages]] - goes to the Library category page, which is the top level of the hierarchy (see below for further explanation)
*[[Library:Branches|Branches]] - page where a dpl has been created for each library branch that currently have their own category (i.e. many branches do not)
*[[Library:Committee_Pages|Committees and Groups]] - this is a manual list linking to the committee or group's "home" page
*[[Library:Help_For_You|Help & Services Portal]] - made with dpl lists. Help is divided into the various categories as organized on the actual [http://help.library.ubc.ca Help Portal], but Services is just one category as there are only a few pages that are fed from the wiki
*[[Library:Instructional_Materials|Instructional Materials]] - dpl list of various categories related to tutorials/instructional content in the library space
*[[Library:Learn_to_Use_the_Wiki|Learn to Use the Wiki]] - links to the library version of the using [[Help:Tutorial|wiki tutorial]]. As there is also a [[Library:WordPress_and_Wiki_Tutorial]] now, some consideration might go into having a page that lists wiki/wordpress/ltk/other(?) tutorials that are created by LSIT folks as well as a list of tutorials created by other UBC areas, such as [[Documentation:WordPress_Basics]]
*[[Library:LTK_Manual|LTK Manual]] - as the name suggests, link to the LTK user manual

==Library Space Organization==
===Subpages===
As with the general UBC wiki, the practice in making related pages is to use subpages. e.g. [[Library:Microforms]] is a big topical/resource page with related material or parts of this page being created as subpages e.g. [[Library:Microforms/AmericanFiction]]

===Deleting Pages===
Since pages cannot be deleted, the wiki administrator takes care of that. Mark pages for deletion using the template: <nowiki>{{Delete}}</nowiki>

===Categories===
Beyond the home page acting as a portal, categories that are typically being used in the library space has been organized into a kind of hierarchy. Obviously, since the wiki is not a strict child-has-only-one-parent structure, it can become much more complex.

As of April 2011, here's a diagram of how the categories are organized:
[[Image:wiki categories.png|alt=Library space wiki categories organization|890px]]

In most cases (so far), users do not categorize their own pages. Thus, it is up to someone in LSIT to do so. As the library space grows, categories will likely need reorganization/rearrangement (e.g. [[:Category:Library Units]] was only recently created). How that's done is up to the community in essence, but LSIT can provide a basis or direction perhaps for this simply by example. So far, it's really been a "create as needed to group pages or categories" approach. Higher up categories all lead back to the main [[:Category:Library]] allowing users to browse library related categories and pages in a more organized manner.

Currently, uncategorized library space wiki pages are listed using a DPL in the description of [[:Category:Library]] page.

===Future Organization?===
* Categories are generally assigned based on the most specific category (or categories) that are applicable, but users do not always do it this way (e.g. categorizing a page in both "Library Tutorials" and "Finding Library Resources"). So far, this has been left alone, but for better organization, more work may need to be done in explaining to our users best practices.
* So far, categories have only been added to uncategorized pages (i.e. no library related category). However, you would always want ''all'' the related categories to be applied to a wiki page. For example, a user may create a tutorial, such as Searching Web of Science, and categorize it only under their branch, say HSSD. Since this page has a library related category, it no longer shows up on uncategorized. However, this page should also have the category 'Searching Databases' on it for others to find it. More advanced DPL lists could be used to help with this, but this has not been set up as of yet.
* Some library users have also started using more general categories that so far have been considered outside the library's specific use. For example, Nursing, Literature, History, HSS (Humanities and Social Sciences), etc. No work has been done yet in organizing these categories, but for the greater UBC Wiki use, you may want to coordinate with the Wiki Administrator (in CTLT) to help organize these categories.

==Use of Tranclusion==
One of the most appealing parts of the wiki (other than being able to embed it on WordPress and LTK) is the use of template or [http://en.wikipedia.org/wiki/Transclusion transclusion] (or as some refer to it, importing of content, but this term doesn't reflect that it also imports layout/structure).

So far, it has mostly been used for the reuse/redistribution of guidelines and parts of wiki/wordpress tutorials.

In wider library usage, it has mostly been used to create searching tutorials (mostly databases) and then modifying the examples to gear it towards a specific course/topic. For example, here's the test case: [[Sandbox:Library/How_to_Search_Web_of_Science]] as the main template page and then example use case: [[Sandbox:Library/How_to_Search_Web_of_Science_Psychology_Examples]]

===Transclusion of Categories===
When a page is transcluded, normally everything is transcluded including categories. However, there are a couple of categories, particularly 'Library Website', 'Help Site' and 'Services Portal', where this is not desirable (because these categories should only refer to wiki pages that show up on the library website). To prevent something from being transcluded (here it's being used for categories but can eseentially be used for anything), use the <nowiki><noinclude></noinclude></nowiki> tag, literally telling wiki, 'do not include this portion' when transcluding. More detailed information can be found in the [[Help:Templates#Control_template_inclusion|Help Templates article]].

===Future Work===
1. The current [[Help:Templates]] article may be difficult for new wiki users to understand. Consider revising it to make it more understandable for library staff and other new users of UBC wiki.

2. As with preventing library website categories from being transcluded, work could be done in teaching library users that they may want to add the noinclude tag when the branch category is used as well, so that faculty pages for example are not added to their library branch category. Whether is a good idea needs further discussion.

3. Note: what is discussed below is still the same concept of template or transclusion, but here the focus is more on when someone wants to create a "new page" rather than simply changing small bits and pieces of text of an existing page.

One of the things the library can explore is the use of the more traditional sense of a template. That is a pre-set structure (in this case, wiki markup) already in place when someone creates a page. This will give a more uniform look to pages, especially those that might be used on the main library webpage. Good examples where this might be useful are course/user library guides, tutorials on searching resources (e.g. databases) or finding materials. The template may be layout and/or content based.

====Tutorials====
Whereas the current use allows users to make changes to an existing tutorial to fit topically, this is a suggestion for a broader layout template be used for all database tutorials for example, so that they all look similar. Try the Course [[UBC_Wiki:Create_a_New_Page|create a page]] (then preview) as an example. Taking searching databases as an example, there might be a set layout for the database name, interface/vender name (e.g. EBSCO), short description, list of subjects most useful for, link to database, access instructions, librarian contact info, etc. some of which could be in the side box at the top (much like the course template), then have some pre-set markup as a guide, but which is customizable. For example, <pre><nowiki>
==Basic Search==
# Step 1 here [Image:screenshot example.jpg|alt=description here]
# Step 2
#* Note for step 2

==Advanced Search==

==Print/Save/Export/E-mail Citations==

==Staying Current: Saved Searches, E-mail Alerts, & RSS Feeds==

==Other Useful Resources==
* [http://example.com name of website]
* [[Library:example page | name of another wiki page]]</nowiki></pre>

Much like the one for Course pages, obviously, instructions can also be added to the top of the page.

====User Guides====
These two guides for example: [[Library:UBC_Library_Resources]] and [[Library:Library_Resources_for_the_Faculty_of_Arts]] have similar content and layout (as of April 2011). Beyond the fact that these pages have almost identical content and should use transclusion, the layout is similar enough that you might want this layout to be a pre-set template for all user guides.

====Create a page box/form====
If desirable, the wiki administrator will be able to help to set up a "create a page" for the library (much like the Main/Course/Documentation/Sandbox space ones), which can then be added to the library home page (or take a look at the Create a page code).

==Workshops==
So far, workshops have been on request basis, with usually at least a basic workshop for those doing branch migration that see the need for wiki use. However, especially since summer is more quiet around campus, you might consider doing a couple of workshops where you just invite people in, create drop-in sessions (outside of the LSIT area where people can easily reach you), or coordinate with CTLT to sit in their drop-in session announcing to library staff that you will also be available at the same time. Or come up with some other event!

Workshops that people seem to be interested in:
* basic workshop orienting staff to the Library space (and other spaces), creating/editing pages
* Finding/using/adding/creating categories/subcategories, and organization of the Library categories
** Note: It's especially important for users to know that categories can be used by anyone in UBC Wiki (unlike pages in the Library space). For example, 'Music' is not a good idea, but 'Music Library' works.
* Transclusion/Templating

==Communications==
Although ideally to communicate about wiki page suggestion/issues are done through the discussion page or the user's talk page, many users do not make use of either (possibly because they are unaware of its function). The best way to discuss something is usually via e-mail, phone, or in person, and then also refer to and/or teach users to use the talk pages.

==Appendix==
Below is what I used to have on my own talk page. It's basically a list of pages that I worked on/created. It's especially useful since many of the in progress/draft ones do not have a category yet, and they are part of the Help Portal migration. Others, such as templates are particularly useful in helping with wiki maintenance.

* [[Library:Home]]

Templates
* [[Template:Update]]
* [[Template:Draft]]
* [[Template:Delete]]
* [[Template:TOC Limit]]

* [[Template:Hanging Indent]]
* [[Template:Citation Example]]
* [[Template:APA Citation]]

Categories
* [[:Category:Library]]
* [[:Category:Library_Tutorials]] with subcategories
** [[:Category:Finding Library Resources]]
** [[:Category:Researching at the Library]]
*** [[:Category:Searching_Databases]] (currently a subcategory of Researching)
* [[:Category:APA Style]]
* [[:Category:Need Updating]] (hidden category)
* [[:Category:EDST]]

'''Services Site pages:'''
* [[:Category:Services Portal]]

'''Help site pages:'''

* [[:Category:Help_Site]]
** [[:Category:Library_User_Guides]]
* [[Library:Help_For_You]]

Borrowing
* [[Library:Borrowing/From_non-UBC_Libraries]]

Finding
* [[Library:How_to_Find_Articles]] - JM

Researching
* [[Library:Course_Specific_Tutorials]] - TR
* [[Library:Searching_Databases]] - Dec 2010, not live on site
* [[Library:Evaluating_Print_Sources]] - approved by AG
* [[Library:Evaluating_Internet_Sources]] - approved by AG

For Learning Commons
* [[Learning_Commons:Chapman_Learning_Commons/APA_Style_Guide]] and [[:Category:APA Style]] from [http://www.library.ubc.ca/pubs/apastyle.pdf Getting Started with APA Style Guide] - documentation needed in creating custom style guide

'''Help Site In Progress:'''

Borrowing
* [[Sandbox:Library/Requesting_from_ASRS]] from [http://www.library.ubc.ca/home/asrs/how-to/ Instructions on Ordering from ASRS]

Finding
* [[Sandbox:Library_Finding_Videos]] from [http://www.library.ubc.ca/home/about/services/gtvid.html Guide to Videos, Films and DVDs]
* [[Sandbox:Library_Finding_Sound_Recordings]] from [http://www.library.ubc.ca/pubs/htfrec.pdf Guide to Sound Recordings] and [http://www.library.ubc.ca/pubs/gtwilson.pdf Guide to Wilson Recordings].
* [[Sandbox:Library/Finding_Maps]] from [http://www.library.ubc.ca/map/mapguide.html Guide to the Map & Atlas Collection], and [http://www.library.ubc.ca/map/mapfaqs.html Map & Atlas Collection FAQ's]
* [[Sandbox:Library/Finding_Microforms]] from [http://www.library.ubc.ca/microfrm/collections.html Microform Collections]
* [[Sandbox:Library/Finding_Newspapers]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=342 Newspapers and News Sources]
* [[Sandbox:Library/Finding_Primary_Sources]] from [http://www.library.ubc.ca/hss/primarysources.html Primary Sources] -> being moved to LTK?
* [[Sandbox:Library/Finding_Theses_and_Dissertations]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=37 FAQ: Dissertations and Theses]
* [[Sandbox:Library/Finding_Book_Film_%26_Theatre_Reviews]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=529 Book, Film, and Theatre Reviews] with A-Z list excluded (which should probably be developed in LTK)

Researching
* [[Sandbox:Library/Getting_Started_with_your_Research_Paper]] from [http://www.library.ubc.ca/home/about/instruct/tp-res.html Term Paper Research: Getting Started]
* [[Sandbox:Library/Finding_the_Right_Sources_for_Literature_Review]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=502 Finding the Right Information Sources For a Literature Review] - page best done with some parts on seperate pages or merged with existing pages and transcluding those sections
* [[Sandbox:Library/How_to_Search_Web_of_Science]] from [http://www.library.ubc.ca/life/instruction/pubs/webofscience.pdf How to Search Web of Science] - parameters added, Example [[Sandbox:Library/How_to_Search_Web_of_Science_Psychology_Examples]]
* [[Sandbox:Library/How_to_Search_PubMed]] is not [http://www.library.ubc.ca/life/instruction/pubs/pubmed.pdf How to Search PubMed]
* Searching the Web -> http://www.library.ubc.ca/home/websearch/quick.html

'''Ever changing test page:'''
* [[Sandbox:Library_Test_Page]] Currently dpl of pages that might need maintenance

'''Documentation:'''
* Parts of [[Help:Contents]]
* [[Library:When_to_Use_the_Wiki]]
* [[Help:Guidelines]]
* [[Library:Learn_to_Use_the_Wiki]] / [[Library:Wiki_Tutorial]]
* [[Help:Tutorial]]
* [[Help:Wiki_to_WordPress]]

Category:Library

2011-04-21T18:09:09Z

CynthiaNg: added description

This is the category for articles relating to the UBC Library that are very general and would not fit elsewhere. Please use a subcategory instead when applicable or create a new subcategory if it is something that would be commonly used.

==Needs a Category!==
These pages have no category. In our efforts to help keep the wiki organized, if it belongs to you, please add one.
<dpl>
columns = 3
namespace = Library
notcategory = Candidates for deletion
notcategory = Circle
notcategory = DESC
notcategory = DigInit
notcategory = Digi-group
notcategory = Events_(Library)
notcategory = Finding Library Resources
notcategory = HSSD
notcategory = UBC Law Library
notcategory = LTK
notcategory = Help Site
notcategory = Library
notcategory = Library Faculty Arts Guides
notcategory = Library CTLT Guides
notcategory = Library Units
notcategory = Library User Guides
notcategory = Library Tutorials
notcategory = Microforms
notcategory = Primary Sources
notcategory = Researching at the Library
notcategory = Searching Databases
notcategory = Services Portal
notcategory = SciEng Library
notcategory = Sutherland
notcategory = UBC Library Staff
notcategory = UBC Wiki
notcategory = TLAC
notcategory = Wimba
shownamespace = false
</dpl>

Library:Home

2011-04-21T18:08:03Z

CynthiaNg: fixed typo

{{TOC Limit|limit=2}}
==Library Pages in the Wiki==


* Browse Library Pages: [[:Category:Library|by Category]] | [http://wiki.ubc.ca/index.php?title=Special%3AAllPages&from=&to=&namespace=120 Alphabetically]
*[[Library:Branches|Branches]]
*[[Library:Committee_Pages|Committees and Groups]]
*[[Library:Help_Portal_Wiki_Pages|Help Portal Wiki Pages]]
*[[Library:Services_Portal_Wiki_Pages|Services Portal Wiki Pages]]
*[[Library:Instructional_Materials|Instructional Materials]]
*[[Library:Learn_to_Use_the_Wiki|Learn to Use the Wiki]]
*[[Library:LTK_Manual|LTK Manual]]

==Wiki Guidelines==
{{Help:Guidelines
|namex=.
|organizex=Any pages created for library staff use should be in the Library namespace. Make sure your page is prefixed with "Library:", such as wiki.ubc.ca/Library:Example_page. If you have a lot of pages related to a topic, you should make subpages for the related pages by adding a forward slash, such as wiki.ubc.ca/Library:Example_page/my_related_page.
|leavex=Pages in the Library namespace can be edited by any library staff.
|catex=To help keep the Library space organized, you should '''always add''' at least one category, usually your branch or the topic (e.g. [[:Category:Finding Library Resources]]), and new library categories should be added to to [[:Category:Library]].}}

{{Library:When_to_Use_the_Wiki}}

[[Category:Library]]

Library:Home

2011-04-21T16:55:25Z

CynthiaNg: fixed link

{{TOC Limit|limit=2}}
==Library Pages in the Wiki==


* Browse Library Pages [[:Category:Library|by Category]] | [http://wiki.ubc.ca/index.php?title=Special%3AAllPages&from=&to=&namespace=120 Alphabetically]
*[[Library:Branches|Branches]]
*[[Library:Committee_Pages|Committees and Groups]]
*[[Library:Help_Portal_Wiki_Pages|Help Portal Wiki Pages]]
*[[Library:Services_Portal_Wiki_Pages|Services Portal Wiki Pages]]
*[[Library:Instructional_Materials|Instructional Materials]]
*[[Library:Learn_to_Use_the_Wiki|Learn to Use the Wiki]]
*[[Library:LTK_Manual|LTK Manual]]

==Wiki Guidelines==
{{Help:Guidelines
|namex=.
|organizex=Any pages created for library staff use should be in the Library namespace. Make sure your page is prefixed with "Library:", such as wiki.ubc.ca/Library:Example_page. If you have a lot of pages related to a topic, you should make subpages for the related pages by adding a forward slash, such as wiki.ubc.ca/Library:Example_page/my_related_page.
|leavex=Pages in the Library namespace can be edited by any library staff.
|catex=To help keep the Library space organized, you should '''always add''' at least one category, usually your branch or the topic (e.g. [[:Category:Finding Library Resources]]), and new library categories should be added to to [[:Category:Library]].}}

{{Library:When_to_Use_the_Wiki}}

[[Category:Library]]

Library:Home

2011-04-21T16:54:59Z

CynthiaNg: added link

{{TOC Limit|limit=2}}
==Library Pages in the Wiki==


* Browse Library Pages [[:Category:Library|by Category]] | [http:/wiki.ubc.ca/index.php?title=Special%3AAllPages&from=&to=&namespace=120 Alphabetically]
*[[Library:Branches|Branches]]
*[[Library:Committee_Pages|Committees and Groups]]
*[[Library:Help_Portal_Wiki_Pages|Help Portal Wiki Pages]]
*[[Library:Services_Portal_Wiki_Pages|Services Portal Wiki Pages]]
*[[Library:Instructional_Materials|Instructional Materials]]
*[[Library:Learn_to_Use_the_Wiki|Learn to Use the Wiki]]
*[[Library:LTK_Manual|LTK Manual]]

==Wiki Guidelines==
{{Help:Guidelines
|namex=.
|organizex=Any pages created for library staff use should be in the Library namespace. Make sure your page is prefixed with "Library:", such as wiki.ubc.ca/Library:Example_page. If you have a lot of pages related to a topic, you should make subpages for the related pages by adding a forward slash, such as wiki.ubc.ca/Library:Example_page/my_related_page.
|leavex=Pages in the Library namespace can be edited by any library staff.
|catex=To help keep the Library space organized, you should '''always add''' at least one category, usually your branch or the topic (e.g. [[:Category:Finding Library Resources]]), and new library categories should be added to to [[:Category:Library]].}}

{{Library:When_to_Use_the_Wiki}}

[[Category:Library]]

Library:Wiki Documentation

2011-04-19T21:57:34Z

CynthiaNg: added various bits

__TOC__

==DPL==
A quick aside, most ideas/functions presented are typical of any wiki, but DPL is an extension that's been installed. Dynamic page lists are very useful and allow automated listing of wiki pages based on category, page title, space, etc. Here's the basic: [[Help:Dynamic_Page_Lists]]. A more complete documentation can be found on the [http://www.mediawiki.org/wiki/Extension:DynamicPageList_%28Wikimedia%29 DPL extension page].

==Library Space Permissions==
Only library staff can create/edit pages in the library space. However, there is not way to automatically add library staff, so it must be done manually (adding and removing). All web services staff should have administrator status for the library space. Simply go to the [[Special:UserRights|special user rights page]], search for the user (remember, it's capital sensitive like everything else in the wiki) and add them to the library space.

==Library:Home==
Perhaps the best way to start is from the [[Library:Home]] page.

The home page acts as a front or portal page to other pages as well as where we have displayed our wiki guidelines and guidelines on the use of the wiki. These guidelines fluctuate as the use of the various tools grow and discussions happen surrounding related issues.

==Future Guidelines Work==
Beyond these existing guidelines, there's a lot of interest in seeing standards or conventions established. In particularly, naming conventions (especially for categories, but possibly for pages too). Some relate to layout/content, which is discussed below.

===Library Home Pages===
As you can see, there are a few pages that have been created under which any library wiki page should be able to fit. The idea is that wiki pages in the library space can be easily found if it is properly categorized simply by browsing. Here are a couple of quick notes on the purpose of each page and how it's created.

*[[:Category:Library|All Library Pages]] - goes to the Library category page, which is the top level of the hierarchy (see below for further explanation)
*[[Library:Branches|Branches]] - page where a dpl has been created for each library branch that currently have their own category (i.e. many branches do not)
*[[Library:Committee_Pages|Committees and Groups]] - this is a manual list linking to the committee or group's "home" page
*[[Library:Help_For_You|Help & Services Portal]] - made with dpl lists. Help is divided into the various categories as organized on the actual [http://help.library.ubc.ca Help Portal], but Services is just one category as there are only a few pages that are fed from the wiki
*[[Library:Instructional_Materials|Instructional Materials]] - dpl list of various categories related to tutorials/instructional content in the library space
*[[Library:Learn_to_Use_the_Wiki|Learn to Use the Wiki]] - links to the library version of the using [[Help:Tutorial|wiki tutorial]]. As there is also a [[Library:WordPress_and_Wiki_Tutorial]] now, some consideration might go into having a page that lists wiki/wordpress/ltk/other(?) tutorials that are created by LSIT folks as well as a list of tutorials created by other UBC areas, such as [[Documentation:WordPress_Basics]]
*[[Library:LTK_Manual|LTK Manual]] - as the name suggests, link to the LTK user manual

==Library Space Organization==
===Subpages===
As with the general UBC wiki, the practice in making related pages is to use subpages. e.g. [[Library:Microforms]] is a big topical/resource page with related material or parts of this page being created as subpages e.g. [[Library:Microforms/AmericanFiction]]

===Deleting Pages===
Since pages cannot be deleted, the wiki administrator takes care of that. Mark pages for deletion using the template: <nowiki>{{Delete}}</nowiki>

===Categories===
Beyond the home page acting as a portal, categories that are typically being used in the library space has been organized into a kind of hierarchy. Obviously, since the wiki is not a strict child-has-only-one-parent structure, it can become much more complex.

As of April 2011, here's a diagram of how the categories are organized:
[[Image:wiki categories.png|alt=Library space wiki categories organization|890px]]

In most cases (so far), users do not categorize their own pages. Thus, it is up to someone in LSIT to do so. As the library space grows, categories will likely need reorganization/rearrangement (e.g. [[:Category:Library Units]] was only recently created). How that's done is up to the community in essence, but LSIT can provide a basis or direction perhaps for this simply by example. So far, it's really been a "create as needed to group pages or categories" approach. Higher up categories all lead back to the main [[:Category:Library]] allowing users to browse library related categories and pages in a more organized manner.

Currently, uncategorized library space wiki pages are listed using a DPL in the description of [[:Category:Library]] page.

===Future Organization?===
* Categories are generally assigned based on the most specific category (or categories) that are applicable, but users do not always do it this way (e.g. categorizing a page in both "Library Tutorials" and "Finding Library Resources"). So far, this has been left alone, but for better organization, more work may need to be done in explaining to our users best practices.
* So far, categories have only been added to uncategorized pages (i.e. no library related category). However, you would always want ''all'' the related categories to be applied to a wiki page. For example, a user may create a tutorial, such as Searching Web of Science, and categorize it only under their branch, say HSSD. Since this page has a library related category, it no longer shows up on uncategorized. However, this page should also have the category 'Searching Databases' on it for others to find it. More advanced DPL lists could be used to help with this, but this has not been set up as of yet.
* Some library users have also started using more general categories that so far have been considered outside the library's specific use. For example, Nursing, Literature, History, HSS (Humanities and Social Sciences), etc. No work has been done yet in organizing these categories, but for the greater UBC Wiki use, you may want to coordinate with the Wiki Administrator (in CTLT) to help organize these categories.

==Use of Tranclusion==
One of the most appealing parts of the wiki (other than being able to embed it on WordPress and LTK) is the use of template or [http://en.wikipedia.org/wiki/Transclusion transclusion] (or as some refer to it, importing of content, but this term doesn't reflect that it also imports layout/structure).

So far, it has mostly been used for the reuse/redistribution of guidelines and parts of wiki/wordpress tutorials.

In wider library usage, it has mostly been used to create searching tutorials (mostly databases) and then modifying the examples to gear it towards a specific course/topic. For example, here's the test case: [[Sandbox:Library/How_to_Search_Web_of_Science]] as the main template page and then example use case: [[Sandbox:Library/How_to_Search_Web_of_Science_Psychology_Examples]]

===Transclusion of Categories===
When a page is transcluded, normally everything is transcluded including categories. However, there are a couple of categories, particularly 'Library Website', 'Help Site' and 'Services Portal', where this is not desirable (because these categories should only refer to wiki pages that show up on the library website). To prevent something from being transcluded (here it's being used for categories but can eseentially be used for anything), use the <nowiki><noinclude></noinclude></nowiki> tag, literally telling wiki, 'do not include this portion' when transcluding. More detailed information can be found in the [[Help:Templates#Control_template_inclusion|Help Templates article]].

===Future Work===
1. The current [[Help:Templates]] article may be difficult for new wiki users to understand. Consider revising it to make it more understandable for library staff and other new users of UBC wiki.

2. As with preventing library website categories from being transcluded, work could be done in teaching library users that they may want to add the noinclude tag when the branch category is used as well, so that faculty pages for example are not added to their library branch category. Whether is a good idea needs further discussion.

3. Note: what is discussed below is still the same concept of template or transclusion, but here the focus is more on when someone wants to create a "new page" rather than simply changing small bits and pieces of text of an existing page.

One of the things the library can explore is the use of the more traditional sense of a template. That is a pre-set structure (in this case, wiki markup) already in place when someone creates a page. This will give a more uniform look to pages, especially those that might be used on the main library webpage. Good examples where this might be useful are course/user library guides, tutorials on searching resources (e.g. databases) or finding materials. The template may be layout and/or content based.

====Tutorials====
Whereas the current use allows users to make changes to an existing tutorial to fit topically, this is a suggestion for a broader layout template be used for all database tutorials for example, so that they all look similar. Try the Course [[UBC_Wiki:Create_a_New_Page|create a page]] (then preview) as an example. Taking searching databases as an example, there might be a set layout for the database name, interface/vender name (e.g. EBSCO), short description, list of subjects most useful for, link to database, access instructions, librarian contact info, etc. some of which could be in the side box at the top (much like the course template), then have some pre-set markup as a guide, but which is customizable. For example, <pre><nowiki>
==Basic Search==
# Step 1 here [Image:screenshot example.jpg|alt=description here]
# Step 2
#* Note for step 2

==Advanced Search==

==Print/Save/Export/E-mail Citations==

==Staying Current: Saved Searches, E-mail Alerts, & RSS Feeds==

==Other Useful Resources==
* [http://example.com name of website]
* [[Library:example page | name of another wiki page]]</nowiki></pre>

Much like the one for Course pages, obviously, instructions can also be added to the top of the page.

====User Guides====
These two guides for example: [[Library:UBC_Library_Resources]] and [[Library:Library_Resources_for_the_Faculty_of_Arts]] have similar content and layout (as of April 2011). Beyond the fact that these pages have almost identical content and should use transclusion, the layout is similar enough that you might want this layout to be a pre-set template for all user guides.

====Create a page box/form====
If desirable, the wiki administrator will be able to help to set up a "create a page" for the library (much like the Main/Course/Documentation/Sandbox space ones), which can then be added to the library home page (or take a look at the Create a page code).

==Workshops==
So far, workshops have been on request basis, with usually at least a basic workshop for those doing branch migration that see the need for wiki use. However, especially since summer is more quiet around campus, you might consider doing a couple of workshops where you just invite people in, create drop-in sessions (outside of the LSIT area where people can easily reach you), or coordinate with CTLT to sit in their drop-in session announcing to library staff that you will also be available at the same time. Or come up with some other event! Other than basic wiki training, many staff have been interested in templating/transcluding, but do warn them that they need to have basic wiki knowledge first.

==Communications==
Although ideally to communicate about wiki page suggestion/issues are done through the discussion page or the user's talk page, many users do not make use of either (possibly because they are unaware of its function). The best way to discuss something is usually via e-mail, phone, or in person, and then also refer to and/or teach users to use the talk pages.

==Appendix==
Below is what I used to have on my own talk page. It's basically a list of pages that I worked on/created. It's especially useful since many of the in progress/draft ones do not have a category yet, and they are part of the Help Portal migration. Others, such as templates are particularly useful in helping with wiki maintenance.

* [[Library:Home]]

Templates
* [[Template:Update]]
* [[Template:Draft]]
* [[Template:Delete]]
* [[Template:TOC Limit]]

* [[Template:Hanging Indent]]
* [[Template:Citation Example]]
* [[Template:APA Citation]]

Categories
* [[:Category:Library]]
* [[:Category:Library_Tutorials]] with subcategories
** [[:Category:Finding Library Resources]]
** [[:Category:Researching at the Library]]
*** [[:Category:Searching_Databases]] (currently a subcategory of Researching)
* [[:Category:APA Style]]
* [[:Category:Need Updating]] (hidden category)
* [[:Category:EDST]]

'''Services Site pages:'''
* [[:Category:Services Portal]]

'''Help site pages:'''

* [[:Category:Help_Site]]
** [[:Category:Library_User_Guides]]
* [[Library:Help_For_You]]

Borrowing
* [[Library:Borrowing/From_non-UBC_Libraries]]

Finding
* [[Library:How_to_Find_Articles]] - JM

Researching
* [[Library:Course_Specific_Tutorials]] - TR
* [[Library:Searching_Databases]] - Dec 2010, not live on site
* [[Library:Evaluating_Print_Sources]] - approved by AG
* [[Library:Evaluating_Internet_Sources]] - approved by AG

For Learning Commons
* [[Learning_Commons:Chapman_Learning_Commons/APA_Style_Guide]] and [[:Category:APA Style]] from [http://www.library.ubc.ca/pubs/apastyle.pdf Getting Started with APA Style Guide] - documentation needed in creating custom style guide

'''Help Site In Progress:'''

Borrowing
* [[Sandbox:Library/Requesting_from_ASRS]] from [http://www.library.ubc.ca/home/asrs/how-to/ Instructions on Ordering from ASRS]

Finding
* [[Sandbox:Library_Finding_Videos]] from [http://www.library.ubc.ca/home/about/services/gtvid.html Guide to Videos, Films and DVDs]
* [[Sandbox:Library_Finding_Sound_Recordings]] from [http://www.library.ubc.ca/pubs/htfrec.pdf Guide to Sound Recordings] and [http://www.library.ubc.ca/pubs/gtwilson.pdf Guide to Wilson Recordings].
* [[Sandbox:Library/Finding_Maps]] from [http://www.library.ubc.ca/map/mapguide.html Guide to the Map & Atlas Collection], and [http://www.library.ubc.ca/map/mapfaqs.html Map & Atlas Collection FAQ's]
* [[Sandbox:Library/Finding_Microforms]] from [http://www.library.ubc.ca/microfrm/collections.html Microform Collections]
* [[Sandbox:Library/Finding_Newspapers]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=342 Newspapers and News Sources]
* [[Sandbox:Library/Finding_Primary_Sources]] from [http://www.library.ubc.ca/hss/primarysources.html Primary Sources] -> being moved to LTK?
* [[Sandbox:Library/Finding_Theses_and_Dissertations]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=37 FAQ: Dissertations and Theses]
* [[Sandbox:Library/Finding_Book_Film_%26_Theatre_Reviews]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=529 Book, Film, and Theatre Reviews] with A-Z list excluded (which should probably be developed in LTK)

Researching
* [[Sandbox:Library/Getting_Started_with_your_Research_Paper]] from [http://www.library.ubc.ca/home/about/instruct/tp-res.html Term Paper Research: Getting Started]
* [[Sandbox:Library/Finding_the_Right_Sources_for_Literature_Review]] from [http://toby.library.ubc.ca/webpage/webpage.cfm?id=502 Finding the Right Information Sources For a Literature Review] - page best done with some parts on seperate pages or merged with existing pages and transcluding those sections
* [[Sandbox:Library/How_to_Search_Web_of_Science]] from [http://www.library.ubc.ca/life/instruction/pubs/webofscience.pdf How to Search Web of Science] - parameters added, Example [[Sandbox:Library/How_to_Search_Web_of_Science_Psychology_Examples]]
* [[Sandbox:Library/How_to_Search_PubMed]] is not [http://www.library.ubc.ca/life/instruction/pubs/pubmed.pdf How to Search PubMed]
* Searching the Web -> http://www.library.ubc.ca/home/websearch/quick.html

'''Ever changing test page:'''
* [[Sandbox:Library_Test_Page]] Currently dpl of pages that might need maintenance

'''Documentation:'''
* Parts of [[Help:Contents]]
* [[Library:When_to_Use_the_Wiki]]
* [[Help:Guidelines]]
* [[Library:Learn_to_Use_the_Wiki]] / [[Library:Wiki_Tutorial]]
* [[Help:Tutorial]]
* [[Help:Wiki_to_WordPress]]

User:CynthiaNg/Books/Library Book Example

2011-04-19T20:51:10Z

CynthiaNg: Created page with "{{saved_book}} == Library Book == === Example === ;Chapter 1: Help Portal :Library:Help Portal Wiki Pages :Library:Summon ;Chapter 2: Researching :[[Library:Academic Int..."

{{saved_book}}

== Library Book ==
=== Example ===
;Chapter 1: Help Portal
:[[Library:Help Portal Wiki Pages]]
:[[Library:Summon]]
;Chapter 2: Researching
:[[Library:Academic Integrity]]
:[[Library:Course Specific Tutorials]]
:[[Library:Evaluating Internet Sources]]
:[[Library:Evaluating Print Sources]]
:[[Library:Evaluating Types of Materials]]
:[[Library:Evaluating Types of Sources]]
:[[Library:Getting Started with your Research Paper]]
:[[Library:Library Research Skills For Biologists]]
:[[Library:Searching Databases]]
:[[Library:How to Cite Sources]]

[[Category:Books|Library Book Example]]

Category:Library

2011-04-19T20:13:00Z

CynthiaNg: changed format

This is the category for articles relating to the UBC Library that are very general and would not fit elsewhere. Please use a subcategory instead when applicable or create a new subcategory if it is something that would be commonly used.

==Needs a Category!==
<dpl>
columns = 3
namespace = Library
notcategory = Candidates for deletion
notcategory = Circle
notcategory = DESC
notcategory = DigInit
notcategory = Digi-group
notcategory = Events_(Library)
notcategory = Finding Library Resources
notcategory = HSSD
notcategory = UBC Law Library
notcategory = LTK
notcategory = Help Site
notcategory = Library
notcategory = Library Faculty Arts Guides
notcategory = Library CTLT Guides
notcategory = Library Units
notcategory = Library User Guides
notcategory = Library Tutorials
notcategory = Microforms
notcategory = Primary Sources
notcategory = Researching at the Library
notcategory = Searching Databases
notcategory = Services Portal
notcategory = SciEng Library
notcategory = Sutherland
notcategory = UBC Library Staff
notcategory = UBC Wiki
notcategory = TLAC
notcategory = Wimba
shownamespace = false
</dpl>

Category:Library

2011-04-19T20:07:57Z

CynthiaNg: added dpl

This is the category for articles relating to the UBC Library that are very general and would not fit elsewhere. Please use a subcategory instead when applicable or create a new subcategory if it is something that would be commonly used.

'''Needs a Category!'''
<dpl>
columns = 3
namespace = Library
notcategory = Candidates for deletion
notcategory = Circle
notcategory = DESC
notcategory = DigInit
notcategory = Digi-group
notcategory = Events_(Library)
notcategory = Finding Library Resources
notcategory = HSSD
notcategory = UBC Law Library
notcategory = LTK
notcategory = Help Site
notcategory = Library
notcategory = Library Faculty Arts Guides
notcategory = Library CTLT Guides
notcategory = Library Units
notcategory = Library User Guides
notcategory = Library Tutorials
notcategory = Microforms
notcategory = Primary Sources
notcategory = Researching at the Library
notcategory = Searching Databases
notcategory = Services Portal
notcategory = SciEng Library
notcategory = Sutherland
notcategory = UBC Library Staff
notcategory = UBC Wiki
notcategory = TLAC
notcategory = Wimba
shownamespace = false
</dpl>

Library:Education Branch Widget

2011-04-19T20:04:37Z

CynthiaNg: marked for deletion

Library:Help Portal Wiki Pages

2011-04-19T19:50:40Z

CynthiaNg: separated services

Links to the wiki pages corresponding to the [http://help.library.ubc.ca/ Help Portal] and [http://services.library.ubc.ca/ Services Portal] part of the [http://www.library.ubc.ca Library website]. Pages are grouped as on the Services or Help site, and the pages are listed in alphabetical order.

==Help Site==
'''Help For...''' guides located on the [http://help.library.ubc.ca/help-for Help Portal]
<dpl>
category = Help Site
category = Library User Guides
shownamespace = false
ordermethod = sortkey
</dpl>

'''Borrowing'''
<dpl>
category = Help Site
notcategory = Candidates for deletion
titlematch = Borrowing/%
shownamespace = false
ordermethod = sortkey
</dpl>

'''Finding'''
<dpl>
category = Help Site
category = Finding Library Resources
shownamespace = false
ordermethod = sortkey
</dpl>

'''Researching'''
<dpl>
category = Help Site
category = Researching at the Library
shownamespace = false
ordermethod = sortkey
</dpl>

[[Category:Help Site]]

Library:Home

2011-04-19T19:49:58Z

CynthiaNg: added link

{{TOC Limit|limit=2}}
==Library Pages in the Wiki==


*[[:Category:Library|All Library Pages]]
*[[Library:Branches|Branches]]
*[[Library:Committee_Pages|Committees and Groups]]
*[[Library:Help_Portal_Wiki_Pages|Help Portal Wiki Pages]]
*[[Library:Services_Portal_Wiki_Pages|Services Portal Wiki Pages]]
*[[Library:Instructional_Materials|Instructional Materials]]
*[[Library:Learn_to_Use_the_Wiki|Learn to Use the Wiki]]
*[[Library:LTK_Manual|LTK Manual]]

==Wiki Guidelines==
{{Help:Guidelines
|namex=.
|organizex=Any pages created for library staff use should be in the Library namespace. Make sure your page is prefixed with "Library:", such as wiki.ubc.ca/Library:Example_page. If you have a lot of pages related to a topic, you should make subpages for the related pages by adding a forward slash, such as wiki.ubc.ca/Library:Example_page/my_related_page.
|leavex=Pages in the Library namespace can be edited by any library staff.
|catex=To help keep the Library space organized, you should '''always add''' at least one category, usually your branch or the topic (e.g. [[:Category:Finding Library Resources]]), and new library categories should be added to to [[:Category:Library]].}}

{{Library:When_to_Use_the_Wiki}}

[[Category:Library]]

Library:Help For You

2011-04-19T19:48:50Z

CynthiaNg: moved Library:Help For You to Library:Help Portal Wiki Pages

#REDIRECT [[Library:Help Portal Wiki Pages]]

Library:Help Portal Wiki Pages

2011-04-19T19:48:50Z

CynthiaNg: moved Library:Help For You to Library:Help Portal Wiki Pages

2011-04-18T20:53:09Z

CynthiaNg:

File:Wiki categories.png

2011-04-18T19:50:28Z

CynthiaNg: uploaded a new version of "File:Wiki categories.png": space cropped out

wiki categories Library space organization as of April 2011

Library:Wiki Documentation

2011-04-18T17:54:40Z

CynthiaNg:

Perhaps the best way to start is from the [[Library:Home]] page.

==Library:Home==
The home page acts as a front or portal page to other pages as well as where we have displayed our wiki guidelines and guidelines on the use of the wiki. These guidelines fluctuate as the use of the various tools grow and discussions happen surrounding related issues.

===Library Home Pages===
As you can see, there are a few pages that have been created under which any library wiki page should be able to fit. The idea is that wiki pages in the library space can be easily found if it is properly categorized. Here are a couple of quick notes on the purpose of each page and how it's created.
*[[:Category:Library|All Library Pages]] - goes to the Library category page, which is the top level of the hierarchy (see below for further explanation)
*[[Library:Branches|Branches]] - page where a dpl has been created for each library branch that currently have their own category (i.e. many branches do not)
*[[Library:Committee_Pages|Committees and Groups]] - this is a manual list linking to the committee or group's "home" page
*[[Library:Help_For_You|Help & Services Portal]] - made with dpl lists. Help is divided into the various categories as organized on the actual [http://help.library.ubc.ca Help Portal], but Services is just one category as there are only a few pages that are fed from the wiki
*[[Library:Instructional_Materials|Instructional Materials]] - dpl list of various categories related to tutorials/instructional content in the library space
*[[Library:Learn_to_Use_the_Wiki|Learn to Use the Wiki]] - links to the library version of the using [[Help:Tutorial|wiki tutorial]]. As there is also a [[Library:WordPress_and_Wiki_Tutorial]] now, some consideration might go into having a page that lists wiki/wordpress/ltk/other(?) tutorials that are created by LSIT folks as well as a list of tutorials created by other UBC areas, such as [[Documentation:WordPress_Basics]]
*[[Library:LTK_Manual|LTK Manual]] - as the name suggests, link to the LTK user manual

==Library Space Organization==
===Subpages===
As with the general UBC wiki, the practice in making related pages is to use subpages. e.g. [[Library:Microforms]] is a big topical/resource page with related material or parts of this page being created as subpages e.g. [[Library:Microforms/AmericanFiction]]

===Categories===
Beyond the home page acting as a portal, categories that are typically being used in the library space has been organized into a kind of hierarchy. Obviously, since the wiki is not a strict child-has-only-one-parent structure, it can become much more complex.

As of April 2011, here's a diagram of how the categories are organized:
[[Image:wiki categories.png|alt=Library space wiki categories organization|890px]]

In most cases (so far), users do not categorize their own pages. Thus, it is up to someone in LSIT to do so. As the library space grows, categories will likely need reorganization/rearrangement (e.g. [[:Category:Library Units]] was only recently created). How that's done is up to the community in essence, but LSIT provides a basis or direction perhaps for this. So far, it's really been a "create as needed to group pages or categories" approach. Higher up categories all lead back to the main [[:Category:Library]] allowing users to browse library related categories and pages in a more organized manner.

===Future Organization?===
Categories are generally assigned based on the most specific category (or categories) that are applicable, but users do not always do it this way (e.g. categorizing a page in both "Library Tutorials" and "Finding Library Resources"). So far, this has been left alone, but for better organization, more work may need to be done in explaining to our users best practices.

Some library users have also started using more general categories that so far have been considered outside the library's specific use. For example, Nursing, Literature, History, HSS (Humanities and Social Sciences), etc. No work has been done yet in organizing these categories, but for the greater UBC Wiki use, you may want to coordinate with the Wiki Administrator (in CTLT) to help organize these categories.

==Use of Templates==
One of the most

==Workshops==
So far, workshops have been on request basis, with usually at least a basic workshop for those doing branch migration that see the need for wiki use. However, especially since summer is more quiet around campus, you might consider doing a couple of workshops where you just invite people in, create drop-in sessions (outside of the LSIT area where people can easily reach you), or coordinate with CTLT to sit in their drop-in session announcing to library staff that you will also be available at the same time. Or come up with some other event! Other than basic wiki training, many staff have been interested in templating/transcluding, but do warn them that they need to have basic wiki knowledge first.

==Communications==
Although ideally to communicate about wiki page suggestion/issues, the discussion page or the user's talk page is used, many users do not make use of either. The best way to discuss something is usually via e-mail, phone, or in person.

Library talk:Writing Group

2011-04-18T17:39:26Z

CynthiaNg: Talk page autocreated when first thread was posted.

Thread:Library talk:Writing Group/Category?

2011-04-18T17:39:26Z

CynthiaNg: New thread: Category?

Please add a category for your page. If the working group is part of a committee, please consider using the appropriate committee category found in [[:Category:Library Units]]. If none are appropriate, please consider creating a new one or using "Library Units". Thanks!

Library:Microforms/AmericanFiction

2011-04-18T17:35:54Z

CynthiaNg: added category

*'''[http://resolve.library.ubc.ca/cgi-bin/catsearch?bid=668876%20 American Fiction, 1774-1900]'''

:Based on Wright's bibliography, this set includes novels, romance, short stories, fictitious biographies, travels and sketches, allegories, and tract-like tales. While the major American authors are all represented, a strength of the collection is the inclusion of the writings of minor and lesser-known authors.

:Guide: Microform Guides cabinet, Koerner Library, Floor 2.

:[http://webcat2.library.ubc.ca/vwebv/search?searchArg=ZPS+371+W9+1969+&searchCode=CALL%2B&limitTo=none&recCount=10&searchType=1&page.search.search.button=Search Bibliography (Wright)]

:[http://microformguides.gale.com/SearchForm.asp Search Collection Online]

[[Category:Microforms]]
[[Category:HSS]]
[[Category:Literature]]
[[Category:HSSD]]

Library:Microforms

2011-04-18T17:35:14Z

CynthiaNg: changed to using transclusion, since info is duplicated

{{Library:Microforms/AmericanFiction}}

[[Category:Microforms]]
[[Category:HSS]]

File:Wiki categories.png

2011-04-18T16:57:05Z

CynthiaNg: uploaded a new version of "File:Wiki categories.png": fixed diagram

wiki categories Library space organization as of April 2011

Library:When to Use the Wiki

2011-04-14T18:59:10Z

CynthiaNg: /* For LTK */

==When to Use the Wiki==
These guidelines are still in flux as the Library website continues to be developed, but these general guidelines should help you decide when to use the wiki, wordpress, or the Library Toolkit (LTK).

===For the Wiki===
The wiki is likely best for pages where you answer yes to one or more of the following questions:
* Is this a general topic (not specific to a subject or branch)?
* Would you or others like to create a PDF of the information?
* Would multiple people have something useful to contribute?
* Are you collaborating with others?
* Does this page need to be updated frequently?
* Do multiple people/branches want to use more or less the same content?

Examples: How to... pages, such as "How to Find Newspapers" or "How to Search Databases". Note that templates can be made so that all the instructions are the same, but examples can be modified to fit specific subject areas.

===For LTK===

Similar to the toby Subject Guide, the new LTK is designed basically for Subject (e.g. Education), Topic (e.g. Building Codes/Standards), and Course Guides, which is specialized content. Generally, if you are providing a list of useful resources, then you should be using the LTK. The LTK is also being used for Faculty Publications lists. The [http://guides.library.ubc.ca/ Research Guides Portal] is the current access point for all published guides in LTK (and toby until they've all been migrated).

The big advantage to listing resources in the LTK is the integration with infopages. On the other hand, if you want the list of resources to be available through two or more of wiki, wordpress, and LTK, then you might consider putting it into the wiki as it can then be pulled into all three.

===For WordPress===
Remember that wiki pages can be displayed as a WordPress (WP) page. If you are planning to use a wiki page in a WordPress site, remember that WordPress will do the styling for you, so you don't have to do it yourself.

You should use WordPress for any:
* Blogs
* News & Announcement pages
* Static (non-changing) content pages needing very restricted access (only editors of the WP site can edit the page)

A reminder that Library space wiki pages are viewable by the public, but editing is restricted to library staff only. By "very restricted access", this refers to material that is sensitive and should not be edited by anyone aside from 1-2 people in a particular department.

[[Category:Guidelines]]
[[Category:Library]]

Sandbox:Library Test Page

2011-04-14T18:44:44Z

CynthiaNg: added category

{| class="wikitable sortable"
|-
! Header text !! Header text !! Header text
|-
| Example || Example || Example
|-
| Example || Example || Example
|-
| Example || Example || Example
|-
| Example || Example || Example
|}

{| class="wikitable"
|-
! Header text !! Header text !! Header text
|-
| Example || Example || Example
|-
| Example || Example || Example
|-
| Example || Example || Example
|-
| Example || Example || Example
|}

'''Need Category?'''
<dpl>
columns = 3
namespace = Library
notcategory = Candidates for deletion
notcategory = Circle
notcategory = DESC
notcategory = DigInit
notcategory = Digi-group
notcategory = Events_(Library)
notcategory = Finding Library Resources
notcategory = HSSD
notcategory = UBC Law Library
notcategory = LTK
notcategory = Help Site
notcategory = Library
notcategory = Library Faculty Arts Guides
notcategory = Library CTLT Guides
notcategory = Library Units
notcategory = Library User Guides
notcategory = Library Tutorials
notcategory = Microforms
notcategory = Primary Sources
notcategory = Researching at the Library
notcategory = Searching Databases
notcategory = Services Portal
notcategory = SciEng Library
notcategory = Sutherland
notcategory = UBC Library Staff
notcategory = UBC Wiki
notcategory = TLAC
notcategory = Wimba
shownamespace = false
</dpl>

this is to test [[Library:Help_for_Graduate_Students]] should go to the help site
and this is to test internal linkage [[Help:Guidelines]] should go to Borrowing from Other Libraries page even if that's not what it's about.

what happens if I link to a subpage article [[Sandbox:Library/How_to_Find_Articles]]

==Header 2==
with text after
* and
* a list
** with a sub
** list
* continued list
and text after

===Header 3===
* with
* a list

====Header 4====
with just regular text
* and
* a list

====Header 5====
blank

===Header 3===
more headers!

Library:Committee Pages

2011-04-14T18:44:17Z

CynthiaNg: changed category

Please use the Staff Intranet or SharePoint for internal committees and groups. Only those involving members outside of the library, such as faculty, should be added here. If necessary, to request a library staff committee site, please the [http://helpdesk.library.ubc.ca/lsit/web-services-support/ Web Request Form].

==Committees==
*[[Library:Distance Education Services Committee|DESC (Distance Education Services Committee)]]
*[[Library:SciEng_LAC|Science & Engineering Library Advisory Committee]]
*[[Library:TLAC|TLAC (Teaching and Learning Advisory Committee)]]

==Groups==
*[[Library:Digi-group_Summer_Sessions_2010]]

[[Category:Library Units]]