Svengali
Version 1.0
Copyright © 2010 by Gregarious Frog

Overview

Svengali is a adjuct to the Erotic Mind-Control Story Archive (EMCSA) website. It functions as a window through which to view the EMCSA with additional functionality, such as collaborative tagging of stories and search capabilities. Neither this utility nor gregariousfrog.com are affiliated with the EMCSA.
The utility functions best when it is personalized to your Preferences (see below). In addition, the more people use it, the smarter it will become. So please, take the time to Tag stories when you can; everyone benefits when you do. Please be courtious and respect the community; the Tag changes that you make can be seen by everyone.
Please note that this is the 1.0 version, so quirky behaviour may occur. At this stage of development, Svengali has been tested on the latest versions of Internet Explorer, Firefox, Chrome and Safari. Please direct comments, requests and rants to Frog.

Getting Started

The tool is designed to be unobtrusive and initially appears as a thin blue bar on the right-hand side of your browser window. Click on the bar to open the workspace; click again on the blue section to hide it.
As you navigate through the EMCSA, Svengali will display additional information in the workspace. Try it now by navigating to a story that you like (using the links on the EMCSA page as you normally would). When you reach the story's title page, you will see a Tags tab appear in the workspace, displaying a preference gauge and information about the Tags attached to the story. Allowing the cursor to linger over a Tag will display a brief description of the Tag. See the Title Tab section for more information.
Now click on the link to take you to the actual story text. The workspace will then show you the Tags attached to the story, or Chapter, if it is a multi-chapter story. You are also now able to manipulate the Tags associated with the story (see the Chapter Tab section for more information). Tagging stories and chapters is the heart of Svengali. The more accurate the tagging, the more useful the tool, so Tag where you can.
In addition to information about stories, the tool also provides a number of ways to search for what you are interested in; take a look at the Main Toolbar section for the options available to you.

The Main Toolbar

The buttons on the main toolbar are aways visible, unless you navigate away from mcstories.com, and may be used at any time.
Go to the Last Read Story. This button will immediately take you to the text of the last story that you read.
Find Stories with Specific Tags. This option will bring display the Search for Stories with Tags dialog, which enables you to find stories with whatever combination of Tags you desire. Please note that unless someone has actually tagged a story with a particular tag, you won't be able to find it. This is why it is important to tag as you go; it only takes a small amount effort and everyone benefits.
Find Words and Phrases in Stories. Search story texts for words and phrases that interest you.
Find Stories I Would Like. If you have already indicated some Preferences, then this button will recommend the top 100 stories that best suit you.
Settings. Brings up the Settings dialog, enabling you to customize certain aspects of the tool.
Help. Displays this page; but you probably knew that.

The Title Tab

When you navigate to an EMCSA Title page, the Title tab appears in the workspace. It displays a preference gauge to provide a visual indication of your likely reaction to the story, as well as a hierarchy of the accumulated Tags associated with the Title, i.e. all of its Chapters, in the case of a multi-part story. Tags on the Title tab cannot be modified; they may only be manipulated on the Chapter tab. However, you are still able to indicate your Preferences (by right-clicking on Tags).
There is a single toolbar option:
More Like This. This option will search for other stories that have the same or similar Tag assignments and display the results on the Search tab. If you want to search for a particular combination of Tags, then use the Search on Tags button on the main toolbar.

The Chapter Tab

When you navigate to an EMCSA Chapter page, the Chapter tab appears in the workspace. If the story consists of multiple parts, then the Title tab will also appear (to show the accumulated Tags). The Chapter tab displays a preference gauge to provide a visual indication of your likely reaction to the Chapter, as well as the associated hierarchy of Tags. At this point, you are able to assign or remove Tags (see Assigning Tags).
There are a few toolbar options:
Copy the Previous Chapter's Tags. This option enables you to copy the Tags from the previous Chapter. It will only appear in a multi-part story, if the current Chapter has no Tags and a previously tagged Chapter exists.
Tags Are Locked. This icon will appear if the Chapter has been locked by the Author or a Moderator. If this is the case then you will not be able to manipulate the Chapter's Tags.
More Like This. This option will search for other Titles that have the same or similar Tag assignments and display the results on the Search tab. This is the same functionality as the option on the Title tab. If you want to search for a different combination of Tags, then use the Search for Stories with Tags button on the main toolbar.

Assigning Tags

Tags may only be assigned in the Chapter Tab (see above). To add or remove a Tag, simply click on the Tag name; assigned Tags are highlighted in bold. Tags are organized in a hierarchy, and selecting a master level Tag will unselect those beneath it. Master level Tags are therefore only relevant when there is no appropriate child Tag. Some Tags are hierarchy placeholders (indicated by the symbol) and cannot be assigned. By default, the Chapter tab will show only the assigned Tags. This may be toggled by means of the Assigned Only checkbox, displaying or hiding the entire Tag list.

Preferences

In order to personalize your experience (and enable the use of preference gauges and the Stories I Would Like search), you may wish to assign preferences to individual Tags. This can be done in the Title or Chapter tabs (in the Chapter tab, it is useful to first display the full Tag list by unchecking the Assigned Only checkbox). Simply right-click on a Tag and a menu displaying the Preference options will appear. Select the feelings that you have towards this particular Tag and your preference will be set, with the color of Tag bullet changing to remind you. After you have set a few Preferences, you should see the preference gauges reflecting your Preferences. Note that for privacy reasons, your preferences are stored locally in a cookie. This does mean that if you typically access Svengali by using your browsers Private Bowsing mode, then your Preferences cookie will be discarded when you end your private browsing session. An option to persist preferences on the database will be added in a future version.

Search for Stories with Tags

When the Search for Stories with Tags option is selected, a dialog is displayed. On the right side is a full list of available Tags, while the left side displays those Tags that you have selected to participate in the search. You may also choose to filter the display of available tags by using the filters checkboxes to show or hide Tags corresponding to a particular Preference, or to limit the available Tags to the standard EMCSA tags.
To build your criteria, simply click on Tags to select or unselect. Select individual Tags for a refined search, or master-level Tags for a more generalized search. When you are satisfied, click on the Search button, or click Cancel to abort. The results of your search will be displayed on the Search Tab.

Search Stories for Text

When the Search Stories for Text option is selected, a dialog is displayed. Enter the word or phrase that you would like to find and click the Search button. If you would like to search on multiple words and/or phrases then click the button to add the word or phrase to the criteria list. To remove a word from the criteria list, simply click on it. When you have finished building your criteria, click the Search button to start the search. The results will be displayed on the Search Tab.

Search Results

Search results are displayed on the Search tab. The upper section contains an indication of the type of search and, in most cases, moving the cursor over the text will reveal additional information. Titles are color-classified according to the EMCSA standard and arranged in descending order of relevance. With some searches, a percentage match will be displayed to tell you how accurately the result matches your criteria. Only the first 100 results will be displayed, so if you did not find what you are looking for, it may help to refine your search criteria. Once it appears, the Search tab will linger, though starting another search will clear out the old results.

Settings

The Settings dialog enables you to further personalize the tool. Note that settings are stored in a cookie, so clearing your browser cache or using a browsers Private Browsing mode, will result in your preferences being discarded along with cookie. The following settings are available:
Display Neutral on Preference Gauges: This settings determines whether or not a section is included on preference gauges for those Tags marked as neutral preference.

Glossary

Chapter A episode of a story, as defined by the EMCSA site structure. The description is not entirely accurate as many stories consist of only one Chapter or, in some cases, a Chapter may actually contain multiple parts of the story. The division of a story into Chapters is entirely the result of the story author's preference. The term is used here in the context of "a part of the story that actually contains the words you're interested in". Tags may be attached to a Chapter in order to indicate aspects of interest.
Preference An indication of how you feel about a particular Tag. Used to display a color-coded preference gauge on the Title and Chapter tabs, as well as to recommend stories when using the Stories I Would Like search. Preferences may be specified as Really Like, Like, Curious, Neutral, Dislike, Really Dislike, and Squick. When using the Stories I Would Like search, any story that contains a Tag for which you have indicated a Squick preference will be excluded, regardless of the other Tags associated with the story.
Preference Gauge Preference Guages are displayed on Title and Chapter pages as a quick color-coded indicator of how a storys contents, as indicated by its Tags, align with your Preferences. The ratio of colors enables you to determine your likely reaction to the story. Moving the cursor over a preference gauge will display a percentage breakdown of your Preferences with regard to the story. Note that Neutral (blue) preferences are not displayed on the gauge. If you have not yet indicated any Preferences, then the entire gauge will appear as a blue bar; simply right-click on the story's Tags and select how you feel about each to set your Preferences, and the gauge will change to reflect them.
Tag An identifying category assigned to a Chapter or Title, displayed when a Title or Chapter is visible on the screen. Tags may only be assigned at the Chapter level, and are accumulated at the Title level. That is, the Tags associated with a story that has multiple Chapters is the accumulation of all the individual Chapter tags.
Title A grouping of Chapters that form a particular story, as defined by the EMCSA site structure. Tags assigned to a Title's individual Chapters are accumulated and displayed at the Title level.