NorCascade - Configuration.  Author Norman Rouxel - www.drillpine.biz (V11)

The NorCascade program allows convenient configuration of the many parameters used by the cascading menus.

GENERAL

Version:	Set to the version of Actinic you are using.  Your current Site will be detected.

Create Vars:	Write the generated configuration (with with norcascade_pop_tail.js appended) 
		to the file norcascade_pop_var.js in the Site Folder.  
		Also copies pop_core.js and pop_events.js to the Site folder (if not already there).

Save Settings:	Save the configuration to the Site folder.

Center:		Check if you want the root level menu horizontally centered on the screen.
		(the first level H Offset and V Offset will be added / subtracted from this)

V Lock:		Check if you want the menu locked to a the screen position.  This means that the menu
		will stay on the same place on the page as the oages is scrolled up / down.

SingleRoot:	Check if you want a single entry for the top level menu.  Uncheck and you get your 
		Actinic top-level sections.

Target:		Anchor name (e.g. home).  Position the menu relative to an anchor 
		like <a id="home" name="home"> in the page.
		IMPORTANT: If you're doing this, you should move the menu <SCRIPT> tags just before the 
		closing </BODY> tag of your documents. 
		The page.elmPos function is not included in the example frameset script; 
		you must paste it into the frameset from the single-frame data file.

SingleRootText:	If using SingleRoot, the text to display in this first entry (HTML is allowed).

SingleRoorURL:	If you want the single root text to be clickable, the address to go to.
		Leave empty for no link.

MaxDepth:	If you want the menu to stop after a certain number of levels set it here.
		Leave 0 for all.

AutoSize:	If you have very tall menus then NorCascade will attempt to shrink to fit the screen.
		It will first remove any inter-cdell spacing and then reduce the height of each cell.

Min		The minimum size that AutoSize will reduce the cell height to.

OnlyFinalLinks  Check to make only the final levels of the menu clickable.	

LinkPrefix:	If you leave this blank the NorCascade will use the original Actinic section URL's 
		as the link to follow.  However this goes through a Perl script (SearchScript.pl)
		and can be inefficient.
		If you set this to the URL of your catalog (including the trailing /).
		e.g.  http://www.mysite.com/acatalog/
		then NorCascade will generate absolute links which should be much more efficient
		at loading the page.

LAYOUT

Level:		1,2,3.  The level of the generated menu.  You can apply different parameters
		to each level.

Orientation:	Vertical or Horizontal.  The orientation of this levels menu.

H Offset:	The Horizontal offset (in pixels).  
		For first level menus this is the offset from the screen edge.
		For subsequent levels this is the offset from the left-edge of the parent cell.

V Offset:	The Vertical offset (in pixels).  
		For first level menus this is the offset from the screen top.
		For subsequent levels this is the offset from the top-edge of the parent cell.

Width:		If fixed width cells - the width of each of this menus cells (in pixels).
		If this level is laid out horizontally and Auto (below) is set then
		NorCascade will attempt to scale each cell to fit the number of characters.
		In this case Width should be the set to the width of 1 character in pixels.

Auto:		Check if you want to scale horizontal menus fit to the width of their text.
		Clear if you want each horizontal cell the same width.

HPadd:		Additional padding (in pixels) to add to overall length of Auto scaled 
		horizontal menus.

Height:		The height of each of this menus cells (in pixels).

Spacing:	The space between each adjacent menu cell (in pixels).

PopoutInd:	The character (or image - via <IMG> tag) to display when a cell has a sub-menu. 
		HTML is allowed. To swap on mouseover, set as 'SWAP:out text^over text'.

IndPos:		The position of the Popout Indicator (in pixels).  
		If positive - the position from the cell's left edge.
		If negative - the position from the cell's right edge.

Padd:		The gap between the item edge and text (in pixels).

LinkCursor:	Cursor to display if over an final level cell.  
		Cursor values should be valid CSS cursor names like 'default', 'hand', 'crosshair' and so on 
		(note that 'hand' is automatically translated into 'pointer' where needed). 

Def.Cursor:	Cursor to display if over an intermediate level cell.  
		Cursor values should be valid CSS cursor names like 'default', 'hand', 'crosshair' and so on 
		(note that 'hand' is automatically translated into 'pointer' where needed).
		As NorCascade makes all links (except possibly the SingleRoot) clickable.  'hand' may be best.

Parent Frame:	If left out or set to an empty string '', menus will display in the current window. 
		Otherwise, set to a frame reference like 'content' to show the menu in a frame by that name 
		(only if you're using the frameset version of the script).

ShowOnClick:	Set to true to show submenus onclick instead of the default onmouseover appearance, 
		like Windows' menus.  
 

MouseOut / Mouse Over The behaviour when the mouse is over or out of this level.

BackGround:	You can use background colours or images. 
		To use background images, set a filename like 'pic.gif'.  These may need loading through
		Actinic's Advanced / Additional files.
		For colours use a colour name/value like '#112233'
		Fading background colours: You can use the form '10#112233' where the number before the
		# is the fade speed in percent. 
		For transparent backgrounds use an empty string ''.

Font Class:	These refer to class names (in the Styles tab), which set the font/colour/size/alignment/etc
		of the text of this levels items. 

Border Class:	These refer to class names (in the Styles tab), which set the colour/size/alignment/etc
		of the borders of this levels items.
		If you don't want borders, set the border class to an empty string ''.

Opacity:	Set these to null (without quotes) if you want solid items, 
		or use numbers between 0 and 100 for translucent items.


STYLES		All entries are combined to form pop_style.css in the Site folder.

Text Styles:	Valid CSS styles.  These should match the styles selected for Font Class in the Layout page.

Border Styles:	Valid CSS styles.  These should match the styles selected for Border Class in the Layout page.

ButtonStyles:	Spare CSS styles.  Select these for Font or Border Class in the Layout page.


These all apply to menu levels 1, 2 and 3.   
For any menu levels after 3 the Level 3 style is used but the following 2 parameters override.

Rest H Offset:	The Horizontal offset (in pixels).  
		This is the offset from the left-edge of the parent cell.

Rest V Offset:	The Vertical offset (in pixels).  
		This is the offset from the top-edge of the parent cell.


ADVANCED	

Extra Vars:	Additional JavaScript that will follow the list of generated variables.

Extra Code:	Additional JavaScript that will follow norcascade_pop_tail.js.
		For example Drop Shadows can be implemented by adding:-

		addDropShadow(pMenu, window.Level1, [40,"#333333",6,6,-4,-4], [40,"#666666",4,4,0,0]);
		addDropShadow(pMenu, window.Level2, [40,"#333333",6,6,-4,-4], [40,"#666666",4,4,0,0]);
		addDropShadow(pMenu, window.Level3, [40,"#333333",6,6,-4,-4], [40,"#666666",4,4,0,0]);

		This will add shadows to levels 1,2 and 3.  If you want to omit shadows from a level
		then leave out the appropriate line.

DIAGNOSTIC:	The code generated by Create Vars will be displayed here.
 
 
SUPPORT

	There's a support Forum on www.drillpine.biz/forums - please post under the NorCascade topic.
	  
	I would like to have a look at sites you use it on so please send me a URL.
	All the usual disclaimers apply.

Norman Rouxel www.drillpine.biz (V11)
 



