DocumentazioneAEM GuidesDocumentazione di AEM Guides

Controllo della qualità dei contenuti nell’editor web

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente
  • Amministratore

Questo articolo offre una panoramica delle possibilità di convalida nell’editor web di AEM Guides.
Per progettazione, l'editor Web sfrutta l'impostazione dello schema DITA nel sistema per imporre agli utenti di creare contenuto compatibile con DITA. In questo modo, tutto il contenuto memorizzato nel sistema è strutturato, riutilizzabile e valido.

Oltre al supporto per le regole DITA, Web-editor supporta anche la convalida del contenuto in base alle regole "Schematron".

"Schematron" fa riferimento a un linguaggio di convalida basato su regole utilizzato per definire test per un file XML. Potete importare i file Schematron e modificarli nell'Editor Web. Utilizzando un file "Schematron" è possibile definire determinate regole e quindi convalidarle per un argomento DITA o una mappa. Le regole di schema possono garantire la coerenza della struttura XML imponendo restrizioni definite come regole. Tali restrizioni sono dettate dalle PMI proprietarie della qualità e della coerenza dei contenuti.

NOTA: l'editor Web supporta ISO Schematron.

Conoscenza del funzionamento di "Schematron" nell’editor web

Configurazione delle regole di Schematron

Consulta la sezione "Supporto per i file Schematron" nella Guida utente

Applica regole di convalida al salvataggio dei file

Le impostazioni dell’editor web consentono agli utenti avanzati di impostare regole/file Schematron che verranno eseguiti ogni volta che un utente aggiorna il contenuto. Per ulteriori dettagli fare riferimento alla sezione "Convalida" nella Guida utente

Imposta regole da impostazioni editor Web

È possibile eseguire la convalida manualmente?

Sì, come autore/utente durante la creazione di contenuti puoi utilizzare il pannello Schematron nell’editor web per caricare un file schematron ed eseguire convalide sul file aperto nell’editor.

Affinché ciò funzioni, l'amministratore del profilo di cartella deve consentire a tutti gli utenti di aggiungere file Schemtron nel pannello Convalida. Vedi le impostazioni dell'editor (schermata data sopra)

Scegli il file Schematron
Esegui convalida

Regole supportate

La versione corrente di AEM Guides supporta la convalida utilizzando solo le regole basate su "Asserzioni". (vedi risorsa vs report)
Eventuali regole basate su "Rapporti" non sono ancora supportate.

Esempi e ulteriori informazioni sulle regole di Schematron

Casi d’uso di esempio

  • Controlla se un collegamento è esterno e se ha ambito "esterno"

    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>

  • Controlla se c'è almeno un "topicref" in una mappa o almeno un "li" sotto un "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>

  • L’elemento "indexterm" deve essere sempre presente in un "prologo"

    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>

Riferimenti

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