Notes2 Specification

Improved notes

Specification Status
Author	Mathias Bauer
Last Change
Status	Preliminary Help

Abstract

<START TYPING HERE>

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.

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>