Acrolinx IQ. Acrolinx Plug-in for Adobe CQ Installation Guide 2.10

Transkript

1 Acrolinx IQ Acrolinx Plug-in for Adobe CQ Installation Guide 2.10

2 2 Inhalt Übersicht 3 Informationen über dieses Handbuch...3 Acrolinx and CQ Editor...3 Installation 4 Konfigurieren von Single Sign-on...4 Konfigurieren der SSO-Eigenschaften...5 Hochladen und Installieren des Acrolinx-Plug-in-Pakets...6 Aktivieren des Acrolinx-Plug-ins...6 Konfigurieren der Verbindung mit Acrolinx Server...9 Aktualisieren des Acrolinx-Plug-ins...10 Konfiguration 11 Konfigurieren des Plug-ins im Sidekick...11 Festlegen der standardmäßigen Prüfoptionen...12 Festlegen der im Korrekturdialog geprüften Komponenten...13

3 3 1 Übersicht Informationen über dieses Handbuch Verwendungszweck Das Acrolinx Plug-in für Adobe CQ Installationshandbuch enthält Informationen zur Installation und Konfiguration des Acrolinx Plug-in für Adobe CQ. Zielgruppe Das Acrolinx Plug-in für Adobe CQ Installationshandbuch richtet sich an technische Mitarbeiter, die das Acrolinx Plug-in für Adobe CQ installieren, konfigurieren und verwalten. Acrolinx und CQ Editor Sie können Acrolinx in CQ Editor integrieren, damit Sie die Inhalte beim Bearbeiten ganzer Seiten oder einzelner Abschnitte im Rich Text Editor prüfen können. Weitere Informationen über CQ Editor finden Sie auf der Adobe CQ-Website. Das Acrolinx Plug-in für Adobe CQ wurde mit CQ Editor Version 5 getestet. Andere Versionen können funktionieren, wurden aber nicht getestet. Das Acrolinx Plug-in für Adobe CQ funktioniert in den meisten Webbrowsern, die von Adobe CQ unterstützt werden, mit Ausnahme von Google Chrome und Apple Safari. In diesen beiden Webbrowsern kann aktuell das Kontextmenü nicht zum Bearbeiten der Markierungen verwendet werden.

4 4 Installation 2 Installation Sie installieren das Acrolinx Plug-in für Adobe CQ, indem Sie das Acrolinx-Plug-in-Paket im Adobe CRX-Paketmanager hochladen und installieren. Um die Installation des Acrolinx-Plug-ins abzuschließen, müssen Sie außerdem verschiedene Änderungen in CRX Development Environment Lite (CRXDE Lite) und der Adobe CQ5 Web Console vornehmen. Die Installation setzt sich aus folgenden Hauptschritten zusammen: 1. Aktivieren von Single Sign-on für Acrolinx. 2. Herunterladen des Installationspakets für den Acrolinx Plug-in für Adobe CQ. 3. Hochladen und installieren des Installationspakets für das Acrolinx Plug-in für Adobe CQ. 4. Konfigurieren Sie die Verbindung mit dem Acrolinx-Server. Konfigurieren von Single Sign-on Wenn Ihre Webanwendungen in einer Single Sign-on-Umgebung ausgeführt werden, können Sie den Acrolinx Plug-in für Adobe CQ so konfigurieren, dass er ebenfalls in dieser Umgebung funktioniert. Sie konfigurieren Single Sign-on, indem Sie die CQ5 Web Console und die Hauptserver-Eigenschaften von Acrolinx bearbeiten. Was ist Single Sign-on? Single Sign-on (SSO) ist ein Verfahren zur Benutzerauthentifizierung. Wenn SSO verwendet wird, müssen Benutzer ihre Anmeldedaten nur einmal eingeben, um auf mehrere Anwendungen zugreifen zu können. So wird gewährleistet, dass Benutzer sich nicht jedes Mal erneut anmelden müssen, wenn sie die Anwendung wechseln. Netzwerkadministratoren können SSO so konfigurieren, dass Benutzer nur auf bestimmte Anwendungen zugreifen können. Web SSO funktioniert nur mit Anwendungen, auf die mit einem Webbrowser zugegriffen wird. Die Anfrage für den Zugriff auf die Webressource wird dabei entweder von einer Komponente im Webserver oder der Anwendung selbst abgefangen. Unautorisierte Benutzer werden zu einem Authentifizierungsdienst umgeleitet und erhalten nur nach erfolgreicher Authentifizierung Zugriff. Welche Single Sign-on-Methoden werden von Acrolinx unterstützt? Sie können Acrolinx so konfigurieren, dass nach einem SSO-Identifier im Header der Anfrage gesucht wird, die an den Webbrowser übermittelt wird. Wie interagieren Acrolinx und Adobe CQ bei der Authentifizierung der Benutzer? Wenn sich Benutzer in Adobe CQ anmelden und eine Prüfung mit Acrolinx durchführen, werden die Anmeldedaten an Acrolinx Server weitergeleitet. Wenn der Benutzer bereits vorhanden ist, sind keine weiteren

5 5 Schritte erforderlich. Wenn der Benutzer noch nicht vorhanden ist, wird er automatisch in der Acrolinx-Datenbank erstellt und erhält dabei dieselben Anmeldedaten, die zur Anmeldung in Adobe CQ verwendet wurden. Konfigurieren der SSO-Eigenschaften Um Acrolinx in Ihrer Single Sign-on-Umgebung zu integrieren, müssen Sie Acrolinx Server so konfigurieren, dass nach dem SSO-Identifier im Request-Header gesucht wird. â So konfigurieren Sie die SSO-Eigenschaften 1. Öffnen Sie die Hauptserver-Eigenschaftendatei und fügen Sie die folgende Eigenschaft hinzu: singlesignon.method=header 2. Fügen Sie die folgende Eigenschaft hinzu, um das generische Passwort zu konfigurieren, das in Ihrer SSO-Umgebung verwendet wird. singlesignon.genericpassword=<passwort> Beispiel: singlesignon.genericpassword=sus5abut Durch generische Passwörter müssen Benutzer nicht in jeder Anwendung ein eigenes Passwort anlegen. Benutzer von Acrolinx werden ohne Passwörter erstellt, wenn Sie ein generisches Passwort konfigurieren. Sie müssen ein gesondertes Passwort für alle Benutzer konfigurieren, die Zugriff auf die Term Contribution benötigen. Term Contribution ist kein Bestandteil des Supports von Acrolinx für Single Sign-on. Wenn Sie einen Benutzer bearbeiten und im Dashboard ein Passwort hinzufügen, wird dieses Passwort für die Term Contribution verwendet. Bei der Authentifizierung des Benutzers im Web Client wird das Passwort jedoch ignoriert. Stattdessen wird das generische Passwort verwendet. 3. Fügen Sie die folgende Eigenschaft hinzu, um Single Sign-on auf eine bestimmte Gruppe konfigurierbarer Hosts zu begrenzen: singlesignon.allowedremoteaddresses=<adressen> Im folgenden Beispiel wurde eine kommagetrennte Liste sicherer Remote-Adressen mithilfe regulärer Ausdrücke eingegeben: singlesignon.allowedremoteaddresses=10\.10\..*\..*,192\.168\..*\..* Hinweis: Reguläre Ausdrücke müssen in der Java-Syntax für reguläre Ausdrücke eingegeben werden. Bereichsqualifizierer wie \d{1,3} werden nicht unterstützt, weil die darin enthaltenen Kommas zu Fehlern bei der Interpretation der Eigenschaft führen. 4. Fügen Sie die folgenden Eigenschaften hinzu, um die Namen der Schlüssel der Benutzernamen und Passwörter zu definieren: singlesignon.usernamekey=<benutzername_schlüssel> singlesignon.passwordkey=<passwort_schlüssel> Geben Sie die Eigenschaften wie im folgenden Beispiel ein, wenn zum Beispiel der Benutzername und das Passwort mit den Parametern username und password übermittelt werden: singlesignon.usernamekey=username singlesignon.passwordkey=password

6 6 Installation Im folgenden Beispiel sind alle Eigenschaften aufgeführt, die zur Konfiguration von SSO erforderlich sind. singlesignon.method=header singlesignon.genericpassword=sus5abut singlesignon.usernamekey=username singlesignon.passwordkey=password singlesignon.allowedremoteaddresses=10\.10\..*\..*,192\.168\..*\..* 5. Öffnen Sie die Hauptserver-Eigenschaftendatei und starten Sie den Hauptserver neu. Hochladen und Installieren des Acrolinx-Plug-in-Pakets Laden Sie das Installationspaket im Adobe CRX-Paketmanager hoch und installieren Sie es, um die Kernkomponenten des Acrolinx-Plug-ins zu installieren. Sie müssen als Administrator angemeldet sein, um diese Aktionen durchführen zu können. â So laden Sie das Acrolinx-Plug-in-Paket hoch und installieren es 1. Navigieren Sie zu Welcome Page Packages und klicken Sie auf Upload Package. Sie können auch die folgende URL in einem Webbrowser aufrufen, um den Adobe CRX-Paketmanager zu öffnen: 2. Wählen Sie im Dialogfeld Upload Package das Installationspaket des Acrolinx-Plug-ins und klicken Sie auf OK. 3. Klicken Sie auf Install, nachdem das Paket hochgeladen wurde. 4. Aktivieren Sie das Acrolinx-Plug-in (siehe "Aktivieren des Acrolinx-Plug-ins" auf Seite 6), nachdem die Installation abgeschlossen wurde. Aktivieren des Acrolinx-Plug-ins Damit die Acrolinx-Symbolleiste in CQ Editor angezeigt wird, müssen Sie das Plug-in als Abhängigkeit in der WCM Core Configuration hinzufügen. Außerdem müssen Sie Overlays der relevanten foundation-komponenten sowie Knoten für das Acrolinx-Plug-in zu jeder Komponente hinzufügen. Tipp: Sie können diese Schritte auch überspringen und das Acrolinx Plug-in mit einer auf Anfrage erhältlichen Beispielkonfiguration testen. Wenn Sie dieses Paket über den CQ-Paketmanager installieren, werden alle erforderlichen Konfigurationen automatisch hinzugefügt. Dabei werden allerdings alle anderen Konfigurationen überschrieben, die Sie möglicherweise am CQ Editor vorgenommen haben, und es werden alle verfügbaren Editierfunktionen hinzugefügt. Aus diesem Grund wird die Beispielkonfiguration nur für Testumgebungen empfohlen. Wenden Sie sich an Ihren Acrolinx-Projektberater, um das erforderliche Paket zu erhalten.

7 7 â So aktivieren Sie das Acrolinx-Plug-in 1. Öffnen Sie CRXDE Lite, indem Sie im CQ-Paktemanager auf Develop klicken, oder zu Welcome Page CRXDE Lite navigieren. Sie können auch die folgende URL in einem Webbrowser aufrufen, um CRXDE Lite zu öffnen: 2. Fügen Sie das Acrolinx-Plug-in als eine Abhängigkeit der Haupt-Client-Bibliothek hinzu. a) Wählen Sie den folgenden Ordner aus Ihrer Bibliothek aus: /apps/wcm/core/clientlibs/edit Wenn der Ordner noch nicht vorhanden ist, erstellen Sie zunächst das Verzeichnis /apps/wcm/core/clientlibs/, speichern Sie die Änderungen und kopieren Sie anschließend den Ordner /libs/wcm/core/clientlibs/edit nach /apps/wcm/core/clientlibs/. Klicken Sie mit der rechten Maustaste auf einen Knoten oder Ordner, um Elemente zu kopieren oder einzufügen. Wählen Sie im Kontextmenü die Option Copy oder Paste. b) Markieren Sie den Ordner edit und doppelklicken Sie auf der Registerkarte Properties auf die Zeile Dependencies. c) Klicken Sie im Fenster Edit Dependencies auf +, fügen Sie die Abhängigkeit acrolinx.rteplugin hinzu und klicken Sie auf OK, um die Änderungen zu speichern. Hinweis: Das Acrolinx-Plug-in ist jetzt als Element in der schwebenden Toolbar (Sidekick) von CQ Editor aktiviert. In dieser Konfiguration prüft das Plug-in immer die gesamte aktive Seite. Wenn Sie die Inhalte einzelner textbasierter Komponenten prüfen möchten, müssen Sie das Acrolinx-Plug-in zu jeder dieser Komponenten hinzufügen. Fahren Sie dafür mit den optionalen Schritten 3 und 4 fort. Andernfalls fahren Sie mit Schritt 5 fort. 3. (Optional) Fügen Sie das Acrolinx-Plug-in als CQ Editor-Plug-in für jede textbasierte Komponente hinzu. Gehen Sie zum Beispiel folgendermaßen vor, um das Acrolinx-Plug-in zur Komponente Text hinzuzufügen: a) Suchen Sie den folgenden Knoten in Ihrer Bibliothek: /libs/foundation/components/text/ Dieser Knoten definiert das Verhalten und Aussehen der CQ Editor-Komponente Text. b) Kopieren Sie den Knoten und fügen Sie ihn an der folgenden Stelle wieder ein: /apps/foundation/components/ Wenn der Ordner noch nicht vorhanden ist, erstellen Sie zunächst das Verzeichnis /apps/foundation/components/, speichern Sie die Änderungen und fügen Sie anschließend den Knoten ein. c) Suchen Sie im soeben eingefügten Knoten den folgenden Unterknoten: /apps/foundation/components/text/dialog/items/tab1/items/text/rteplugins

8 8 Installation d) Erstellen Sie einen Unterknoten mit dem Namen acrolinx unter dem Knoten rteplugins und geben Sie nt:unstructured ein. Klicken Sie mit der rechten Maustaste auf einen Knoten oder Ordner, um einen Knoten zu erstellen. Wählen Sie im Kontextmenü die Option Create Create Node... e) Wählen Sie den soeben erstellten Knoten aus und fügen Sie eine neue Eigenschaft mit den folgenden Attributen hinzu: Name Type Value features String check, options, remove-flags, report, help, about Klicken Sie beim Hinzufügen der Eigenschaft auf die Schaltfläche Multi, wenn Sie mehrere Werte eingeben. Sie können Werte auslassen, wenn Sie die entsprechenden Schaltflächen nicht anzeigen möchten. Alternativ können Sie auch * eingeben, damit alle in der aktuellen Version des Plug-ins konfigurierten Funktionen übernommen werden. Achten Sie darauf, nicht die Schaltfläche Multi zu drücken, wenn Sie den Wert * verwenden. Bearbeiten Sie die unterste Zeile auf der Registerkarte Properties und klicken Sie auf Add, um neue Eigenschaften hinzuzufügen. Geben Sie die Werte im angezeigten Dialogfeld ein, wenn Sie mehrere Werte hinzufügen. Klicken Sie auf +, um jeden der Werte hinzuzufügen. f) Wiederholen Sie diese Schritte (beginnend mit Schritt a ) für die Komponenten Text Image und Table, die Sie von den folgenden Orten kopieren können: Text Image /libs/foundation/components/textimage/ Sie kopieren diesen Knoten in den Ordner /apps/foundation/components/ und fügen einen Knoten mit den Namen acrolinx unter den Knoten /apps/foundation/components/textimage/dialog/items/tab1/items/text/rteplugins ein. Table /libs/foundation/components/table/ Sie kopieren diesen Knoten in den Ordner /apps/foundation/components/ und fügen einen Knoten mit den Namen acrolinx unter den Knoten /apps/foundation/components/table/dialog/items/table/rteplugins ein.

9 9 4. (Optional) Fügen Sie das Stylesheet des Acrolinx-Plug-ins als externes Stylesheet für jede textbasierte Komponente hinzu. Gehen Sie zum Beispiel folgendermaßen vor, um das Stylesheet als externes Stylesheet für die Komponente Text hinzuzufügen: a) Suchen Sie den folgenden Knoten: /apps/foundation/components/text/dialog/items/tab1/items/text/ b) Erstellen Sie einen Unterknoten mit dem Namen externalstylesheets unter dem Knoten text und geben Sie nt:unstructured ein. c) Doppelklicken Sie auf den soeben erstellten Knoten und fügen Sie eine neue Eigenschaft mit den folgenden Attributen hinzu: Name Type Value acrolinx-cq-rte-plugin-content String /apps/acrolinx/clientlib/css/acrolinx.css d) Wiederholen Sie diese Schritte (beginnend mit Schritt a ) für die Komponenten Text Image und Table. Fügen Sie den Knoten externalstyle sheets an den folgenden Orten ein: Text Image /apps/foundation/components/textimage/dialog/items/tab1/items/text/. Table /apps/foundation/components/table/dialog/items/table/ 5. Klicken Sie auf Save All, um die Änderungen zu speichern. Die Acrolinx-Symbolleiste wird jetzt immer angezeigt, wenn Sie den Rich Text Editor verwenden. Sie wird zum Beispiel angezeigt, wenn Sie eine Textkomponente auf einer Webseite bearbeiten. 6. Konfigurieren Sie die Verbindung mit dem Acrolinx-Server. (siehe "Konfigurieren der Verbindung mit Acrolinx Server" auf Seite 9) Konfigurieren der Verbindung mit Acrolinx Server Um die Prüfungsfunktionen im Acrolinx Plug-in für Adobe CQ zu aktivieren, müssen Sie Adobe CQ so konfigurieren, dass die internen Prüfanfragen an die Installation von Acrolinx Server weitergeleitet werden. â So konfigurieren Sie die Verbindung mit Acrolinx Server 1. Öffnen Sie die Adobe CQ5 Web Console, indem Sie zu Welcome Page OSGi Console navigieren oder indem Sie die folgende URL in einem Webbrowser eingeben: 2. Klicken Sie auf die Zeile Acrolinx Adobe CQ Proxy und führen Sie im Dialogfeld die folgenden Änderungen durch: Geben Sie im Feld Acrolinx Server URL die Adresse von Acrolinx Server ein.

10 10 Installation Geben Sie im Feld Generic Password das generische Passwort ein. Dieses Passwort muss mit dem generischen Passwort übereinstimmen, das Sie in der Hauptserver-Eigenschaftendatei festgelegt haben, als Sie Single Sign-on für Acrolinx aktiviert haben (siehe "Konfigurieren von Single Sign-on" auf Seite 4). 3. Klicken Sie auf Save. Sie können Acrolinx jetzt verwenden, um Prüfungen in Adobe CQ durchzuführen. Aktualisieren des Acrolinx-Plug-ins Sie müssen alte Versionen des Plug-ins nicht deinstallieren, wenn Sie eine neue Version installieren. Sie können das neue Plug-in-Paket einfach über das bereits vorhandene installieren. Sie müssen als Administrator angemeldet sein, um diese Aktionen durchführen zu können. â So aktualisieren Sie das Acrolinx-Plug-in 1. Erstellen Sie eine Sicherungskopie der Datei apps/acrolinx/clientlib /config.js. Diese Datei enthält individuelle Anpassungen und wird bei der Aktualisierung überschrieben. 2. Navigieren Sie zu Welcome Page Packages und klicken Sie auf Upload Package. Sie können auch die folgende URL in einem Webbrowser aufrufen, um den Adobe CRX-Paketmanager zu öffnen: 3. Wählen Sie im Dialogfeld Upload Package das Installationspaket des Acrolinx-Plug-ins aus, klicken Sie auf Force Overwrite und klicken Sie anschließend auf OK. 4. Klicken Sie auf Reinstall, nachdem das Paket hochgeladen wurde. 5. Stellen Sie die Sicherung der Datei config.js wieder her. 6. Prüfen Sie, ob die Aktualisierung korrekt installiert wurde. a) Öffnen Sie eine Instanz des Rich Text Editors und klicken Sie auf Strg+F5, um die Seite zu aktualisieren. b) Klicken Sie auf die Schaltfläche About Acrolinx in der Acrolinx-Symbolleiste und prüfen Sie, ob die angezeigte Versionsnummer mit der Versionsnummer des Plug-ins übereinstimmt, dass Sie soeben installiert haben. Leeren Sie den Cache des Webbrowsers und versuchen Sie es erneut, wenn die neue Plug-in-Version nicht angezeigt wird.

11 11 3 Konfiguration Administratoren können das Plug-in konfigurieren, um es an die individuellen Anforderungen anzupassen. Diese Konfigurationen sind optional. Konfigurieren des Plug-ins im Sidekick Sie können konfigurieren, wie das Acrolinx-Plug-in in der schwebenden Toolbar (Sidekick) von CQ Editor angezeigt wird. â Soe konfigurieren Sie das Plug-in im Sidekick 1. Öffnen Sie CRXDE Lite, indem Sie im CQ-Paktemanager auf Develop klicken, oder zu Welcome Page CRXDE Lite navigieren. Sie können auch die folgende URL in einem Webbrowser aufrufen, um CRXDE Lite zu öffnen: 2. Suchen und öffnen Sie die folgende Datei in der Bibliothek: apps/acrolinx/clientlib/config.js 3. Fügen Sie in der Datei den folgenden Code hinzu oder bearbeiten Sie den bereits vorhandenen Code: acrolinx.cq.config = { sidekick : { enabled: true, features: ['check','check-with-correction-dialog','options','report','help','about'] } }; a) Setzen Sie den Wert für enabled auf false, um die Acrolinx-Registerkarte im Sidekick auszublenden. b) Löschen Sie die entsprechenden Einträge unter features, um einzelne Acrolinx-Schaltflächen zu deaktivieren. Die folgenden Einträge sind verfügbar: Option Vorschau prüfen Prüfung mit Korrekturdialog Optionen Bericht anzeigen Hilfe About Eintrag check check-with-correction-dialog options report help about Beispiel: Geben Sie den folgenden Code ein, um die Acrolinx-Registerkarte einzublenden und die Schaltflächen Optionen und Hilfe zu deaktivieren: acrolinx.cq.config = { sidekick : { enabled: true, features: ['check','report','about'] } };

12 12 Konfiguration 4. Klicken Sie auf Save All, um die Änderungen zu speichern. Festlegen der standardmäßigen Prüfoptionen Administratoren können standardmäßige Prüfoptionen festlegen, die automatisch im Plug-in gewählt werden. Dies ist in Umgebungen hilfreich, in denen Benutzer normalerweise mit demselben Dokumenttyp arbeiten (zum Beispiel Posts in einem Blog) und immer dieselben Prüfoptionen benötigen. Außerdem kann diese Funktion Fehler verhindern, die auftreten, wenn Benutzer die falschen Prüfoptionen wählen. Es gibt zwei Arten vorkonfigurierbarer Prüfoptionen: Standardmäßige Prüfoptionen, die dauerhaft vom Benutzer geändert werden können. Benutzer erhalten zwar die vorkonfigurierten Prüfoptionen, können diese aber ändern und ihre Änderungen auch speichern. Wenn ein Benutzer die Seite neu lädt oder eine neues Dokument öffnet, werden die geänderten Prüfoptionen angewendet. Standardmäßige Prüfoptionen, die temporär vom Benutzer geändert werden können. Benutzer können die vorkonfigurierten Prüfoptionen zwar ändern, diese Änderungen aber nicht speichern. Wenn ein Benutzer die Seite neu lädt oder eine neues Dokument öffnet, werden wieder die vorkonfigurierten Prüfoptionen angewendet. Sie können die standardmäßigen Prüfoptionen separat für den Sidekick und den Rich Text Editor konfigurieren. â So konfigurieren Sie die standardmäßigen Prüfoptionen 1. Öffnen Sie CRXDE Lite, indem Sie im CQ-Paktemanager auf Develop klicken, oder zu Welcome Page CRXDE Lite navigieren. Sie können auch die folgende URL in einem Webbrowser aufrufen, um CRXDE Lite zu öffnen: 2. Suchen und öffnen Sie die folgende Datei in der Bibliothek: apps/acrolinx/clientlib/config.js 3. Fügen Sie den entsprechenden Code hinzu, um die standardmäßigen Prüfoptionen zu konfigurieren. a) Fügen Sie den folgenden Code zum Modul sidekick hinzu, um die Prüfoptionen im Sidekick zu konfigurieren:,<check_setting_type> : { "language" : "<LANGUAGE_ID>", "rulesetname" : "<RULE_SET>", "clientinformation" : {}, "checkspelling" : <TRUE/FALSE>, "checkgrammar" : <TRUE/FALSE>, "checkstyle" : <TRUE/FALSE>, "checkreuse" : <TRUE/FALSE>, "harvestterms" : <TRUE/FALSE>, "termsets" : [ "<TERM_SET>", "<TERM_SET>" ], "termstatuses" : [ "<TERMINOLOGY_OPTION>" ] }

13 13 b) Fügen Sie den folgenden Code nach dem Modul sidekick hinzu, um die Prüfoptionen im Rich Text Editor zu konfigurieren: richtexteditor: { <CHECK_SETTING_TYPE> : { "language" : "<LANGUAGE_ID>", "rulesetname" : "<RULE_SET>", "clientinformation" : {}, "checkspelling" : <TRUE/FALSE>, "checkgrammar" : <TRUE/FALSE>, "checkstyle" : <TRUE/FALSE>, "checkreuse" : <TRUE/FALSE>, "harvestterms" : <TRUE/FALSE>, "termsets" : [ "<TERM_SET>", "<TERM_SET>" ], "termstatuses" : [ "<TERMINOLOGY_OPTION>" ] } } Für <PRÜFOPTIONEN_TYP> sind folgende Werte zulässig: defaultchecksettings : {, um Prüfoptionen festzulegen, die beim erstmaligen Öffnen der Acrolinx-Optionen angewendet werden. Vom Benutzer durchgeführte Änderungen werden im Cache des Webbrowsers gespeichert. checksettings : {, um Prüfoptionen festzulegen, die bei jedem Neuladen der Seite und bei jedem neuen Dokument angewendet werden. Vom Benutzer durchgeführte Änderungen werden nicht gespeichert. Für <TERMINOLOGIE_OPTION> sind folgende Werte zulässig: TERMINOLOGY_DEPRECATED zur Prüfung auf gesperrte Terme TERMINOLOGY_ADMITTED zur Prüfung auf erlaubte Terme TERMINOLOGY_VALID zur Prüfung auf gültige Terme Beispiel: acrolinx.cq.config = { sidekick : { enabled : true, features : [ 'check', 'options', 'report', 'help', 'about' ],checksettings : { "language" : "en", "rulesetname" : "SEO", "clientinformation" : {}, "checkspelling" : false, "checkgrammar" : false, "checkstyle" : true, "checkreuse" : false, "harvestterms" : false, "termsets" : [], "termstatuses" : [] } }, richtexteditor: { defaultchecksettings : { "language" : "en", "rulesetname" : "Standard_US", "clientinformation" : {}, "checkspelling" : false, "checkgrammar" : true, "checkstyle" : true, "harvestterms" : false, "termsets" : [ "Acrolinx" ], "termstatuses" : [ "TERMINOLOGY_DEPRECATED", "TERMINOLOGY_ADMITTED", "TERMINOLOGY_VALID" ] } } }; 4. Speichern Sie die Änderungen. Festlegen der im Korrekturdialog geprüften Komponenten Administratoren müssen konfigurieren, welche Komponenten einer Seite bei Prüfungen eingeschlossen werden, bevor Benutzer eine Seite mit dem Korrekturdialog prüfen. Sie legen die einzelnen Komponenten fest, indem Sie diese zur Konfigurationsdatei des Acrolinx-Clients hinzufügen. Der Client prüft nur die Inhalte der konfigurierten Komponenten. Alle anderen Komponenten werden ignoriert. Sie können auch einen benutzerfreundlichen Bezeichner für jede Komponente definieren, der dann als Kontextinformation im Korrekturdialog angezeigt wird. Dies verbessert die Benutzerfreundlichkeit und dient besonders in

14 14 Konfiguration großen Dokumenten mit vielen verschiedenen Komponenten als Navigationshilfe. â So legen Sie die Komponenten fest, die bei einer Prüfung berücksichtigt werden 1. Öffnen Sie CRXDE Lite, indem Sie im CQ-Paktemanager auf Develop klicken, oder zu Welcome Page CRXDE Lite navigieren. Sie können auch die folgende URL in einem Webbrowser aufrufen, um CRXDE Lite zu öffnen: 2. Suchen und öffnen Sie die folgende Datei in der Bibliothek: apps/acrolinx/clientlib/config.js 3. Fügen Sie ein neues Modul extraction : [ zum Modul sidekick : [ hinzu. 4. Fügen Sie den entsprechenden Code hinzu, um die Komponente und den Namen der Komponente zu definieren. { resourcetype: '*/components/<component_type>', key: '<KEY>', context: "<CONTENT_NAME>", tag: '<TAG_NAME>', name: '<DISPLAY_NAME' }, Beispiel: { }, resourcetype: '*/components/title', key: 'jcr:title', context: "header", tag: 'h2', name: 'Title' Beispiel für eine vollständige Konfiguration: acrolinx.cq.config = { sidekick : { enabled : true, features : [ 'check','check-with-correction-dialog', 'options', 'report', 'help', 'about' ], extraction : [ { resourcetype: '*/components/text', key: 'text', name: 'Text' }, { resourcetype: '*/components/title', key: 'jcr:title', context: "header", tag: 'h2', name: 'Title' }, ] }, }; Mit dieser Konfiguration prüft der Client alle Inhalte, die entweder in einer text- oder title-komponente einer Seite enthalten sind. Alle anderen Inhalte

15 15 werden ignoriert. Im Korrekturdialog werden die Komponenten mit den Namen Text bzw. Title angezeigt. 5. Speichern Sie die Änderungen.

16 16 Index Index [INDEX_ENTRY] 12 A Aktivieren des Acrolinx-Plug-ins 6 E Einleitung 3 H I Informationen über dieses Handbuch 3 K Komponenten festlegen 13 konfigurieren 11 Konfigurieren der SSO-Eigenschaften 5 Konfigurieren der Verbindung mit Acrolinx Server 9 Hochladen und Installieren des Acrolinx-Plug-in-Pakets 6