Difference between revisions of "Notes2 Specification"
(→The note window) |
(→The note window) |
||
Line 141: | Line 141: | ||
|} | |} | ||
− | The background of the note window in view mode shows a color gradient defined by a lighter starting color and a darker end color. In editing mode the background is a bulk color (the darker color of the two gradient colors). | + | The background of the note window in view mode shows a color gradient defined by a lighter starting color and a darker end color. In editing mode the background is a bulk color (the darker color of the two gradient colors). All used colors are chosen from a fixed set of colors. They are related to the color of the note anchor and connector. |
− | All used colors are chosen from a fixed set of colors. They are related to the color of the note anchor and connector. | + | |
+ | TBD: mouse over effect | ||
TBD: create new picture showing the colors | TBD: create new picture showing the colors | ||
Line 150: | Line 151: | ||
{| class="prettytable" border="0" | {| class="prettytable" border="0" | ||
| [[Image:Notes2_2007-09-04_ColorsForTheNotes_ForWiki.png]] | | [[Image:Notes2_2007-09-04_ColorsForTheNotes_ForWiki.png]] | ||
− | | The two colors of the note window are chosen from a set of 9 different color | + | | The two colors of the note window and the color of its connector and anchor are chosen from a set of 9 different color triples, each of them is assigned to another author. It is not possible to set the color of individual notes, colors represent authors. The colors have been designed very carefully regarding the following criteria: |
* unobtrusive but appealing colors that (as a set) go together well | * unobtrusive but appealing colors that (as a set) go together well | ||
* how distinguishable are the colors for people with visual impairments (inabilities or weaknesses in seeing some particular colors) | * how distinguishable are the colors for people with visual impairments (inabilities or weaknesses in seeing some particular colors) | ||
Line 156: | Line 157: | ||
* how do the note connectors line and borders look in contrast to the notes window itself | * how do the note connectors line and borders look in contrast to the notes window itself | ||
So consequently the colors can't be changed by users. | So consequently the colors can't be changed by users. | ||
+ | |} | ||
+ | ===Notes connector and anchor=== | ||
− | + | At the text position where a note has been inserted a graphical element representing the note anchor is displayed. It is a triangle whose upper angle points to the anchor position. The anchor and the corresponding note window are connected with a line. The color of the line and the anchor are the "accent color" of the color triples shown above. If the note window has the focus the line is solid, otherwise dotted, the line width is 1px. | |
+ | |||
+ | TBD: mouse over | ||
===Arrangement of notes on the notes side pane=== | ===Arrangement of notes on the notes side pane=== |
Revision as of 13:18, 6 December 2007
Improved notes
Specification Status | |
Author | Mathias Bauer |
Last Change | |
Status | Preliminary Help |
Abstract
<START TYPING HERE>
Contents
References
Reference Document | Check | Location (URL) |
Specification Process Entry Check | [passed/failed] | n/a |
Product Requirement, RFE, Issue ID (required) | [available] | http://www.openoffice.org/issues/show_bug.cgi?id=6193 |
Product Concept Document | [not available] | |
Test case specification (required) | [available/not available] | <PLEASE ENTER LOCATION HERE> |
IDL Specification | [available/not available] | |
Software Specification Rules | n/a | n/a |
Other, e.g. references to related specs | http://wiki.services.openoffice.org/wiki/Notes2 |
Contacts
Role | Name | E-Mail Address |
Developer | Max Odendahl | <mod@openoffice.org> |
Quality Assurance | Éric Savary | <es@openoffice.org> |
Documentation | Uwe Fischer | <ufi@openoffice.org> |
User Experience | Christoph Noack | <christophnoack@openoffice.org> |
Acronyms and Abbreviations
Acronym / Abbreviation | Definition |
<WYSIWYG> | <What You See Is What You Get> |
Detailed Specification
General Aspects
Notes can be attached to any text in the document. For each note a reference point is added to the text that is stored as a character, very much the same like text fields. No content is displayed at that text position, notes will be shown as small windows in a side pane of the text. A graphical element will serve as an anchor that points to the text position of the note and a connector will connect the anchor with the corresponding text of the note.
Visibility of notes
In general notes will be visible in the print layout view of a text document but not in the print preview or the web layout view. The visibility can be switch on and off in "Tools - Options - Writer - View - Display", default is "On". TBD: the visibility of own notes or the notes of a particular author can be switched.
The Notes side pane
The Notes side pane is an area that is added to left or right side of the each displayed document page. It's height is the same as the page height and the witdh is TBD at a zoom level of 100%. It is considered to be an integral part of the document view. Thus it adds to the width to the document view so that the special zoom modes "Optimal", "Page width" or "Entire page" will need to consider it. As Writer centers its view it will center the combined width of document content and notes. For left-to-right text (GUI language), the side pane is located at the right side of the writer document. For right-to-left text (GUI language), the side pane is located at the left side of the writer document. Further defitions:
|
The note window
The window of a note displays the text of the note, the name of its author and the date of creation.
TBD: create new screenshots without the button.
The background of the note window in view mode shows a color gradient defined by a lighter starting color and a darker end color. In editing mode the background is a bulk color (the darker color of the two gradient colors). All used colors are chosen from a fixed set of colors. They are related to the color of the note anchor and connector.
TBD: mouse over effect
TBD: create new picture showing the colors
TBD: future task to assign colors to authors
Notes connector and anchor
At the text position where a note has been inserted a graphical element representing the note anchor is displayed. It is a triangle whose upper angle points to the anchor position. The anchor and the corresponding note window are connected with a line. The color of the line and the anchor are the "accent color" of the color triples shown above. If the note window has the focus the line is solid, otherwise dotted, the line width is 1px.
TBD: mouse over
Arrangement of notes on the notes side pane
The vertical position of a note places its content at nearly the same height as the text position of the anchor. If the necessary space to display a note is not available, the size and position of the note and also those of other notes will be adjusted in a way that the used space is as evenly distributed amongst them as possible. If the size of a notes window is too small to show the complete notes text scroll bars will be shown.
If the height of the side pane is not enough to display all notes even with the minimum height, some notes will not be displayed and scroll buttons will be shown at the top and bottom of the side pane of the page. The scroll buttons allow to shift the position of all notes up and down, thus leaving space for the prior invisible ones and moving out others instead. See the pictures below for further reference.
Help | User Interface Element Templates | Example Spec
Migration
Old documents containing notes will works flawlessly with the new user interface.
Configuration
No configuration means are needed to use the new functionality.
Help | Configuration Table Template
File Format
A single file format change is needed that will be part of ODF 1.2.
Help | File Format Table Template
Open Issues
<State a bulleted list of issues Issue here>