Documentation: Add kids catalog documentation from ESI site.

Signed-off-by: Robert Soulliere <robert.soulliere@mohawkcollege.ca>

diff --git a/docs/media/Kids_OPAC1.jpg b/docs/media/Kids_OPAC1.jpg
new file mode 100644 (file)
index 0000000..847bbb5
Binary files /dev/null and b/docs/media/Kids_OPAC1.jpg differ

diff --git a/docs/media/Kids_OPAC11.jpg b/docs/media/Kids_OPAC11.jpg
new file mode 100644 (file)
index 0000000..d3ed5bf
Binary files /dev/null and b/docs/media/Kids_OPAC11.jpg differ

diff --git a/docs/media/Kids_OPAC12.jpg b/docs/media/Kids_OPAC12.jpg
new file mode 100644 (file)
index 0000000..7255464
Binary files /dev/null and b/docs/media/Kids_OPAC12.jpg differ

diff --git a/docs/media/Kids_OPAC13.jpg b/docs/media/Kids_OPAC13.jpg
new file mode 100644 (file)
index 0000000..1693ad1
Binary files /dev/null and b/docs/media/Kids_OPAC13.jpg differ

diff --git a/docs/media/Kids_OPAC14.jpg b/docs/media/Kids_OPAC14.jpg
new file mode 100644 (file)
index 0000000..3c0214b
Binary files /dev/null and b/docs/media/Kids_OPAC14.jpg differ

diff --git a/docs/media/Kids_OPAC15.jpg b/docs/media/Kids_OPAC15.jpg
new file mode 100644 (file)
index 0000000..a483c16
Binary files /dev/null and b/docs/media/Kids_OPAC15.jpg differ

diff --git a/docs/media/Kids_OPAC16.jpg b/docs/media/Kids_OPAC16.jpg
new file mode 100644 (file)
index 0000000..33cce3d
Binary files /dev/null and b/docs/media/Kids_OPAC16.jpg differ

diff --git a/docs/media/Kids_OPAC17.jpg b/docs/media/Kids_OPAC17.jpg
new file mode 100644 (file)
index 0000000..c7c845b
Binary files /dev/null and b/docs/media/Kids_OPAC17.jpg differ

diff --git a/docs/media/Kids_OPAC2.jpg b/docs/media/Kids_OPAC2.jpg
new file mode 100644 (file)
index 0000000..aebcdfe
Binary files /dev/null and b/docs/media/Kids_OPAC2.jpg differ

diff --git a/docs/media/Kids_OPAC4.jpg b/docs/media/Kids_OPAC4.jpg
new file mode 100644 (file)
index 0000000..9b14495
Binary files /dev/null and b/docs/media/Kids_OPAC4.jpg differ

diff --git a/docs/media/Kids_OPAC5.jpg b/docs/media/Kids_OPAC5.jpg
new file mode 100644 (file)
index 0000000..61b6c3a
Binary files /dev/null and b/docs/media/Kids_OPAC5.jpg differ

diff --git a/docs/media/Kids_OPAC6.jpg b/docs/media/Kids_OPAC6.jpg
new file mode 100644 (file)
index 0000000..3bf605b
Binary files /dev/null and b/docs/media/Kids_OPAC6.jpg differ

diff --git a/docs/media/Kids_OPAC7.jpg b/docs/media/Kids_OPAC7.jpg
new file mode 100644 (file)
index 0000000..604c76b
Binary files /dev/null and b/docs/media/Kids_OPAC7.jpg differ

diff --git a/docs/media/Kids_OPAC8.jpg b/docs/media/Kids_OPAC8.jpg
new file mode 100644 (file)
index 0000000..d8b2f08
Binary files /dev/null and b/docs/media/Kids_OPAC8.jpg differ

diff --git a/docs/media/Kids_OPAC9.jpg b/docs/media/Kids_OPAC9.jpg
new file mode 100644 (file)
index 0000000..8754a8c
Binary files /dev/null and b/docs/media/Kids_OPAC9.jpg differ

diff --git a/docs/opac/kids_opac.txt b/docs/opac/kids_opac.txt
new file mode 100644 (file)
index 0000000..4a65a5f
--- /dev/null
+++ b/docs/opac/kids_opac.txt
@@ -0,0 +1,201 @@
+Kids OPAC\r
+---------\r
+\r
+The Kids OPAC (KPAC) is a public catalog search that was designed for children \r
+and teens.  Colorful menu items,large buttons, and simple navigation make this \r
+an appealing search interface for kids.  Librarians will appreciate the flexible \r
+configuration of the KPAC.  Librarians can create links to canned search results \r
+for kids and can apply these links by branch.  The KPAC uses the same infrastructure \r
+as the Template Toolkit OPAC (TPAC), the adult catalog search, so you can easily \r
+extend the KPAC using the code that already exists in the TPAC.  Finally, third \r
+party content, such as reader reviews, can be integrated into the KPAC.\r
+\r
+Choose a Skin\r
+~~~~~~~~~~~~~\r
+\r
+Two skins, or design interfaces, have been created for the KPAC.  The KPAC was \r
+designed to run multiple skins on a single web server.  A consortium, then, could \r
+allow each library system to choose a skin for their patrons.\r
+\r
+\r
+*Monster Skin:*\r
+\r
+\r
+In this skin, the search bar shares the top panel with a playful monster.  The \r
+search grid appears beneath the search bar.  Help and Login links appear in bold \r
+colors at the top right of the interface although you can customize these with CSS.  \r
+After you login, the Login button disappears.\r
+\r
+image::media/Kids_OPAC2.jpg[Kids_OPAC2]\r
+\r
+\r
+*Alternate Skin:*\r
+\r
+In this skin, the search bar is the focal point of the top panel and is centered \r
+on the screen.  The search grid appears beneath the search bar.  Help and Login \r
+links appear at the top right of the interface. You can customize the appearance \r
+and position of these links with CSS.  After you login, the user name is displayed \r
+in the top right corner, and the Login link becomes an option to Logout.\r
+\r
+image::media/Kids_OPAC1.jpg[Kids_OPAC1]\r
+\r
+\r
+Search the Catalog\r
+~~~~~~~~~~~~~~~~~~\r
+\r
+You can search the catalog using only the search bar, the search grid, or the search \r
+bar and the collection drop down menu.\r
+\r
+\r
+*Search using the Search Bar*\r
+\r
+To search the catalog from the home page, enter text into the search bar in the \r
+center of the main page, or enter text into the search bar to the right of the \r
+results on a results page.  Search indices are configurable, but the default search \r
+indices include author, title and (key)word.\r
+\r
+You can use this search bar to search the entire catalog, or, using the configuration \r
+files, you can apply a filter so that search queries entered here retrieve records \r
+that meet specific criteria, such as child-friendly copy locations or MARC audience \r
+codes. \r
+\r
+\r
+*Search using the Grid*\r
+\r
+From the home page, you can search the catalog by clicking on the grid of icons.  \r
+An icon search can link to an external web link or to a canned search.  For example, \r
+the icon, Musical Instruments, could link to the results of a catalog search on \r
+the subject heading, Musical instruments.  \r
+\r
+The labels on the grid of icons and the content that they search are configurable \r
+by branch.  You can use the grid to search the entire catalog, or, using the \r
+configuration files, you can apply a filter so that search queries entered here \r
+retrieve records associated with specific criteria, such as child-friendly copy \r
+locations or MARC audience codes.\r
+\r
+\r
+image::media/Kids_OPAC4.jpg[Kids_OPAC4]\r
+\r
+\r
+You can add multiple layers of icons and searches to your grid:\r
+\r
+\r
+image::media/Kids_OPAC5.jpg[Kids_OPAC5]\r
+\r
+\r
+\r
+*Search using the Search Bar and the _Collection_ Drop Down Menu*\r
+\r
+On the search results page, a search bar and drop down menu appear on the right \r
+side of the screen.  You can enter a search term and into the search bar and select \r
+a collection from the drop down menu to search these configured collections.  \r
+Configured collections might provide more targeted searching for your audience \r
+than a general catalog search.  For example, you could create collections by shelving \r
+location or by MARC audience code.  \r
+\r
+\r
+image::media/Kids_OPAC17.jpg[Kids_OPAC17]\r
+\r
+\r
+Using any search method, the search results display in the center of the screen.  \r
+Brief information displays beneath each title in the initial search result.  The \r
+brief information that displays, such as title, author, or publication information, \r
+is configurable.\r
+\r
+\r
+image::media/Kids_OPAC6.jpg[Kids_OPAC6]\r
+\r
+\r
+For full details on a title, click *More Info*.  The full details displays the \r
+configured fields from the title record and copy information.  Click *Show more \r
+copies* to display up to fifty results.  Use the breadcrumbs at the top to trace \r
+your search history.\r
+\r
+\r
+image::media/Kids_OPAC7.jpg[Kids_OPAC7]\r
+\r
+\r
+\r
+Place a Hold\r
+~~~~~~~~~~~~\r
+\r
+From the search results, click the *Get it!* link to place a hold.\r
+\r
+\r
+image::media/Kids_OPAC11.jpg[Kids_OPAC11]\r
+\r
+\r
+The brief information about the title appears, and, if you have not yet logged in, \r
+the *Get It!* panel appears with fields for username and password.  Enter the username \r
+and password, and select the pick up library. Then click *Submit*.  If you have \r
+already logged into your account, you need only to select the pick up location, \r
+and click *Submit*.\r
+\r
+\r
+image::media/Kids_OPAC12.jpg[Kids_OPAC12]\r
+\r
+\r
+A confirmation of hold placement appears.  You can return to the previous record \r
+or to your search results.\r
+\r
+\r
+image::media/Kids_OPAC13.jpg[Kids_OPAC13]\r
+\r
+\r
+\r
+Save Items to a List\r
+~~~~~~~~~~~~~~~~~~~~\r
+\r
+You can save items to a temporary list, or, if you are logged in, you can save to \r
+a list of your own creation.  To save items to a list, click the *Get it* button \r
+on the Search Results page.\r
+\r
+\r
+image::media/Kids_OPAC14.jpg[Kids_OPAC14]\r
+\r
+\r
+Select a list in the *Save It!* panel beneath the brief information, and click *Submit*.\r
+\r
+\r
+image::media/Kids_OPAC16.jpg[Kids_OPAC16]\r
+\r
+\r
+A confirmation of the saved item appears. To save the item to a list or to manage \r
+the lists, click the *My Lists* link to return to the list management feature in \r
+the TPAC. \r
+\r
+\r
+image::media/Kids_OPAC15.jpg[Kids_OPAC15]\r
+\r
+\r
+\r
+Third Party Content\r
+~~~~~~~~~~~~~~~~~~~\r
+\r
+Third party content, such as reader reviews, can be viewed in the Kids OPAC. The \r
+reviews link appears adjacent to the brief information.\r
+\r
+image::media/Kids_OPAC8.jpg[Kids_OPAC8]\r
+\r
+\r
+Click the Reviews link to view reader reviews from a third party source. The reader \r
+reviews open beneath the brief information.\r
+\r
+\r
+image::media/Kids_OPAC9.jpg[Kids_OPAC9]\r
+\r
+\r
+Summaries and reviews from other publications appear in separate tabs beneath the \r
+copy information.\r
+\r
+\r
+image::media/Kids_OPAC10.jpg[Kids_OPAC10]\r
+\r
+Configuration Files\r
+~~~~~~~~~~~~~~~~~~~\r
+\r
+Configuration files allow you to define labels for canned searches in the icon \r
+grid, determine how icons lead users to new pages, and define whether those icons \r
+are canned searches or links to external resources.  Documentation describing how \r
+to use the configruation files is available in the Evergreen respository.\r
+\r

diff --git a/docs/root.txt b/docs/root.txt
index fa48c6d..c6a0ac9 100644 (file)
--- a/docs/root.txt
+++ b/docs/root.txt
@@ -287,6 +287,8 @@ Use this part for information about searching the Evergreen public access catalo
 
 include::opac/my_lists.txt[]
 
+include::opac/kids_opac.txt[]
+
 Developer Resources
 ===================