DokumentationAEM GuidesDokumentation om AEM Guides

Styra kvaliteten på innehållet i webbredigeraren

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Användare
  • Administratör

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

Ange regler från webbredigeringsinställningar

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)

Välj Schematron-fil
Kör validering

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>

Resurser

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178