Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
English

Pagetitle
Features of the Source View
Features of the Source View

Syntax Highlighting

...

Tag elements (attributes, values, etc.) as well as comments in the Source View are highlighted differently to facilitate orientation in the source code and detection of syntax errors. You can customize the syntax highlighting in the editor-relevant preferences.

Unlimited Undo and Redo

...

To undo or redo a change made to a document, click “Edit >

...

 Undo” or “Edit 

...

Redo” in the menu bar above. Alternatively, right-click in the Editor Field and select the corresponding entry “Undo Text Change”. You can undo and redo every change made to a file for the entire editing session.

Node Selection

Depending on the position of the cursor in the editor, the node selection indicator highlights the corresponding tags as well as the lines that include a node in the vertical ruler in the left area of the Source View.

Comment toggling and block commenting and uncommenting

...

You can toggle an XML comment on and off by right-clicking and selecting “Source 

...

Toggle Comment”. To comment on a section of source code, right-click on the selected area and select “Source 

...

Add Block Comment”. To remove a comment, select “Source 

...

Remove Block Comment”.

As-you-type Validation

...

While editing the document, errors found in the general XML syntax (such as missing quotes, missing brackets, or missing end tags) as well as validation errors (if a schema is specified) are indicated by red wavy underlining. A red icon at the top of the vertical ruler in the right area of the Source View will appear if the Document contains any errors. To find a description of the error, move your mouse cursor over the red marks shown in the vertical ruler in the right area of the Source View. A yellow icon indicates a warning.

Image Modified

Noprint
As-you-type Validation

Smart Insert

Typing elements and comments is supported by a Smart Insert mode: When you type an element, Smart Insert automatically completes the corresponding closing tag. Similarly, when you type the beginning of an XML

...

comment <! --, Smart Insert completes the ending of the comment -->. The cursor is left in the middle of the comment tag so that you can proceed directly typing in the comment text. In the same line, opening quotes in attributes are completed with closing quotes while the cursor is left between them so you can directly start typing the value of the attribute. To toggle the Smart Insert mode on and off, click “Edit 

...

Smart Insert Mode” in the menu bar and tick or untick the check mark.

Hover Help 

...

Hover Help is displayed when users move the mouse cursor over an element or an attribute. It displays the content model of the current element or attribute and additional documentation information if included in the associated schema. Moving the mouse cursor over text that has been marked with red wavy underlining will display a description of the current problem. You can modify the Hover Help preferences in the relevant editor preferences.

Image Modified

Noprint
Hover Help

 

Content Assist

...

When typing the opening

...

bracket of an element in the Source View field, Content Assist provides you with a list of suggested elements allowed at this position. You can activate Content Assist by clicking “Edit 

...

Content Assist” in the menu bar at the top. When activating Content Assist while the cursor is at an attribute position, a list of suggested attributes allowed at this position is provided. Proposals come from a referenced content model if a schema is specified for the document or through the XML Catalog. You can modify the Content Assist preferences in the editor relevant preferences.

Quick Fix

Select “Edit 

...

Quick Fix” in the menu bar on top to see a list of suggested corrections when positioning the cursor on a text section text that has been marked with red wavy underlining. Alternatively, right-click on the underlined text and select “Quick Fix”. If there are no problems or warnings at the selected position, Quick Fix proposals are not available.

Formatting

To make the XML document easier to read and better for printing, you can change the formatting options in the editor relevant preferences. You can apply formatting to the whole document by right-clicking in a non-highlighted area in your document and selecting “Source 

...

Format”. To apply formatting to a highlighted area only, right-click in the selected area and select “Source 

...

Format Active Elements”.

Cleanup

Simple errors in the XML document such as missing required attributes, missing start or end tags, or unquoted attributes can be corrected with XML Cleanup. You can open the “Cleanup” dialog box by right-clicking in the Editor and selecting “Source 

...

Cleanup Document”. Alternatively, you can find it in the menu bar under “XML >

...

 Source Cleanup Document”. Afterwards, set your Cleanup preferences in the dialog box; you can further select ’Format source’ in the box to apply formatting to the document.

Team and Local History

A local edit history of an XML document is maintained when you create or modify the document. This history is accessible via “Team 

...

Show Local History” in the context menu. Each time you edit and save the file, a copy is saved so that you can replace the current file with a previous edit or even restore a deleted file. You can also compare the contents of all the local edits. You can also “Apply Patch(es)” after selecting “Team” in the context menu. Select the resource (clipboard, file, URL or workspace) where the patch was generated in the “Patch Input Specification” dialog. This resource should contain the same file revisions as the line-up on which the patch was generated. For more information, please see the Eclipse

...

documentation http://www.eclipse.org/documentation/

Preferences

You can edit XML Editor-relevant preferences by right-clicking in the Source View editor and selecting “Preferences”. The following preferences can be edited:

  • Highlighting of the syntax elements: Expand the tree “XML 

...

  • XML Files >

...

  •  Editor” on the left of the dialog box “Preferences” and select “Syntax Coloring”.
  • Hover Help: Expand the tree “General 

...

  • Editors” to the left of the dialog box “Preferences” and then select “Structured Text Editors”. In the “Structured Text Editors” dialog box, select the “Hovers” Tab and tick the requested modifier preferences.
  • Content Assist: Expand the tree “XML 

...

  • XML Files 

...

  • Editor” on the left of the dialog box “Preferences” and select “Content Assist”. There you can choose the appropriate settings.
  • Formatting: Expand the tree “XML 

...

  • XML Files” on the left of the dialog box “Preferences” and select “Editor”. In this dialog box you can choose and check the respective settings of the formatting function.

For more information, please see the Eclipse documentation:

http://www.eclipse.org/documentation/

German

Pagetitle
Funktionen der Quelle-Ansicht
Funktionen der Quelle-Ansicht

Syntaxhervorhebung

Elemente wie Attribute und Werte sowie Kommentare werden in der Quelle-Ansicht unterschiedlich hervorgehoben, um die Orientierung im Quelltext und die Entdeckung von Syntaxfehlern zu vereinfachen. Sie können die Syntaxhervorhebung in den Editor-relevanten Benutzervorgaben anpassen.

Unbegrenztes Rückgängigmachen und Wiederholen

Um in einem Dokument gemachte Änderungen rückgängig zu Machen oder zu wiederholen, Klicken Sie “Bearbeiten > Rückgängig” oder “Bearbeiten > Wiederholen” in der Menüleiste. Alternativ können Sie in der Editor-Sicht rechtsklicken und den entsprechenden Menüpunkt “Textänderungen rückgängig machen” auswählen. Sie können alle Änderungen, die Sie über die gesamte Sitzung hinweg an einer Datei vorgenommen haben, rückgängig machen und beliebig oft wiederholen.

Knotenauswahl

Abhängig von der Cursorposition im Editor hebt die Knotenauswahl die entsprechenden Tags sowie die Zeilen, die ein Knoten einschließt, in einer senkrechten Leiste am linken Rand der Quelle-Ansicht hervor.

Kommentar umschalten und Blockkommentar hinzufügen oder entfernen

Sie können einen XML-Kommentar durch Rechtsklick und Auswahl von “Quelle > Kommentar umschalten” ein- oder ausblenden. Um einen Abschnitt des Quelltextes zu kommentieren, rechtsklicken Sie den ausgewählten Bereich und wählen Sie “Quelle > Blockkommentar hinzufügen”. Um einen Kommentar zu entfernen, wählen Sie “Quelle > Blockkommentar entfernen”.

Echtzeit-Validierung

Während Sie das Dokument bearbeiten, werden Fehler in der allgemeinen XML- Syntax (wie fehlende Anführungszeichen, Klammern oder schließende Tags) ebenso durch rote wellenförmige Unterstreichung angezeigt wie Validierungsfehler (wenn ein Schema spezifiziert ist). Ein rotes Symbol am oberen Ende der senkrechten Leiste am rechten Rand der Quelle-Ansicht erscheint, wenn das Dokument Fehler enthält. Um eine Fehlerbeschreibung zu erhalten, bewegen Sie den Mauszeiger über die roten Symbole, die in der senkrechten Leiste am rechten Rand der Quelle-Ansicht angezeigt werden. Ein gelbes Symbol steht für eine Warnung.

 

Image Added

Noprint

Echtzeit-Validierung

Intelligenter Einfügemodus

Die Eingabe von Elementen und Kommentaren wird durch den Intelligenten Einfügemodus unterstützt: Wenn Sie ein Element eingeben, vervollständigt der Intelligente Einfügemodus automatisch das schließende Tag. In ähnlicher Form wird beim Beginnen eines XML-Kommentars mit <!-- dieser durch das schließende Tag --> vervollständigt. Der Cursor bleibt dabei zwischen den Kommentar-Zeichen, so dass Sie direkt mit der Eingabe des Kommentartextes fortfahren können. Auf dieselbe Weise werden öffnende Anführungszeichen durch schließende Anführungszeichen vervollständigt, während der Cursor dazwischen bleibt, so dass Sie direkt mit der Eingabe des Attributswerts fortfahren können. Um den Intelligenten Einfügemodus ein- oder auszuschalten, wählen Sie “Bearbeiten > Intelligenter Einfügemodus” in der Menüleiste und wählen Sie die gewünschte Einstellung aus.

QuickInfo 

Die QuickInfo wird angezeigt, wenn Sie den Mauszeiger über ein Element oder Attribut ziehen. Sie zeigt das Inhaltsmodell des aktuellen Elements oder Attributs sowie zusätzliche Dokumentationsinformationen an, wenn das assoziierte Schema das Element oder Attribut beinhaltet. Durch Ziehen des Mauszeigers über einen Textabschnitt mit einer roten wellenförmigen Unterstreichung wird eine Beschreibung des Problems angezeigt. Sie können die Einstellungen für die QuickInfo in den Editor-relevanten Benutzervorgaben verändern.

Image Added

Noprint

QuickInfo

Inhaltshilfe

Wenn Sie die öffnende Klammer < eines Elements in der Quelle-Ansicht eingeben, blendet Ihnen die Inhaltshilfe eine Liste vorgeschlagener Elemente ein, die an dieser Position zulässig sind. Sie können die Inhaltshilfe durch Auswahl von “Bearbeiten > Inhaltshilfe” in der Menüleiste aktivieren. Wenn Sie die Inhaltshilfe aktivieren, während sich der Cursor an der Position für ein Attribut befindet, wird eine Liste vorgeschlagener Attribute eingeblendet, die an dieser Position zulässig sind. Die Vorschläge kommen von einem referenzierten Inhaltsmodell, wenn ein Schema für das Dokument festgelegt ist, oder aus dem XML-Katalog. Sie können die Inhaltshilfe in den Editor-relevanten Benutzervorgaben anpassen.

Schnellkorrektur

Wählen Sie “Bearbeiten > Schnellkorrektur” in der Menüleiste, um eine Liste vorgeschlagener Korrekturen einzublenden, nachdem Sie den Cursor auf einen Textabschnitt positioniert haben, der mit einer roten wellenförmigen Unterstreichung angezeigt wird. Alternativ können Sie den unterstrichenen Text rechtsklicken und “Schnellkorrektur” auswählen. Wenn an der ausgewählten Position keine Probleme oder Warnungen vorliegen, sind keine Vorschläge der Schnellhilfe verfügbar.

Formatierung

Um das XML-Dokument lesbarer und zur Vorbereitung des Drucks zu gestalten, können Sie die Formatierungsoptionen in den Editor-relevanten Benutzervorgaben ändern. Sie können die Formatierung für das gesamte Dokument durch Rechtsklicken eines nicht hervorgehobenen Bereichs Ihres Dokuments und Auswahl von “Quelle > Formatieren” anpassen. Um die Formatierung nur für einen hervorgehobenen Bereich anzupassen, rechtsklicken Sie in den ausgewählten Bereich und wählen Sie “Quelle > Aktive Elemente formatieren”.

Dokument bereinigen

Einfache Fehler im XML-Dokument wie fehlende notwendige Attribute, fehlende öffnenden oder schließende Tags oder Attribute ohne Anführungszeichen können durch eine XML-Bereinigung korrigiert werden. Sie können den Assistenten “Dokument bereinigen” durch Rechtsklicken im Editor und Auswahl von “Quelle > Dokument bereinigen” öffnen. Alternativ können Sie “XML > Quelle > Dokument bereinigen” in der Menüleiste auswählen. Afterwards, set your Cleanup preferences in the dialog box; you can further select ’Format source’ in the box to apply formatting to the document.

Team und lokale Bearbeitungshistorie

Die lokale Bearbeitungshistorie eines XML-Dokuments wird aufrechterhalten, wenn Sie ein Dokument erstellen oder bearbeiten. Diese Historie ist “Team > Lokales Protokoll anzeigen” im Kontextmenü verfügbar. Jedes Mal, wenn Sie die Datei bearbeiten und speichern, wird eine Kopie gespeichert, so dass Sie die aktuelle Datei durch eine frühere Bearbeitung ersetzen oder sogar eine gelöschte Datei wiederherstellen können. Sie können außerdem die Inhalte aller lokalen Bearbeitungen vergleichen. Außerdem können Sie unter “Team” im Kontextmenü einen “Patch anwenden”. Wählen Sie im Assistenten “Patch-Eingabespezifikation” die Position der Ressource (Zwischenablage, Datei, URL oder Arbeitsbereich) aus, an der der Patch generiert wurde. Diese Ressource sollte dieselben Datei-Revisionen beinhalten wie die Zusammenstellung, auf Basis derer der Patch generiert wurde. Für weitere Informationen, siehe die Eclipse-Dokumentation:

http://www.eclipse.org/documentation/

Benutzervorgaben

Sie können die XML-Editor-relevanten Benutzervorgaben durch Rechtsklicken in der Quelle-Ansicht und Auswahl von “Benutzervorgaben” bearbeiten. Die folgenden Einstellungen können bearbeitet werden:

  • Farbgebung für Syntax: Klappen Sie den Baum “XML > XML-Dateien > Editor” auf der linken Seite im Assistenten “Einstellungen” aus und wählen Sie “Farbgebung für Syntax”.

  • QuickInfo: Klappen Sie den Baum “Allgemein > Editoren > Editoren für strukturierten Text” auf der linken Seite im Assistenten “Einstellungen” aus. Wählen Sie im Assistenten “Editoren für strukturierten Text” den Reiter “QuickInfo” und wählen die gewünschten Einstellungen aus.

  • Inhaltshilfe: Klappen Sie dem Baum “XML > XML-Dateien > Editor” auf der linken Seite im Assistenten “ Einstellungen” aus und wählen Sie “Inhaltshilfe”.

  • Formatierung: Klappen Sie den Baum “XML > XML-Dateien” auf der linken Seite im Assistenten “Einstellungen” aus und wählen Sie “Editor”.

Für weitere Informationen, siehe die Eclipse-Dokumentation:

http://www.eclipse.org/documentation/