diff --git a/add/help/help_en.xml b/add/help/help_en.xml index f81e20da..04296259 100644 --- a/add/help/help_en.xml +++ b/add/help/help_en.xml @@ -23,23 +23,6 @@ - - - - update metadata (add orcid, delete old addresses etc.) - * added description of searchWindow; deactivated link to missing preferences section; - * corrected long lang_vars in pull request; - - - removed tei:q around some terms as terms now with css class .term; added TODO comments searchView and preferences; - * removed generated IDs from conversion to TEI P5; * where applicable, inserted tei:head in tei:figure; * overhauled priority images to match new figure-structure; * prettified XML indentation; wrapped annotation categories table with figure; * added description of Annotation View's TaskBar Buttons; added TaskBar screenshot; * corrected figure head of Tool Bar;* changed ID from toolbar_bottom to help_view.desktop.TaskBar; * added description of annotationOverview.png; * added TODO comments; * matched EdiromHelp SVN and GitHub; * added workspace-switcher.png; - - - *overhauled structure of button entries; * corrected some typos; * added missing button descriptions in annotation-view; - * deleted comment with manually edited TOC; * provided description of annotation-view; * deleted description of annotations window; * reworked chapter on annotations; * made all ediromGui terms empty elements; * removed some generated xml:id attributes; - reworked preferences description; made preferences description a comment due to implementation status - updated occurrences of "Edirom Online" to - reworked text from "toolbar" onwards; created separate chapters for and ; added description for the buttons in help_view.desktop.TaskBar; reworked chapter on windows; inserted passages on views; Moved tei:head/@xml:id to parent tei:div using headId2parentDivId.xquery; removed leading line breaks in tei:head elements; rephrased "installation" and inserted tei:note[@type='editorial'] on insertion of installation information; changed old corresponding parts on installation into xml comments; wrapped 'Installation' and 'Application Startup' with 'Preparation' div; removed 'id_' from all @xml:id; rephrased 'Application Startup'; comletely reworkeg 'GUI' chapter; inserted TODO comments; @@ -48,6 +31,21 @@ Converted from HTML version to TEI P5 using oxgarage web sercice + reworked text from "toolbar" onwards; created separate chapters for and ; added description for the buttons in help_view.desktop.TaskBar; reworked chapter on windows; inserted passages on views; + updated occurrences of "Edirom Online" to + reworked preferences description; made preferences description a comment due to implementation status + deleted comment with manually edited TOC; provided description of annotation-view; deleted description of annotations window; reworked chapter on annotations; made all ediromGui terms empty elements; removed some generated xml:id attributes; + overhauled structure of button entries; corrected some typos; added missing button descriptions in annotation-view; + + + removed tei:q around some terms as terms now with css class .term; added TODO comments searchView and preferences; + removed generated IDs from conversion to TEI P5; where applicable, inserted tei:head in tei:figure; overhauled priority images to match new figure-structure; prettified XML indentation; wrapped annotation categories table with figure; added description of Annotation View's TaskBar Buttons; added TaskBar screenshot; corrected figure head of Tool Bar; changed ID from toolbar_bottom to help_view.desktop.TaskBar; added description of annotationOverview.png; added TODO comments; matched EdiromHelp SVN and GitHub; added workspace-switcher.png; + + + corrected long lang_vars in pull request; + added description of searchWindow; deactivated link to missing preferences section; + update metadata (add orcid, delete old addresses etc.) + replaced old (partly deprecated) content with updated and revised german help, which was translated to english; correct indentation @@ -55,1025 +53,467 @@ Help (User Manual) -

This document provides a general introduction to using . It describes the basic functions of the software. Please note that not all of the - options described here are necessarily available in every edition using . This is due to the fact that projects have their own edition guidelines and concepts. Furthermore, some versions may contain more options than - mentioned in this document due to edition-specific enhancements.

+

This document contains a general introduction to the use of . It describes the basic functions of the software. Not all of the options described below may be available in every edition, as content is created on a project-specific basis and each edition is subject to its own individual edition guidelines. + Furthermore, for edition-specific reasons, it is possible that some versions contain extensions that are not listed and explained in this document. +

- +
- User interface -

The user interface of is divided into several sections. At the top and bottom borders of the window you find and that provide access to all major Edirom functions. The space in between is called . At the top right corner of the is the so-called .

-
- - A sample view of an screen, showing (top), (bottom), , and (right). -
- -
- - - + User interface +

The application interface of consists of different areas. At the top is the , at the bottom is the . + The area in between is the , within which all internal application windows are opened to display the content of an edition and gain access to additional functions. On the right is the +

- - Detail view of the . - + + An example view of the window, which shows the (top), the (bottom), the and the (right).
-

Sample , with , and combo box for at the left end and the on the right end.

-

- At the very left of the - is the , next to it is a combo box for of the same - edition; at the very right is the for locating contents. -

-
+ + +
- - + + +

The is located on the left edge of the . + Next to it is the . This enables a selection of the various works contained within an edition and thus attempts to emulate the structure of a “classic” printed edition volume with several works included. + The and thus the packaging of several works in one edition (analogous to an earlier edition volume) is used less frequently in newer versions and the name of the individual work edition appears in its place. + On the right is the input for the and a button that opens an window. +

- -

The reopens the startup dialog.

+ + Detailed view of the with and for the work selection (left) and the search field (right).
-
-
- Selecting works -

The next element is a combo box listing the works contained in the edition. If your contains more than one work, you can switch between works at any time. If you select a different work, the context of and will be set to the newly selected work, and the contents of the will be updated accordingly.

-

Any program windows that remain open with content from the last displayed work may stay open, depending on your settings (see below). This option allows comparing components of different works directly with one another. Please note, however, that the navigation options (see ) affect only the contents of the currently selected work, while (open) contents of other works remain unaffected.

- +
+ + + +

The window can be opened by clicking the button (magnifying glass) in the or by entering a search query in the . + A text-based search is performed on all content in the edition.

+
+ + Detailed view of the : Clicking on the magnifying glass triggers the command. +
+

After a search query is executed, all results are grouped with corresponding content, eg text document, annotation. + Individual search results may be highlighted separately. + If a search query results in more than three hits per entry, a Show all hits link appears.

+
+ + The window +
+
-
+ + +
- - + + +

On the right of the is the . + The contains an edition-specific list of objects that can be organized into categories. + If an element in the list is clicked, the corresponding object opens in a window of the .

- -

Clicking the magnifying lens icon triggers . By entering a query in the located on the menu bar, you can directly operate the search window, whereas this button just opens it. For the exact functions of the search window, see the corresponding chapter ().

+ + An exemplary
-
-
- - -
- - - -

At the top right corner of the , right below the , is the so-called . The - contains an edition-specific list of content objects potentially - organized in categories. Clicking on an item opens the corresonding item in a new - window in the workspace.

-
- - A sample navigator. Behold the scrollbar on its right edge. -
-

In case the navigator holds very many objects, a scroll bar located along the right - edge of the window lets you scroll through the contents of the navigator. You can - also scroll using the wheel of your mouse, if applicable.

-

Although always fixed to the top right corner of the workspace, you can resize the - deliberately and also - reduce it to a narrow bar below the , by on its left or bottom - edges.

-
- -
- - - -

The is the space between and . In this space all internal application windows are opened and arranged in order to show contents of an edition or to give access to further application functions. The internal application windows cannot be dragged out of this area. See for further details.

-
+

If the contains many objects, you can navigate through the contents using the scroll bar on the right edge of the window. + The is fixed to the upper right corner, but can be resized via at the left or bottom edge.

+
+ -
- - - -
- - Detail view of the - -
-

The at the bottom of the gives access to content-related functions on the left, and meta-functions on the right.

-
+
- + +

Through the at the bottom of the the global content-related functions can be accessed on the left and the meta functions on the right.

- -

This button lets you arrange all open windows in tiles of a grid.

+ + Detailed view of the
-
-
- - - +

The first three buttons on the left control the different arrangement of all open content windows on the .

- -

This buttons lets you arrange all open windows in horizontal rows.

+ +
-
-
- - -
- -

This buttons lets you arrange all open windows as tiles.

+ +
-
-
- - -
- -

The button lets you show or hide measure numbers globally in all windows.

+ +
-
-
- - - +

The bars of facsimiles and editions are usually provided with bar numbers; these can be shown and hidden for all open windows with musical content using the fourth button from the left.

- -

This button lets you show or hide annotation icons globally in all windows. For further details see .

-

Annotation filter settings (see ), however, can only be configured in the of each individual window.

+ +
-
-
- - - -
- -

This button lets you add another desktop to allowing for a complete new set of windows even from another work's context without modifying your current dektop(s).

-
-
-
- - - +

Music editions or facsimiles and libretto editions can contain annotations that can be opened using annotation symbols. + With the speech bubble button you can . + Annotations can be assigned priorities and categories. Filtering annotations according to these priorities and annotations is not possible via the global button in the , but only via selection in an individual window.

- -

This button opens or closes the window.

+ +
-
- -
- - - + + + +

At the bottom right, you can use the question mark button to open the or move it to the foreground.

- -

You can use this button to display this Help (Edirom User Manual) window or to move it to the foreground.

+ +
-
-
-
- -
- - - -

The window can be opened by clicking the button (magnifying lens) on the or by entering a search query in the and hitting Return. It will perform a text-based search on all edition contents.

-
- -
-

After performing a search operation, all resulting hits are grouped as one result entry for every corresponding content item (text document, annotation, etc.). Furthermore, individual hits are highlighted within their surrounding context.

- -

Clicking on an entry's title or on a highlighted search hit opens the corresponding content item with all search hits highlighted.

-

If a search operation scores more than three hits per entry a link named show all hits will appear.

- - -
- - -
- - - -

The offers quick access to the objects contained in the edition, which are opened by mouse click in a new on the current .

- -
- - A sample navigator. Note the scrollbar on the right. -
-

The number of objects held by the may exceed the actual size of the panel. In this case a scrollbar at the right side of the window permits to scroll through the contents - of the . The mouse wheel may be used as well.

-

Although the is fixed to the top right corner of the workspace, it is possible to resize and even to reduce it to a narrow - bar below the button by drag-and-drop on its left or bottom edge.

+
- + +
- + - -

The -provides navigation by concordance, - affecting those contents in windows currently open and associated with the concordance.

-

Different concordances can be selected from a drop down menu. Furthermore movements etc are accessible through a second drop-down - If the selected concordance has subdivisions (e.g. movements) a second drop-down menu will appear to choose between them.

-

Slider with number indicating current connection; click display to trigger; use arrowheads to navigate back and forward step by step.

-

mehrere Konkordanzen und editions spez

- - -
+ +

The navigator for enables cross-source navigation in all corresponding facsimiles or the edition. + Another example of the application is the concordance of scores and the corresponding verses of a libretto in order to be able to view the musical instructions alongside the specific verse lines at the same time. + However, the existence of the concordances in question depends on the respective edition. + If the selected concordance contains further subdivisions, such as sentences, a second drop-down menu will appear for selection.

+
- - with and without additional drop-down menu. + with and without additional drop-down menu.
-

Below the slide control is a large button labeled . Click on this button to open the selected measure in all open sources on - the current desktop. You can also navigate within sources using the two arrows - to the left and right of the button, which allow you to browse forward or backward. Depending on your settings , only windows which are already opened are affected by this. If this particular measure exists in other sources currently not displayed, a small button on the lower right will appear . This buttons lets you open all relevant - windows for the selected measure position and will rearrange all open - windows.

- -

A common use is a measure concordance which lets you display the content of a particular measure in all facsimiles and scores of the current work open on the . -If the current work has more than one movement, a drop-down menu lets you select the desired one. Using a slide - control, you may select the measure to be displayed when you click the button - labeled .

-

Another example would be a concordance of scores and the corresponing verses of - a libretto, in order to simultaneoulsy display the corresponding musical - setting alongside a particular verseline. The presence of certain concordances - depends on the particular edition.

- +

Below the slider is the button . + This must be clicked to open the selected measure in all open sources on the desktop. + You can also navigate forward or backward at the measure level within the sources using the arrows to the right and left of the button. + However, if the selected measure occurs in other sources that are not currently open, a button will appear at the bottom right that opens all other sources and rearranges the windows

- - +
Content windows -

Content windows can be manipulated within the program in virtually the same - way as normal operating system windows. Along the top edge of the window is a title - bar that contains the name of the displayed item.

-

Below the title bar each window contains a . At the very left of this is a for switching between ; offer differnent perspectives on the content - currently open in a window (e. g. - , , , - etc.) At the bottom edge each window might contain a view specific with tools for manipulating the - respective object. The availability of is - dynamic and thus depends on the object being displayed. For example:

- - - This is standard for all windows containing multiple views and allows for - switching between views. - - -

The object concept of has - changed in comparison to the former Edirom Viewer, switching to a much - more flexible and dynamic concept of objects. Thus windows no longer are of a certain - type but dynamically provide views to an object depending on its contents. For a - translation of the former window types to the new view concept see the below - table.

- - - Type of content - Available views - Comparable Edirom Viewer object - - - XML resource - XML view - - - - - Editorial text in TEI - Metadata view, Text view, XML view - Text - - - MEI file - Metadata view, XML view - - - - - MEI file with associated facsimile images - Metadata view, Facsimile view, XML view - Score window - - - MEI work file - Metadata view, Annotations view, XML view - - - -
-

Each open window is represented as button in the holding the window title, a feature that might be - known from certain computer operating systems. Clicking on this entry toggles show/hide window function.

-

When multiple windows are open, the entry in the indicates which window is currently - active (and will thus react to certain key combinations): - The corresponding entry of the currently active window is highlighted in contrast to - those of non-active windows. Windows can be - arranged on the desktop as desired by on - the title bars.

-

At the right end of the title bar are three buttons:

-
- -

click on this symbol to the - windowe to the .

-
-
- -

click on this symbol to the window on the current desktop.

-
-
- -

click on it to close the corresponding window..

-
+

At the top of a window with content there is a line that shows the title of the open object. + Under the title bar, each window has a . + On the left in the is the , with which you can switch between different of the currently open window, e.g. , , . + Depending on the view selected, the may be displayed at the bottom of the window, which provides different tools for manipulating the various objects.

-

Windows can be resized by any - edge or corner of the window frame. This allows the user to customize his or her own - workspace.

-

In addition to other content-dependent control elements, - some advanced window organization options are also available (already - described above, see ).

- +
- - -

The entry is available on a window's - Menu if the - content item of the window is a text-based item, e. g. a TEI file. The text appears in a form similar to that of a website and may - include links to other content (depending on the edition, appearance of actual - links may vary). Clicking on these links opens the corresponding item in the same - window. To open the link in a new window, hold down the Control key - (Windows) or the Command key (Mac OS X) while - clicking. + + +

If the content of a window is text-based, e.g. a TEI file, the entry for is within a Menu window available. + The appears in a similar form to a web page and may contain links to other content.

-

Text view specific controls will appear in the , these include:

- +
+ + +
+ + + +

If is one of the possible views of an object, the images from the source are shown.

+ +
- + - - This allows to skip to a certain - chapter of a text. - - +

In the there are the following additional menus.

+ +

+ + + + Under there are the following sub-points: + + + The option supports the control of the display of measure numbers from the current source. + Measure numbers appear in the middle of each measure. + + The entry controls the adjustment of the zoom level of the source to the current window size. + + The menu entry shows or hides existing layers in the music if they were provided by the edition. + These layers could, for example, be colored notes to visually highlight the additions in the autograph or facsimiles. + +

+ +

+ + + + Under there are the following sub-points. + + + The option enables the display of the critical report annotations as annotation symbols on the facsimiles or edition. + Annotations can be filtered by priority and category (see below). + In each source, only the annotations that are related to the open source are displayed. + Mouseover over the annotation symbol opens a tooltip that can be used to open the annotation in a new window. + + Option to filter comments by priority. + + Option to filter comments by category. + +

+ +

+ + + + The has the following functions: + + + The option opens a dialog in which the desired division and measure number can be entered. + + Listing of all divisions or edition-specific sections within a source. + +

- - - - - -
- - - -

The shows source images and provides controls for navigating in a source.

-

The of the facsimile and score window contains the following additional control menus:

- - - allows configuration of displayed layers, or superimposed measure numbers - (for a detailed description see ). - - allows configuration of superimposed annotation symbols (for a detailed description see ). - - allows jumping to certain measures or movements of the current source (for a detailed description see ). - -

The contains following controls for navigating the source contents:

- -
- -

- - switches to a page based navigation of the source.

-
-
- -

- - switches to a measure based navigation of the source.

-
+ +
+ + + +

The contains the following tools for navigation within the content of the sources:

- -

- - allows for zooming in and out of the page currently displayed.

+ + : switches to page-based navigation of the source.
- -

- - Fits the current page into the window.

+ + : switches to measure-based navigation of the source. When this view is activated, the following three additional tools appear in the .
- -

- respectively - The number indicated by the number field either shows the currente page number (), or measure number (). Switching to another page or measure is possible either by clicking on the respective arrow heads for leafing through, or entering a number in the number field, in which case a filtered list of possible numbers will appear. The possible numbers correspond to those used by the editor for the source and therefore do not always begin with 1 and might include any alphanumeric character.

+ + , : The movement whose measures should be displayed can be selected. +
+
+ + , : Individual parts can be selected. This tool is only available when different parts are in the encoding. +
+
+ + , : Enter a measure range through which you want to scroll. +
+
+ + +
+
+ + : resizes the current source to fit the window. +
+
+ + or +

The number in the number field shows the current page number () or measure number (). + Switching to another page or measure is possible by clicking on the arrow heads or entering a number in the number field. + The possible numbers correspond to the source, so they do not always start with 1 and can also contain alphanumeric characters.

- -

Some additional controls appear when switching to the :

- -
- -

- - Allows for selecting the movement from which measures shall be displayed.

-
-
- -

- - Allows for selecting the parts to be displayed. This control is only available if the current source has parts marked.

-
-
- -

- - This input field allows entering the number of measures being displayed.

-
- -

Zoom level can be increased or decreased using the scroll function of the mouse wheel. At the bottom of the window, you can browse the different pages of the source .

- - -
- - - -

- menu grants - access to the following functions:

- - - This option lets you control the superimposition of measure numbers for - the displayed source. Measure numbers appear in the - center of the corresponding measure. - Measure - numbers can also be shown or hidden via the keyboard ('B' for the currently - active window, 'Shift+B' for all facsimile - windows). - - This entry triggers a command to adjust zoom-level of the source to fit - the current window size. - - This menu entry lets you show or hide existing layers in the score, if there are any provided by the edition. - These could include, for example, colored markings to visually highlight - autograph additions in facsimiles or similar features. - - -
-
- - - -

The menu provides access to following functions:

- - - This option lets you display Critical Report annotations as annotation symbols superimposed on the facsimies . The user can also filter - annotations by priority and category (see below). In each source, only annotations relating to that source are shown. If you mouse over an annotation symbol, a tooltip appears showing additional information concerning the annotation. Click on the symbol to open the annotation in a separate window. - - This sub-menu shows all priorities (if any) of annotations contained in - the current source and lets you activate/de-activate their display in the - facsimile view. - - This sub-menu shows all categories (if any) of annotations contained in the current source and lets you activate/de-activate their display in the facsimile view. - -
-
- - - -

The menu - provides access to following functions:

- - - This option opens a dialog allowing you to enter movement and measure - number you want to be displayed. - - This sub-menu shows all priorities movements contained in the current - source. Selecting an item will load the respective first page. -
- - + +
- - -

Selecting from - Menu shows the - XML data of the current item. A couple of controls are added to the corresponding - , being:

+ + +

In the there are the following options in the .

- This is the - - button that lets you decrease font size in the - + -Button - This is the - - button that lets you increase font size in the - + -Button - The - - button lets you show and hide the line numbers on the left hand side - of the . + -Button
- - - -
- - - -

Selecting from - Menu shows readings or individual annotations from the Critical Report of the current item. The default appearance is a list of all annotations with four columns for following annotation detail:

- - - Indicates the order of the annotations. - - Gives the title of the annotation; often used to give a first impression of the annotation's subject matter. - - Indicates the categories assigned to a given annotation. - - gives the priority assigned to a given annotation. - -

Clicking on a column head will resort the list on the basis of this columns data, a seconnd click on the same column head will reverse the sort order. When hovering over a column head a arrowhead will appear on the right edge of the column title, giving access to a context menu that allows for:

- - setting sort order. - showing/hiding columns. - applying a filter on the respective column. - -

Double-clicking on an annotation entry in the list will switch to a focused view of all the annotation's details. This again allows for three different kinds of display, available through the menu added to the . All available display modes offer complete annotation text and metadata but differ in the way the present corresponding sources as follows:

- - - presents images of all corresponding sources in an overview grid, double-clicking a single item shows this item in (see below). - - shows the respective source detail maximized to the annotation view's boundaries; arrow heads to left and right allow for stepping through all images. Double-clicking returns to (see above) or (see below), whichever you entered this view from. - - Gives a list providing corresponding and . - - -

Moreover following controls are added to :

-
- -

- - Returns the view to the general list of annotations.

-
-
- -

- - Moves to the previous annotation with respect to filters and sort options applied in .

-
-
- -

- - Moves to the next annotation with respect to filters and sort options applied in .

-
+ +
+ + + +

With the sub-item from the menu you can change the readings or the individual ones Open annotations from the critical report of this work. + Some editions also offer an entry to the critical report as a topic in the . + The header of the critical report can have the following entries. + + + Shows the running number of the annotations. + + Title of the annotation, which clarifies the subject of the annotation. + + Categories that can be assigned to an annotation. + + Priority that can be assigned to an annotation. + + Source(s) in which the annotation occurs. + +

+

Clicking on a header category rearranges the data in ascending or descending order. + An arrow in the right corner of the header when mouse-over opens a context menu with the following setting options: + + Setting the order. + Show/hide individual header entries. + Apply a filter to the respective column. + +

+

Double-clicking on an entry in the annotation list opens the detailed view of the annotation. + In the under the associated sources can be arranged as follows. + + + Shows the images from all associated sources in a grid. By double-clicking on an individual object, it can be displayed in the (see below). + + Shows the source snippet to which the annotation refers. + With a double click you can go back to the (see above) or ( see below). + + List with and . + +

+

The contains the following tools.

- -

- - Opens detail view of all sources corresponding to the currently selected annotation.

+ + (Return to)
- -

- - Only available when has been operated before, closes all respective windows.

+ + from the annotation list.
- -
- -
- - - - - -
- Working with annotations -

Annotations from an edition's Critical Report can be accessed in different ways through . (1) Icons displayable in the sources already provide a great deal of information as tooltip and allow accessing the complete Critical Report by double-clicking the icon. (2) The complete Critical Report usually is available through a work object's .

-

Moreover provides additional means for adding accessing individual annotations by assigning them and a . The specific use of these options depends on the applicable edition guidelines, for example in terms of the categories actually used. Therefore, the following descriptions should not be considered complete documentation but simply an introduction to the basic concepts.

-
- - A sample screenshot with annotation icons displayed in a source and tooltip of a single annotation. -
-
- - - -

An annotations gives a hint towards its relevance for the edition. Visualization of an annotation's in is achieved by color-coding the symbols:

- -

- Priority 1 annotations deal with key edition-related issues of potential interest to all readers of the edition and are denoted by a completely red symbol.

-
-
- -

- Priority 2 annotations deal with important aspects of the edition which are, however, not of major importance to the edition as such. These annotations are indicated by progressively red-to-yellow symbols.

+ + : Opens the detailed view of all sources related to the currently selected annotation.
- -

- Priority 3 annotations include observations from the editor, which typically serve only to document sources and are of no - real relevance to the editorial work. These are represented by yellow symbols.

+ + : Only available if was previously run.
-
- - - -

Annotations are typically assigned to one or more , each of which may have its own symbol. These symbols are likewise displayed in the color coded box when displaying annotation icons in the . It is thus possible to determine the type of annotation content by its symbol. -

-

The annotation categories that are actually available depend on the edition. Typical examples include slur placement, expressive marking or articulation.

-
- - - Category: - Symbol in the facsimile: - - - Score - - - - - - - - - - Expressive marking - -
- - - -
-
-
- - Choral text - -
- - - -
-
-
- - Combination of multiple categories - -
- - - -
-
-
-
- Examples of symbols for annotation categories. -
-
- - -
- Filtering -

Filtering the display of annotations is both possible in the menu and . For respective descriptions see the corresponding sections of this document.

-

All annotations belonging to at least one of the selected categories are shown in the facsimile. Please note that filtering by multiple categories will yield all annotations assigned to at least one of these categories; filtering for annotations assigned to all selected categories is not possible.

-
- - -
- Help (Edirom User Manual) -

The Help (Edirom User Manual) window is (in contrast to content related windows) a stand-alone window and can only be opened once. Clicking the button several times - will toggle show/hide for the help window, respectively bringing it to the foreground if hidden behind other windows.

- -
- - - - + + +
+ Working with Annotations +

Annotations that come from an edition's Critical Report can be opened in different ways in . + (1) Symbols that are already displayed in the source already provide a wide range of information. The complete critical report can also be accessed by double-clicking. + (2) The complete critical report of an edition is usually available as under the menu item in the available. As already mentioned above, some editions also offer an entry into the critical report as a topic in the .

+

Furthermore, provides the option to create annotations in and . + The use of these options depends on the edition guidelines (e.g. the categories that were actually used). + Therefore, the following description should not be viewed as a complete documentation, but rather as an introduction to the basic concepts of this consideration.

+
+ + An example screenshot of an annotation icon, showing the tooltip of a single annotation. +
+ + +
+ +

A gives an indication of the importance of the annotation. + The visualization of the in the is achieved by color coding the symbols:

+
+ +

Priority 1 Annotations refer to the edition-specific key issues and are marked red.

+
+
+ +

Priority 2 Annotations refer to important aspects of the edition that are not of the utmost importance for the edition and are marked orange.

+
+
+ +

Priority 3 Annotations contain editorial observations that are normally only of interest to the document sources. These annotations are marked yellow.

+
+
+ + +
+ +

Annotations can be associated with one or more , each with its own icon. + These symbols are usually also displayed in the color of the coded box in which the annotation symbol is in the . + This makes it possible to capture the type or content of the annotation more quickly using the symbol.

+

The available annotation categories depend on the specific edition. + Typical examples of annotations are bow placement, identification of expressions or articulation.

+
+ + + Category + Symbol in facsimile + + + score + +
+ + + +
+
+
+ + Expressive labeling + +
+ + + +
+
+
+ + Choral Text + +
+ + + +
+
+
+ + Combination of different categories + +
+ + + +
+
+
+
+ Example symbols for categories in annotations. +
+
+
+ \ No newline at end of file