= Tooltips: Dan's Edit =

(from [wiki:GROUP_HELP_R1])

== Conventions ==

I've copied the text from the design section of [wiki:GROUP_HELP_R1]; my suggested changes are in '''bold'''.

== Tooltips ==

=== Menu bars and menus ===
||	File	||	File Menu	||	File Menu (Alt-F)	|| 
||	New Book	||	'''Create a new book'''	||	'''Create a new book'''	||
||	Open Book...	||	'''Open an existing book'''	||	'''Open an existing book'''	||
||	Close	||	? ||	'''Close the current book'''	||
||	Save	||	'''Save the current book'''	||	'''Save the changes made to the current book'''	||
||	Save As...	||	'''Save the current book with a new name'''	||	'''Save the current book with a new name'''	||
||	Save As Template	||	'''Save the current book as a book template'''	||	'''Save the current book as a book template'''	||
||	Export Book As		||	?	||	'''Export the book to other file formats'''	||
||	PDF...	||	?	||	'''Export the book as a PDF'''	||
||	HTML...	||	?	||	'''Export the book as a webpage'''	||
||	Print...	||	? ||	'''Print the book'''	||
||	Book Properties...	||	? ||	'''Edit the current book's title and dimensions'''	||
||	Quit	||	?	||	'''Exit Sophie'''	||
||||||||
||	Edit	||	Edit Menu ||	Edit Menu (Alt-E)	||
||	Undo	||	? ||	'''Undo the last action'''	||
||	Redo	||	? ||	'''Redo the last undone action'''	||
||	Cut	||	?	||	'''Move the selected element to another location by pasting'''	||
||	Copy	||	?	||	'''Copy the selected element to another location by pasting'''	||
||	Paste	||	?	||	'''Put the last copied/cut element to selected location'''	||
||	Delete	||	?	||	'''Remove the selected element from its current location'''	||
||||||||
||	Insert	||	Insert Menu ||	Insert Menu (Alt-E) ||
||	Text	||	?	||	'''Add an empty text frame to the current page'''	||
||	Image...	||	?	||	'''Add an image file to the current page'''	||
||	Audio...	||	?	||	'''Add an audio file to the current page'''	||
||	Audio Record...	||	?	||	'''Record audio and add it to the current page'''	||
||	Video...	||	?	||	'''Add a video file to the current page'''	||
||	Book...	||	?	||	'''Add a Sophie book to the current page'''	||
||	PDF...	||	?	||	'''Add a PDF to the current page'''	||
||	HTML...	||	?	||	'''Import HTML content into a frame on the current page'''	||
||	Plain text...	||	?	||	'''Import plain text into a frame on the current page'''	||
||	Browser	||	?	||	'''Insert a browser frame on the current page'''	||
||	Script	||	?	||	'''Create a new script in this book'''	||
||	Script file...	||	?	||	'''Attach a script created outside of Sophie to this book'''	||
||||||||
||	View	||	View Menu	||	View Menu (Alt-V)	||
||	Normal mode	||	?	||	'''Use Sophie in a window'''	||
||	Full screen mode	||	?	||	'''Use Sophie in full-screen mode'''	||
||||||||
||	Skins	||	Skins Menu	||	Skins Menu (Alt-S)	||
||||||||
||	Window	||	Window Menu	||	Window Menu (Alt-W)	||
||	Cascade	||	?	||	'''Stack the book windows so that each title bar is visible'''	||
||	Tile	||	?	||	'''Arrange the book windows so they are shown side by side'''	||
||	Book Window Item	||	?	||	''Book Title''	||
||||||||
||	Help	||	Help Menu	||	Help Menu (Alt-H)	||
||	Help Contents	||	?	||	'''Display the main help index'''	||
||	Send an Error Report	||	?	||	'''Report problems related to application use to the Sophie developers'''	||
||	About	||	?	||	'''Show version and license information'''	||
=== Opened books tabbar ===
||	Show Desktop	||	?	||	'''Switch to the book desktop'''	||
||	Book Tab Item	||	?	||	''Full book name''	||
=== Flaps ===
||	Left	||	?	||	'''Show or hide the left flap'''	||
||	Right	||	?	||	'''Show or hide the right flap'''	||
||	Bottom	||	?	||	'''View and edit the currently selected timeline'''	||
=== Tabs ===
||	Books	||	?	||	'''The books tab lists open books as well as embedded books in the current book'''	||
||	Book item in Opened books palette	||	?	||	''' ''Book name'': double-click to switch to this book'''	||
||	Book item in Embedded books palette	||	?	||	''' ''Book name'': double-click to open this embedded book in a new window'''	||
||||||||
||	Pages	||	?	||	'''The pages tab shows thumbnails of your book'''	||
||	Page item	||	?	||	'''Click to go to this page; drag to reorder; drag a page template here to change the page template'''	||
||||||||
||	Tools	||	?	||	'''The tools tab allows you to search the content of your book'''	||
||	Search Field	||	?	||	'''Enter text to search'''	||
||||||||
||	Config	||	?	||	'''The config tab allows you to set up and configure the Sophie application'''	||
||	Plugin item	||	?	||	''Name of the plugin''	||
||	Enable button	||	?	||	'''Enable the selected plugin'''	||
||	Disable button	||	?	||	'''Disable the selected plugin: plugins dependent on this one will also be disabled'''	||
||||||||
||	Servers	||	?	||	'''The servers tab allows you to connect to Sophie Servers'''	||
||	Server item	||	?	||	''Server Name''	||
||	Toggle selected button	||	?	||	'''Connect or disconnect from the currently selected server'''	 ||
||	Refresh button	||	?	||	'''Refresh the list of books on the current server'''	||
||||||||
||	Resources	||	?	||	'''This tab shows resources in your book'''	||
||	Copy	||	?	||	'''Duplicate this resource'''	||
||	Delete	||	?	||	'''Remove this resource'''	||
||	Changes	||	?	||	'''This palette shows the history of actions that have been performed on the current book'''	||
||	Library	||	?	||	'''This tab shows book templates, page templates, and frame templates'''	||
||	Frame template item	||	?	||	'''Double-click to apply to the currently selected frame, or drag to the page to create a new frame'''	||
||	Page template item	||	?	||	'''Double-click to apply to the current page, or drag to the page preview palette to create a new page'''	||
||	Book template item	||	?	||	'''Double-click to create a new book from the template, or drag to the page to create a new embedded book'''	||
||	Book Extras	||	?	||	'''This tab allows readers to add annotations to the book'''	||
||	Add Sticky	||	?	||	'''Add a sticky note to the current page''' ||
||	Styles	||	?	||	'''This tab shows paragraph and character styles'''	||
||	Timelines	||	?	||	'''Show timeline controls'''	||


=== Book window ===
||	Zoom panel	||	?	||	'''Zoom in or out to see less or more of the book window (Ctrl-+/Ctrl--/Ctrl+*)'''	||
||	Page selector go to prev page	||	?	||	'''Go to the previous page (PgUp)'''	 ||
||	Page selector go to next page	||	?	||	'''Go to the next page (PgDown)'''	 ||
||	Page selector text field	||	?	||	'''The current page number; type in another number to go to that page'''	||
||	Search text field	||	?	||	'''Enter the text to search for'''	||
||	Search prev	||	?	||	'''Go to the previous search result'''	||
||	Search next	||	?	||	'''Go to the next search result'''	||
||	Outline frames	||	?	||	'''Show frame bounds (border, margins and padding)'''	||
||	Open preview	||	?	||	'''Open a preview of this book to see how it will appear to the reader'''	||
=== Book content ===
||	Resize cursor	||	?	||	Drag to resize the frame	||
||	Text/Audio/Video/Book/PDF/Browser Frame	||	?	||	Text/Audio/Video/Book/PDF/Browser frame, you may drag another resource here to replace this frame's content	||
||	Page	||	?	||	Drag resources to the page to create frames with this resources as content	||
=== Halos ===
||	FramePropertiesHalo	||	?	||	Frame Properties - Edit size, bounds, position and orientation	||
||	FrameAppearanceHalo	||	?	||	Frame Appearence - Edit frame border and background style	||
||	Increase z-order halo	||	?	||	Increase Z order - Get the frame nearer (in front of neighbour frames)	||
||	Decrease z-order halo	||	?	||	Decrease Z order - Get the frame further (behind neighbour frames)	||
||	LinkHalo	||	?	||	Link management - Add or remove links to other objects	||
||	DeleteHalo	||	?	||	Delete frame - Remove this frame from the page and the resources palette	||
||||||||
||	GroupHalo	||	?	||	Group - Create a group of the selected objects to manipulate them as one	||
||	UngroupHalo	||	?	||	Ungroup - Break the existing group to release the dependency between grouped objects	||
||	AlignHalo	||	?	||	Align - Align selected objects on the page	||
||	EnterGroupHalo	||	?	||	Enter group - Start editing the objects inside the group as they were not grouped	||
||	ExitGroupHalo 	||	?	||	Exit group - Stop editing the objects inside the group and return to parent object (group or page)	||
||	CharacterHalo	||	?	||	Character - Edit font style	||
||	PararaphHalos	||	?	||	Paragraph - Edit text aligment, spacing, etc.	||
||	Content control halo (for video, audion, pdf, etc) 	||	?	||	Content - Edit preview options such as frame controllers	||
||||||||
||	AnchorHalo	||	?	||	Anchor - Click to show text anchoring options, drag to anchor	||
||	RotateHalo	||	?	||	Rotate - Click to show orientation options, drag to rotate	||
||	ChainingHalo	||	?	||	Chaining - Click to show chaining options, drag to another frame to choose where to extend current text	||


fafadsfadf

== Comments ==

 * Is it possible to use alternate tooltips for Cut/Copy/Paste if the '''Edit''' menu is invoked when text is selected? It should become '''Copy the selected text to the clipboard''' etc; I think it's confusing if it says "Move the selected element to another location by pasting" when you have text selected and you just want to cut it; the user might that that selecting Edit > Cut you're going to cut the frame and not the text, as you might hope. I would suggest that we probably don't need tooltips for Cut/Copy/Paste/Delete because they're used so often.
 * '''Insert > Audio Record''' sounds very strange to me. I'd replace it with '''Insert > Record audio'''
 * I don't know what to do for the left and right flap tooltips - I don't think we should refer to functionality in the flaps because there's a lot of that & the flaps basically only hold all of that. I think that if the mouse is moved over the left flap label when the flap open the tooltip should say "Hide the left flap"; if the mouse is moved over the left flap label when the flap is closed, the tooltip should say '''Show the left flap'''. That way we're telling the user what clicking that label will do.
 * This list doesn't include the names of palettes, which should also have alternate text. Often the palette's name is more important than the tab's name.