| | 1 | = Tooltips: Dan's Edit = |
| | 2 | |
| | 3 | (from [wiki:GROUP_HELP_R1] and [wiki:SandBox/danvisel/GROUP_HELP_R2]) |
| | 4 | |
| | 5 | == Conventions == |
| | 6 | |
| | 7 | I've copied the text from the design section of [wiki:GROUP_HELP_R1]; my suggested changes are in '''bold'''. |
| | 8 | |
| | 9 | == Tooltips == |
| | 10 | |
| | 11 | === Menu bars and menus === |
| | 12 | || File || File Menu || File Menu (Alt-F) || |
| | 13 | || New Book || '''Create a new book''' || '''Create a new book''' || |
| | 14 | || Open Book... || '''Open an existing book''' || '''Open an existing book''' || |
| | 15 | || Close || ? || '''Close the current book''' || |
| | 16 | || Save || '''Save the current book''' || '''Save the changes made to the current book''' || |
| | 17 | || Save As... || '''Save the current book with a new name''' || '''Save the current book with a new name''' || |
| | 18 | || Save As Template || '''Save the current book as a book template''' || '''Save the current book as a book template''' || |
| | 19 | || Export Book As || ? || '''Export the book to other file formats''' || |
| | 20 | || PDF... || ? || '''Export the book as a PDF''' || |
| | 21 | || HTML... || ? || '''Export the book as a webpage''' || |
| | 22 | || Print... || ? || '''Print the book''' || |
| | 23 | || Book Properties... || ? || '''Edit the current book's title and dimensions''' || |
| | 24 | || Quit || ? || '''Exit Sophie''' || |
| | 25 | |||||||| |
| | 26 | || Edit || Edit Menu || Edit Menu (Alt-E) || |
| | 27 | || Undo || ? || '''Undo the last action''' || |
| | 28 | || Redo || ? || '''Redo the last undone action''' || |
| | 29 | || Cut || ? || '''Move the selected element to another location by pasting''' || |
| | 30 | || Copy || ? || '''Copy the selected element to another location by pasting''' || |
| | 31 | || Paste || ? || '''Put the last copied/cut element to selected location''' || |
| | 32 | || Delete || ? || '''Remove the selected element from its current location''' || |
| | 33 | |||||||| |
| | 34 | || Insert || Insert Menu || Insert Menu (Alt-E) || |
| | 35 | || Text || ? || '''Add an empty text frame to the current page''' || |
| | 36 | || Image... || ? || '''Add an image file to the current page''' || |
| | 37 | || Audio... || ? || '''Add an audio file to the current page''' || |
| | 38 | || Audio Record... || ? || '''Record audio and add it to the current page''' || |
| | 39 | || Video... || ? || '''Add a video file to the current page''' || |
| | 40 | || Book... || ? || '''Add a Sophie book to the current page''' || |
| | 41 | || PDF... || ? || '''Add a PDF to the current page''' || |
| | 42 | || HTML... || ? || '''Import HTML content into a frame on the current page''' || |
| | 43 | || Plain text... || ? || '''Import plain text into a frame on the current page''' || |
| | 44 | || Browser || ? || '''Insert a browser frame on the current page''' || |
| | 45 | || Script || ? || '''Create a new script in this book''' || |
| | 46 | || Script file... || ? || '''Attach a script created outside of Sophie to this book''' || |
| | 47 | |||||||| |
| | 48 | || View || View Menu || View Menu (Alt-V) || |
| | 49 | || Normal mode || ? || '''Use Sophie in a window''' || |
| | 50 | || Full screen mode || ? || '''Use Sophie in full-screen mode''' || |
| | 51 | |||||||| |
| | 52 | || Skins || Skins Menu || Skins Menu (Alt-S) || |
| | 53 | |||||||| |
| | 54 | || Window || Window Menu || Window Menu (Alt-W) || |
| | 55 | || Cascade || ? || '''Stack the book windows so that each title bar is visible''' || |
| | 56 | || Tile || ? || '''Arrange the book windows so they are shown side by side''' || |
| | 57 | || Book Window Item || ? || ''Book Title'' || |
| | 58 | |||||||| |
| | 59 | || Help || Help Menu || Help Menu (Alt-H) || |
| | 60 | || Help Contents || ? || '''Display the main help index''' || |
| | 61 | || Send an Error Report || ? || '''Report problems related to application use to the Sophie developers''' || |
| | 62 | || About || ? || '''Show version and license information''' || |
| | 63 | === Opened books tabbar === |
| | 64 | || Show Desktop || ? || '''Switch to the book desktop''' || |
| | 65 | || Book Tab Item || ? || ''Full book name'' || |
| | 66 | === Flaps === |
| | 67 | || Left || ? || '''Show or hide the left flap''' || |
| | 68 | || Right || ? || '''Show or hide the right flap''' || |
| | 69 | || Bottom || ? || '''View and edit the currently selected timeline''' || |
| | 70 | === Tabs === |
| | 71 | || Books || ? || '''The books tab lists open books as well as embedded books in the current book''' || |
| | 72 | || Book item in Opened books palette || ? || ''' ''Book name'': double-click to switch to this book''' || |
| | 73 | || Book item in Embedded books palette || ? || ''' ''Book name'': double-click to open this embedded book in a new window''' || |
| | 74 | |||||||| |
| | 75 | || Pages || ? || '''The pages tab shows thumbnails of your book''' || |
| | 76 | || Page item || ? || '''Click to go to this page; drag to reorder; drag a page template here to change the page template''' || |
| | 77 | |||||||| |
| | 78 | || Tools || ? || '''The tools tab allows you to search the content of your book''' || |
| | 79 | || Search Field || ? || '''Enter text to search''' || |
| | 80 | |||||||| |
| | 81 | || Config || ? || '''The config tab allows you to set up and configure the Sophie application''' || |
| | 82 | || Plugin item || ? || ''Name of the plugin'' || |
| | 83 | || Enable button || ? || '''Enable the selected plugin''' || |
| | 84 | || Disable button || ? || '''Disable the selected plugin: plugins dependent on this one will also be disabled''' || |
| | 85 | |||||||| |
| | 86 | || Servers || ? || '''The servers tab allows you to connect to Sophie Servers''' || |
| | 87 | || Server item || ? || ''Server Name'' || |
| | 88 | || Toggle selected button || ? || '''Connect or disconnect from the currently selected server''' || |
| | 89 | || Refresh button || ? || '''Refresh the list of books on the current server''' || |
| | 90 | |||||||| |
| | 91 | || Resources || ? || '''This tab shows resources in your book''' || |
| | 92 | || Copy || ? || '''Duplicate this resource''' || |
| | 93 | || Delete || ? || '''Remove this resource''' || |
| | 94 | || Changes || ? || '''This palette shows the history of actions that have been performed on the current book''' || |
| | 95 | || Library || ? || '''This tab shows book templates, page templates, and frame templates''' || |
| | 96 | || Frame template item || ? || '''Double-click to apply to the currently selected frame, or drag to the page to create a new frame''' || |
| | 97 | || Page template item || ? || '''Double-click to apply to the current page, or drag to the page preview palette to create a new page''' || |
| | 98 | || Book template item || ? || '''Double-click to create a new book from the template, or drag to the page to create a new embedded book''' || |
| | 99 | || Book Extras || ? || '''This tab allows readers to add annotations to the book''' || |
| | 100 | || Add Sticky || ? || '''Add a sticky note to the current page''' || |
| | 101 | || Styles || ? || '''This tab shows paragraph and character styles''' || |
| | 102 | || Timelines || ? || '''Show timeline controls''' || |
| | 103 | |
| | 104 | |
| | 105 | === Book window === |
| | 106 | || Zoom panel || ? || '''Zoom in or out to see less or more of the book window (Ctrl-+/Ctrl--/Ctrl+*)''' || |
| | 107 | || Page selector go to prev page || ? || '''Go to the previous page (PgUp)''' || |
| | 108 | || Page selector go to next page || ? || '''Go to the next page (PgDown)''' || |
| | 109 | || Page selector text field || ? || '''The current page number; type in another number to go to that page''' || |
| | 110 | || Search text field || ? || '''Enter the text to search for''' || |
| | 111 | || Search prev || ? || '''Go to the previous search result''' || |
| | 112 | || Search next || ? || '''Go to the next search result''' || |
| | 113 | || Outline frames || ? || '''Show frame bounds (border, margins and padding)''' || |
| | 114 | || Open preview || ? || '''Open a preview of this book to see how it will appear to the reader''' || |
| | 115 | === Book content === |
| | 116 | || Resize cursor || ? || '''Drag frame edges to resize the frame''' || |
| | 117 | || Text/Audio/Video/Book/PDF/Browser Frame || ? || Text/Audio/Video/Book/PDF/Browser '''frame; drag another resource here to replace this frame's content''' || |
| | 118 | || Page || ? || '''Drag resources to the page to add content to this page''' || |
| | 119 | === Halos === |
| | 120 | || FramePropertiesHalo || ? || '''The frame properties HUD lets you edit the size, position, and orientation of the frame''' || |
| | 121 | || FrameAppearanceHalo || ? || '''The frame appearance HUD lets you control frame borders and fills''' || |
| | 122 | || Increase z-order halo || ? || '''Move this frame forward''' || |
| | 123 | || Decrease z-order halo || ? || '''Move this frame backward''' || |
| | 124 | || LinkHalo || ? || '''Add or edit links on this frame''' || |
| | 125 | || DeleteHalo || ? || '''Delete this frame from the page''' || |
| | 126 | |||||||| |
| | 127 | || GroupHalo || ? || '''Create a group of the selected frames so they can be manipulated together''' || |
| | 128 | || UngroupHalo || ? || '''Ungroup this group so that the frames can be edited separately''' || |
| | 129 | || AlignHalo || ? || '''Align these frames together''' || |
| | 130 | || EnterGroupHalo || ? || '''Start editing the objects inside the group as they were not grouped''' || |
| | 131 | || ExitGroupHalo || ? || '''Stop editing the frames inside this group''' || |
| | 132 | || CharacterHalo || ? || '''Change the character styles for selected text''' || |
| | 133 | || PararaphHalos || ? || '''Change the paragraph settings of this paragraph''' || |
| | 134 | || Content control halo (for video, audion, pdf, etc) || ? || Content - Edit preview options such as frame controllers || |
| | 135 | |||||||| |
| | 136 | || AnchorHalo || ? || '''Click to show text anchoring options, or drag to anchor''' || |
| | 137 | || RotateHalo || ? || '''Click to show orientation options, or drag to rotate''' || |
| | 138 | || ChainingHalo || ? || '''Click to show chaining options, or drag to another frame to chain to that frame''' || |
| | 139 | |
| | 140 | |
| | 141 | |
| | 142 | == Comments == |
| | 143 | |
| | 144 | * 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. |
| | 145 | * '''Insert > Audio Record''' sounds very strange to me. I'd replace it with '''Insert > Record audio''' |
| | 146 | * 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. |
| | 147 | * This list doesn't include the names of many palettes (especially in the left tab), which should also have alternate text. Often the palette's name is more important than the tab's name. |
| | 148 | * Is there another list for all the content inside of HUDs? I assume those need tooltips as well. |
