Styra kvaliteten på innehållet i webbredigeraren
I den här artikeln finns en översikt över valideringsmöjligheterna i AEM Guides webbredigerare.
Genom att designa en webbredigerare utnyttjar DITA-schemainställningarna i systemet för att tvinga användare att skapa DITA-kompatibelt innehåll. Då är allt innehåll som lagras i systemet strukturerat, återanvändbart och giltigt DITA-innehåll.
Förutom stöd för DITA-regler stöder webbredigeraren även validering av innehåll baserat på Schematron-regler.
"Schematron" refererar till ett regelbaserat valideringsspråk som används för att definiera tester för en XML-fil. Du kan importera schemafilerna och redigera dem i Web Editor. Med hjälp av en "Schematron"-fil kan du definiera vissa regler och sedan validera dem för ett DITA-ämne eller en karta. Schematronreglerna kan säkerställa konsekvens i XML-strukturen genom att införa begränsningar som definieras som regler. Dessa begränsningar drivs av små och medelstora företag som äger innehållets kvalitet och enhetlighet.
Obs! Webbredigeraren stöder ISO-schemat.
Att veta hur "Schematron" fungerar i webbredigeraren
Konfigurera schematransregler
Mer information finns i avsnittet Stöd för schemafiler i användarhandboken
Använd valideringsregler när filen sparas
Med webbläsar-inställningarna kan användarna konfigurera schematrons regler/filer som körs varje gång en användare uppdaterar innehållet. Mer information finns i avsnittet Validering i användarhandboken
Kan du köra valideringen manuellt?
Ja, som författare/användare när du skapar innehåll kan du använda panelen Schematron i webbredigeraren för att överföra en schematron-fil och köra valideringar för filen som är öppen i redigeraren.
För att detta ska fungera måste mappprofiladministratören tillåta alla användare att lägga till Schemtron-filer på valideringspanelen. Se redigeringsinställningar (skärmbild ovan)
Reglerna stöds
Aktuell version av AEM Guides stöder endast validering med"Assertion"-baserade regler. (se resurs jämfört med rapport)
Regler som baseras på "Rapporter" stöds inte ännu.
Exempel och mer hjälp om schematreringsregler
Exempel på användningsområden
-
Kontrollera om en länk är extern och om den har omfånget "external"
code language-none <sch:pattern> <sch:rule context="xref[contains(@href, 'http') or contains(@href, 'https')]"> <sch:assert test="@scope = 'external' and @format = 'html'"> All external xref links must be with scope='external' and format='html' </sch:assert> </sch:rule> </sch:pattern>
-
Kontrollera om det finns minst en "topicref" i en karta eller minst en "li" under en "ul"
code language-none <sch:pattern> <sch:rule context="map"> <sch:assert test="count(topicref) > 0"> There should be atleast one topicref in map </sch:assert> </sch:rule> <sch:rule context="ul"> <sch:assert test="count(li) > 1" > A list must have more than one item. </sch:assert> </sch:rule> </sch:pattern>
-
Elementet "indexterm" ska alltid finnas i en "prolog"
code language-none <sch:pattern> <sch:rule context="*[contains(@class, ' topic/indexterm ')]"> <sch:assert test="ancestor::node()/local-name() = 'prolog'"> The indexterm element should be in a prolog. </sch:assert> </sch:rule> </sch:pattern>