Notes2 Specification
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 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 color of the side pane is used to reduce the brightness contrast of notes windows and the (generally) dark writer background.
- Color: Decimal R230, G230, B230, A255 (Hex: e6e6e6ff)
- The line between page and side pane area marks the end of the physical page and delimits the notes windows (similar to page margin indication):
- Width: 1 screen pixel
- Color: Decimal R200, G200, B200, A255 (Hex: c8c8c8ff)
- At the moment (OOo 2.2), is colored black and the shadow of the page seems not be dependent on the zoom level. Therefore...
- Width: 3 screen pixels
- Delta with reference to the document page: horizontal 3 pixels, vertical 3 screen pixels
- Dark Color (beginning at page): Decimal R83, G83, B83, A255 (Hex: 535353ff)
- Bright Color (ending at writer background, same color as writer background in current OOo): R150, G150, B150, A255 (Hex: 969696ff)
- Please note that the shadow may be deactivated when the user edits the notes user data inside the notes windows.
Arrangement of notes on the notes side pane
A single note has a minimum height that allows to show date, author and at least two lines of text in the default notes font size. Basically the height of a note can be expanded until it reaches the page height. If other notes are located at the same page they might come so close to each other that they want to occupy the same space of the notes side pane. and they will avoid each other. If the whole page height is filled with notes,
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>