Leitfaden für Content-Profile

Mit Content-Profilen können Sie konfigurieren, wie Acrolinx Ihren Content liest. Die Content-Profile finden Sie unter Konfigurationen im Dashboard.

In diesem Leitfaden gehen wir die einzelnen Registerkarten im Bereich Content-Profile durch und erläutern die einzelnen Felder.

Anmerkung

Alle Änderungen, die Sie in Ihrem Content-Profil machen, sind sofort wirksam.

Auf der Zielseite sehen Sie eine Liste all Ihrer Content-Profile. Hier können Sie ein neues Content-Profil hochladen oder hinzufügen.

	Name des Content-Profils
	Kontextmenü des Content-Profils
	Standardmäßiges Systemprofil. Das bedeutet: Sie können an diesem Content-Profil keine Änderungen vornehmen. Sie können es jedoch kopieren oder herunterladen.

Anmerkung

Acrolinx wählt das Content-Profil mit den Kriterien aus, die am besten zu Ihrem Content passen. Wenn zwei Content-Profile genau die gleichen Kriterien haben, priorisiert Acrolinx Ihr Content-Profil gegenüber einem standardmäßigen Systemprofil.

Angenommen, Sie erstellen eine Kopie eines standardmäßigen Systemprofils und passen die Einstellungen an, aber nicht die Kriterien. In diesem Fall wählt Acrolinx Ihre Kopie und nicht das Systemprofil aus.

Allgemein

Name	Geben Sie Ihrem Content-Profil einen aussagekräftigen Namen. Sie können den Content-Typ erwähnen (z. B. HTML) oder die Integration (z. B. PowerPoint).
Beschreibung	Zusätzliche Informationen, die für dieses Content-Profil wichtig sein könnten.
Gesamten Content vertraulich prüfen	Verhindern Sie, dass Text oder Statistiken in die Acrolinx Analytics-Datenbank geschrieben werden. Weitere Informationen zu dieser Funktion finden Sie im Artikel zum Schützen von vertraulichem Content.

Kriterien

Legen Sie fest, wann Acrolinx dieses Content-Profil auf Ihre Inhalte anwenden soll.

Quellreferenz	Field type: File Path or Regular Expression Der Speicherort der Datei oder Dateien, für die das Content-Profil gilt. Sie können diese Eigenschaft verwenden, wenn keine anderen Informationen verfügbar sind, um den Dateityp zu identifizieren. Ein Dateipfad oder ein Pfadmuster als regulärer Ausdruck. Beispiel Damit das Content-Profil auf alle DITA-Dateien im Verzeichnis „user-guides“ angewendet wird, geben Sie die Eigenschaft so ein: ./user-guides/..dita Wenn Sie mehrere Verzeichnisse wie „user-guides“ und „faqs“ haben, trennen Sie diese mit dem OR-Operator „`\|`“ wie hier: ./user-guides/..dita\|./faqs/..dita
Typ	Wählen Sie Ihren Content-Typ aus dem Dropdown-Menü.
Public ID	Field type: String or Regular Expression Die Public ID eines XML-Dateityps. Beispiel Um DITA Concepts Einstellungen zuzuweisen, geben Sie die Public ID so ein: -//OASIS//DTD DITA Concept//EN<
System ID	Field type: String or Regular Expression Die System ID eines XML-Dokumenttyps. Beispiel Um DITA Concepts Einstellungen zuzuweisen, geben Sie die System ID so ein: concept.dtd
Schema	Field type: String or Regular Expression Der Name eines XML-Dokumentschemas. Beispiel Um Einstellungen zu XML-Dateien zuzuweisen, die das Schema „notes“ verwenden, geben Sie den Schema-Namen so ein: notes.xsd
Basiselement	Field type: String or Regular Expression Das Basiselement eines XML- oder HTML-Dokuments. Sie können es z. B. für einfache XML-Dokumente verwenden, die keine Dokumenttypdefinition oder kein Schema haben. Beispiel Um XML-Dateien Einstellungen zuzuweisen, die mit dem Element `<product>` beginnen, geben Sie das Basiselement so ein: product Das Basiselement für HTML-Dokumente ist immer `html`.

Erweiterte Einstellungen

Integration

Field type: String or Regular Expression

Die Signatur, die eine Acrolinx-Integration bei der Authentifizierung bei einer Acrolinx-Plattform sendet.

Sie verwenden diesen Bezeichner z. B. für individuelle Acrolinx-Integrationen, die keinen Kurznamen der Integration senden.

Anmerkung

Verwenden Sie dieses übereinstimmende Kriterium nur, wenn kein anderes Kriterium funktioniert.

Wenn Sie die Signatur als übereinstimmendes Kriterium verwenden, wird das Content-Profil nur dann angewendet, wenn Autor*innen von einem bestimmten Editor aus prüfen. Es kann nützlich sein, wenn sich der Dokumenttyp ausschließlich über den Editor bestimmen lässt.

Beispiel

Um einer Acrolinx-Integration mit der Signatur „xmF0YZzgQ233lY2tlcg“ Einstellungen zuzuweisen, geben Sie die Integration so ein:

xmF0YZzgQ233lY2tlcg

Sprache

Field type: String or Regular Expression

Die Sprache der Prüfung, wie sie von der Acrolinx-Integration angezeigt wird.

Sie können diese Eigenschaft verwenden, um die Extraktionseinstellungen je nach der Sprache des Contents zu ändern.

Beispiel

Ein mögliches Szenario wäre, dass Sie ein multilinguales XML-Format wie TMX prüfen. Sie möchten die Teile der Datei berücksichtigen, die mit der Prüfsprache übereinstimmen.

Für deutsche Segmente in einer TMX-Datei geben Sie die Sprache so ein:

de

Target

Field type: String or Regular Expression

Sie können dieses Kriterium nutzen, wenn Sie ein Content-Profil für eine bestimmtes Target anwenden wollen. Geben Sie einfach den Namen eines Targets ein.

Anmerkung

Wenn Sie noch keine Targets haben: Geben Sie den Namen eines Schreibprofils oder Prüfprofils ein. Wenn Sie ein Schreibprofil und ein Prüfprofil mit demselben Namen haben, wählt Acrolinx das Prüfprofil aus.

Extraktion

Startelement

Meist kann das Startelement auf „Include“ gesetzt werden. Das bedeutet, dass Acrolinx den gesamten Content liest.

Standardumbruch

Definieren Sie, wie der Text unterteilt werden soll, z. B. mit Satzende- oder Token-Break-Elementen.

Anmerkung

In XML-Verarbeitungseinstellungen ist der Umbruch standardmäßig auf none gesetzt. Bei Bedarf können Sie den Wert jederzeit ändern.

Ausgeschlossene Elemente markieren

Beim Verarbeiten des Texts werden Platzhalter für Ausschlusselemente eingefügt.

Diese Eigenschaft verhindert, dass ausgeschlossene Elemente falsche Schreibtipps verursachen.

Erweiterte Einstellungen

Überschüssige Leerzeichen ignorieren

Anmerkung

Diese Option ist nur für XML-Content-Profile verfügbar.

Ersetzen Sie Sequenzen von Leerzeichen durch ein einzelnes Leerzeichen.

Dies ist nützlich, wenn Ihr XML-Editor Inhalte in einem Pretty-Printed-Format an Acrolinx sendet.

Wenn Sie ein neues XML-Content-Profil einrichten wollen, sollten Sie diese Option generell auswählen.

Zugelassene externe DTDs

Field type: Regular Expression

Externe DTDs zulassen.

Diese Einstellung brauchen Sie, wenn Ihr Content-Profil für Dateien gilt, die auf externe DTDs verweisen.

Beispiel

Wenn Ihr Content-Profil für DocBook-Artikel gilt und diese Artikel die DTD „docbookx.dtd“ verweisen, müssen Sie diese DTD zulassen. Andernfalls ignoriert Acrolinx sie.

Um alle DTDs im Verzeichnis „dita“ zuzulassen, geben Sie die Eigenschaft so ein:

.*/dita/.*.dtd

Wenn Sie mehrere Verzeichnisse wie „dita“ und „doc book“ haben, trennen Sie diese mit dem OR-Operator „ |“:

.*/dita/.*.dtd|.*/doc book/.*.dtd

Konvertierung von Entitäten

Field type: String

Zeigen Sie Acrolinx, wie Sie eigene Entitäten in Ihren DTDs definiert haben.

Sie können Unicode-Zeichen auf 2 Arten eingeben:

Als Escape-Sequenz, wie z. B. \uxxxx. xxxx ist der hexadezimale Unicode-Codepoint. Zum Beispiel können Sie copyright=\u00a9 eingeben. U+00A9 ist der Unicode-Codepoint für ©.

Extraktionseinstellungen

Elementname	Name des Elements ohne Syntax. Beispiel Wenn Ihr Element `<comment>` ist, geben Sie Folgendes als Elementnamen ein: comment Sie können auch ein Element und dessen Attribute zuordnen. Verwenden Sie das folgende Format: elementName attribute=value Beispiel Sie haben folgendes Element: `<paragraph internal="true" title="Title of this paragraph"> </paragraph>`. Ihr Elementname könnte so aussehen: paragraph internal=true Tipp Verwenden Sie Platzhalter, um mehrere Elemente oder Attributwerte auf einmal abzudecken. Der folgende Elementname entspricht z. B. allen Elementen, die das Attribut `internal="true"` enthalten: Beispiel * internal=true
Filtermodus	include – Diesen Content immer prüfen – auch, wenn er in einem ausgeschlossenen Element verschachtelt ist. exclude – Diesen Content nie prüfen. empty – Diesen Content nie prüfen, aber in der grammatischen Struktur des Satzes berücksichtigen. Dies kann Text sein, der sich auf Bezeichnungen aus der Benutzeroberfläche bezieht: Hier ist ein Beispiel: Die Optionen X und Y wurden entfernt. Sie könnten nun den fett gesetzten Text ausschließen. Dies würde verhindern, dass Acrolinx die Optionsbezeichnungen prüft. Allerdings würde Acrolinx den Satz dann so lesen: Die Optionen und wurden entfernt. Für Acrolinx sieht dies wie ein Grammatikfehler aus. Wenn Sie jedoch den fett gesetzten Text als „empty“ einstellen, liest Acrolinx den Satz so: Die Optionen (empty) und (empty) wurden entfernt. In diesem Beispiel bleibt die grammatische Struktur erhalten und Acrolinx ist zufrieden. inherited - Nutzt den Filtermodus des übergeordneten Elements.
Umbruch	sentence – Wenn Sie Elemente mit Sätzen haben, die nicht mit einem Punkt enden, definieren Sie diese als Sentence-Break-Elemente. Das bedeutet, dass das Ende des Elements immer als Satzende behandelt werden soll. token – Elemente als Token Breaks zu definieren, ist sinnvoll bei Wörtern, die nicht durch ein Leerzeichen getrennt sind. Diese Einstellung definiert die Elemente, die einen Token Break verursachen sollen. Ein Token Break fügt eine Art Grenze zwischen Wörtern ein. none – Acrolinx fügt keinen Umbruch hinzu. defaultBreak – Nutzt den oben definierten Standardumbruch.
Zu extrahierende Attribute	Attribute in Ihren Elementen, die Acrolinx lesen soll. Angenommen, Sie haben ein Absatz-Element mit den Attributen title und subtitle. <paragraph internal="true" title="Title of this paragraph" subtitle="This is the subtitle of this paragraph"> </paragraph> Wenn Acrolinx den Titel und den Untertitel lesen soll, geben Sie ‚title‘ und ‚subtitle‘ zu „Zu extrahierende Attribute“ hinzu.
Eingeschoben	Behandelt das Element als separaten Satz, auch wenn es in einen anderen Satz eingebettet ist. Ein typisches Beispiel ist eine Fußnote, die mitten in einem Satz eingebettet ist: <p>This is the <footnote>This is a second sentence.</footnote> first sentence.</p> Dies kommt eher selten vor. Es ist aber trotzdem gut, davon zu wissen.

Kontext

Viele der Schreibtipps sind kontextabhängig. Ordnen Sie Ihre Elemente zu den Kontexten in Ihren Schreibtipps zu.

	Wählen Sie einen Kontext aus der Liste oder klicken Sie auf +, um einen neuen Kontext hinzuzufügen.
	Geben Sie den Namen des Kontexts ein. Sie können auch einen Kontextnamen ändern.
	In dieses Feld müssen Sie einen XPath-Ausdruck eingeben. Listen Sie die Elemente auf, die Sie Ihrem Kontext zuordnen wollen. Klicken Sie auf +, um eine neue Zuordnung hinzuzufügen.

Fundort

Konfigurieren Sie den Fundort, damit Benutzer*innen in der Sidebar sehen, worauf sich ein Schreibtipp bezieht.

So sieht es zum Beispiel in der Sidebar aus, wenn der Schreibtipp sich auf eine Textstelle in einer Liste oder einer Tabelle bezieht:

	Wählen Sie einen Fundort aus der Liste aus oder klicken Sie auf +, um einen neuen Fundort hinzuzufügen.
	Fundort-ID.
	`XPath` Definieren Sie den Fundort mit XPath.
	Die Lokalisierung erscheint in der Sidebar. Sie zeigt den Namen des Fundorts.

Dokumentinformationen

Der Abschnitt listet alle benutzerdefinierten Felder auf, die Sie konfiguriert haben, um Daten aus Ihrem Content zu lesen. Mit XPaths können Sie dann die genauen Positionen der einzelnen Datenpunkte definieren.

Anmerkung

Diese Funktion ist nur für strukturierte Formate wie XML, HTML oder Markdown verfügbar. Weitere Informationen zu dieser Funktion finden Sie im Artikel zum Konfigurieren von automatischem Datenmapping.

Benutzerdefiniertes Feld	Der Name des benutzerdefinierten Feldes auf Dokumentebene, das konfiguriert ist, um Daten aus Ihrem Content zu lesen.
Ort	Ein XPath zum genauen Element, das die zu empfangenden Daten enthält.

Wie können wir helfen?

Suche

Anmerkung

Anmerkung

Allgemein

Kriterien

Erweiterte Einstellungen

Anmerkung

Anmerkung

Extraktion

Anmerkung

Erweiterte Einstellungen

Anmerkung

Extraktionseinstellungen

Tipp

Kontext

Fundort

Dokumentinformationen

Anmerkung