Instellingen voor uitvoergeneratie configureren id181AI0B0E30

AEM Hulplijnen worden geleverd met veel configuratieopties waarmee u het productieproces voor uitvoer kunt aanpassen. Dit onderwerp behandelt alle configuraties en aanpassingen die u aan opstelling uw proces van de outputgeneratie zouden helpen.

Het tabblad Basislijn op het dashboard voor de DITA-kaart configureren id223MD0D0YRM

Voer de volgende stappen uit om het tabblad Basislijn op het dashboard voor de DITA-kaart te verbergen:

Overvloeien publiceren binnen een bestaande AEM site configureren id1691I0V0MGR

Als u een AEM site hebt die DITA-inhoud bevat, kunt u de AEM Site-uitvoer zo configureren dat DITA-inhoud wordt gepubliceerd naar een vooraf gedefinieerde locatie binnen uw site. In de volgende schermafbeelding van een AEM sitepagina worden bijvoorbeeld de ditacontent knooppunt is gereserveerd voor opslag van DITA-inhoud:

De resterende knooppunten op de pagina worden rechtstreeks vanuit de AEM Site-editor gemaakt. Als u de publicatie-instelling configureert voor het publiceren van DITA-inhoud op een vooraf gedefinieerde locatie, weet u zeker dat geen van de bestaande niet-DITA-inhoud wordt gewijzigd door het publicatieproces AEM hulplijnen.

U moet de volgende configuraties op uw bestaande plaats uitvoeren om het publiceren van inhoud DITA aan een vooraf bepaalde knoop toe te staan:

Voer de volgende stappen uit om de sjablooneigenschappen van uw bestaande site te configureren:

De volgende keer dat u DITA-inhoud publiceert met behulp van de sjabloonconfiguraties van uw site, wordt de inhoud gepubliceerd in de knooppunten die zijn opgegeven in het dialoogvenster topicContentNode en topicHeadNode eigenschappen.

Uitvoer van AEM site aanpassen id166TG0B30WR

De AEM hulplijnen ondersteunen het maken van uitvoerbestanden in de volgende indelingen:

Voor de AEM Site-uitvoer kunt u verschillende ontwerpsjablonen met verschillende uitvoertaken toewijzen. Deze ontwerpsjablonen kunnen de DITA-inhoud in verschillende lay-outs renderen. U kunt bijvoorbeeld verschillende ontwerpsjablonen opgeven voor een intern en extern publiek.

U kunt ook aangepaste DITA Open Toolkit (DITA-OT)-plug-ins gebruiken met de AEM. U kunt deze aangepaste DITA-OT-plug-ins uploaden om PDF-uitvoer op een specifieke manier te genereren.

Ontwerpsjabloon aanpassen voor het genereren van uitvoer customize_xml-add-on

In de AEM Hulplijnen wordt een set vooraf gedefinieerde ontwerpsjablonen gebruikt om AEM site-uitvoer te genereren. U kunt de het ontwerpmalplaatjes van de Gidsen van de AEM aanpassen om de output te produceren die aan uw collectieve branding in overeenstemming is. Een ontwerpsjabloon is een verzameling van verschillende stijlen (CSS), scripts (zowel server- als client-side), bronnen (afbeeldingen, logo's en andere elementen) en JCR-knooppunten die al deze bronnen aan elkaar koppelen. Een ontwerpsjabloon kan zo eenvoudig zijn als één serverscript met slechts een paar JCR-knooppunten of een complexe combinatie van stijlen, bronnen en JCR-knooppunten. De malplaatjes van het ontwerp worden gebruikt door AEM het publiceren subsysteem van Gidsen terwijl het produceren AEM de output van de Plaats en zij controleren de structuur, de blik en het gevoel van de geproduceerde output.

Er is geen beperking ten aanzien van waar de middelen van het ontwerpmalplaatje op de server zouden moeten worden gevestigd, maar zij zijn gewoonlijk logisch georganiseerd volgens hun functie. In de standaardsjabloon zijn bijvoorbeeld alle JavaScript- en CSS-bestanden opgeslagen onder /etc/designs/fmdita/clientlibs/siteoutput/default map. Waar deze bestanden zich bevinden, worden ze aan elkaar gekoppeld door een verzameling JCR-knooppunten. Samen vormen deze JCR-knooppunten en de bestanden de hele ontwerpsjabloon.

Het standaardontwerpmalplaatje dat met de Gidsen van de AEM wordt verscheept staat u toe om het landen, het onderwerp, en de componenten van de onderzoekspagina aan te passen. U kunt een kopie maken van het standaardontwerp en de bijbehorende verwijzingssjablonen en verschillende componenten opgeven om de gewenste uitvoer te genereren.

Voer de volgende stappen uit om uw eigen ontwerpmalplaatje te specificeren voor AEM de outputproductie van de Plaats te gebruiken:

Zie voor meer informatie Uw eerste Adobe Experience Manager-website maken en De basisbeginselen van het ontwikkelen van uw eigen website op AEM.

Documenttitel gebruiken om AEM site-uitvoer te genereren

Bij het genereren van AEM site-uitvoer speelt de manier waarop URL's worden gegenereerd een belangrijke rol bij de ontdekkbaarheid van uw inhoud. Als u op UUID gebaseerde bestandsnamen gebruikt, is het genereren van URL's op basis van UUID van uw bestanden niet zoekvriendelijk. Als Beheerder of Uitgever, hebt u de controle over hoe u URLs voor uw uitvoer van de Plaats van de AEM wilt produceren. AEM Hulplijnen geeft u een configuratie waarmee u de URL's van AEM Site-uitvoer kunt genereren met de titel van het bestand in plaats van de op UUID gebaseerde bestandsnamen. Voor op UUID gebaseerde bestandssystemen is deze optie standaard ingeschakeld. Dit betekende dat wanneer u AEM Site-uitvoer voor op UUID gebaseerde bestandssystemen genereert, de bestandstitels worden gebruikt om de URL's te genereren en niet de UUID's van de bestanden.

Gebruik de instructies die worden gegeven in Configuratieoverschrijvingen om het configuratiebestand te maken. Geef in het configuratiebestand de volgende (eigenschap)-details op om het genereren van URL's in AEM Site-uitvoer te configureren:

De URL van de AEM Site-uitvoer configureren om de documenttitel te gebruiken

U kunt de documenttitels in URL van de output van de Plaats van de AEM gebruiken. Als de bestandsnaam niet bestaat of niet alle speciale tekens bevat, kunt u het systeem zo configureren dat de speciale tekens worden vervangen door een scheidingsteken in de URL van de AEM Site-uitvoer. U kunt het ook vormen om hen met de naam van het eerste kindonderwerp te vervangen.

Voer de volgende stappen uit om de paginanamen te configureren:

Als de @navtitle in <topichead> bevat alle speciale tekens en u stelt de aemsite.pagetitle eigenschap op true in, wordt standaard een scheidingsteken gebruikt. Als u de nodename.systemDefinedPageName bezit aan waar, toont het de naam van het eerste kindonderwerp.

Vorm filename het ontsmetten regels voor het creëren van onderwerpen en het publiceren AEM de output van de Plaats id2164D0KD0XA

Als beheerder kunt u een lijst definiëren met geldige speciale tekens die zijn toegestaan in bestandsnamen. Deze tekens vormen uiteindelijk de URL van een AEM Site-uitvoer. In eerdere versies mochten gebruikers bestandsnamen definiëren die speciale tekens bevatten, zoals @, $, >en meer. Deze speciale tekens resulteerden in gecodeerde URL bij het genereren van AEM sitepagina's.

Vanaf de release 3.8 zijn configuraties toegevoegd om een lijst met speciale tekens te definiëren die zijn toegestaan in de bestandsnamen. Standaard bevat de geldige bestandsnaamconfiguratie "a-z A-Z 0-9 - _". Dit houdt in dat u tijdens het maken van een bestand elk speciaal teken in de titel van het bestand kunt hebben, maar dat het intern wordt vervangen door een afbreekstreepje (-) in de bestandsnaam. U kunt bijvoorbeeld de bestandstitel Introduction 1 of Introduction@1 hebben. De overeenkomstige bestandsnaam die voor beide gevallen wordt gegenereerd, is Introduction-1.

Wanneer u een lijst met geldige tekens definieert, moet u niet vergeten dat deze tekens "*/:[\]|#%{}?&<>"/+" en a space zal altijd worden vervangen door een afbreekstreepje (-).

Gebruik de instructies die worden gegeven in Configuratieoverschrijvingen om het configuratiebestand te maken. Geef in het configuratiebestand de volgende (eigenschap)-details op om de geldige speciale tekens in bestandsnamen en AEM Site-uitvoer te configureren:

U kunt ook andere eigenschappen configureren, zoals kleine letters gebruiken in bestandsnamen, scheidingstekens voor het verwerken van ongeldige tekens en het maximum aantal tekens dat is toegestaan in de bestandsnamen. Om deze eigenschappen te vormen, voeg de volgende zeer belangrijke waardeparen in het configuratiedossier toe:

Samenvoegen van AEM siteknooppuntstructuur configureren

Wanneer u AEM output van de Plaats produceert, wordt een knoop voor elk element in de onderwerpen intern gecreeerd. Voor een kaart DITA met duizenden onderwerpen, kan deze knoopstructuur te diep worden. Dit type van diep genestelde knoopstructuur kan prestatieskwesties voor grotere plaatsen hebben. De volgende momentopname toont diep genestelde knoopstructuur voor een output van de Plaats van de AEM:

In de bovenstaande momentopname, merk op dat er een knoop voor elke wordt gecreeerd p element en zijn verdere sub-elementen en een gelijkaardige structuur wordt gecreeerd voor elk ander element dat in het onderwerp wordt gebruikt.

AEM de Gidsen staat u toe om te vormen hoe de de knoopstructuur van de output van de Plaats intern wordt gecreeerd. U kunt de nodestructuur bij gespecificeerde elementen afvlakken, zo betekent het dat u een element kunt bepalen dat als belangrijkste element zal worden beschouwd en alle sub-elementen binnen het zullen met het belangrijkste element worden samengevoegd. Als u bijvoorbeeld besluit de p element, dan elk element dat in het p element wordt samengevoegd met het hoofdelement p element. Er wordt geen aparte notitie gemaakt voor subelementen binnen de p element. In de volgende momentopname wordt de nodestructuur afgevlakt bij p element:

Voer de volgende stappen uit om de structuur van AEM siteknooppunt af te vlakken:

Wanneer u nu de AEM Site-uitvoer genereert, worden de knooppunten in de p element wordt afgevlakt en opgeslagen binnen het p element zelf. U kunt de nieuwe afvlakkingseigenschappen voor de p -element in CRXDE.

Een tekenreeks zoeken binnen de inhoud in AEM Site-uitvoer

Standaard kunt u alleen in de AEM Site-uitvoer naar een tekenreeks in de titels zoeken. U kunt het systeem configureren om te zoeken naar een tekenreeks in zowel de titels als de inhoud of de hoofdtekst van de AEM Site-uitvoer.

Om het onderzoek toe te laten, zou u de afvlakking van AEM de knoopstructuur van de Plaats moeten vormen.

VOORZIENING:

U kunt zoeken naar maximaal 1 MB samengevoegde inhoud. In de vorige schermafbeelding kunt u bijvoorbeeld zoeken of de inhoud onder <p> tag is <= 1Mb.

Afvlakking van AEM siteknooppuntstructuur voorkomen

Net als wanneer u het knooppunt opgeeft dat moet worden samengevoegd in AEM Site-uitvoer, kunt u ook een element opgeven dat u wilt uitsluiten van deze configuratie. Als u bijvoorbeeld knooppunten wilt afvlakken bij body -element, maar u wilt geen table element binnen body om af te vlakken, kunt u de eigenschap exclude toevoegen binnen de table definitie element.

Als u de opdracht table -element van afvlakking toevoegen aan de volgende eigenschap table definitie element:

<preventancestorflattening>true|false</preventancestorflattening>

De versie voor verwijderde pagina's configureren in AEM Site-uitvoer

Wanneer u AEM Site-uitvoer genereert met Verwijderen en Maken ​ ​Als deze optie is geselecteerd bij de instelling Bestaande uitvoerpagina's, wordt een versie gemaakt voor de pagina(s) die wordt verwijderd. U kunt het systeem vormen om de verwezenlijking van een versie vóór schrapping tegen te houden.

Voer de volgende stappen uit om te stoppen met het maken van een versie voor de pagina(s) die wordt verwijderd:

Aangepaste rewriter instellen met hulplijnen voor Experience Managers custom-rewriter

Experience Manager Guides heeft een aangepaste sling herschrijfster module voor het afhandelen van de koppelingen die worden gegenereerd in het geval van cross-maps (koppelingen tussen de onderwerpen van twee verschillende kaarten). Deze rewriter-configuratie wordt geïnstalleerd op het volgende pad:
/apps/fmdita/config/rewriter/fmdita-crossmap-link-patcher.

Als u een andere aangepaste schrijver voor de spelling in uw codebase hebt, gebruikt u een 'order' waarde groter dan 50, aangezien de Experience Manager Gidsen herschrijver gebruikt 'order' 50 Als u dit wilt overschrijven, hebt u een waarde > 50 nodig. Voor meer informatie, bekijkt u Output Rewriting Pipelines.

Metagegevens gebruiken bij het publiceren van uitvoer via DITA-OT id191LF0U0TY4

Met AEM hulplijnen kunt u aangepaste metagegevens doorgeven terwijl u uitvoer publiceert met DITA-OT. Als beheerder en uitgever zou u de volgende taken moeten uitvoeren om douanemetagegevens in de gepubliceerde output te vormen en te gebruiken:

Voer de volgende stappen uit om de vereiste metagegevens in het systeem toe te voegen:

De nieuwe parameter verschijnt nu op de pagina van Eigenschappen voor alle kaarten DITA.

Vervolgens moet u de aangepaste metagegevens beschikbaar stellen in de DITA-kaartconsole. Voer de volgende stappen uit om de aangepaste metagegevens beschikbaar te maken op het dashboard voor de DITA-kaart:

De aangepaste metagegevens worden nu weergegeven in de DITA-kaartconsole Eigenschappen vervolgkeuzelijst.

Ten slotte moet u als uitgever de aangepaste metagegevens opnemen in de gepubliceerde uitvoer. Voer de volgende stappen uit om de aangepaste metagegevens te verwerken tijdens het genereren van de uitvoer:

De geselecteerde eigenschappen/metagegevens worden doorgegeven aan het publicatieproces en beschikbaar gesteld in de uiteindelijke uitvoer.

Metagegevens valideren die worden doorgegeven aan de DITA-OT voor verwerking

Voor het valideren van de metagegevenswaarden die aan de DITA-OT worden doorgegeven, kan een lokale omgeving worden gebruikt met een pot die klaar is voor de cloud. Omdat we geen toegang hebben tot het lokale bestandssysteem in de cloud, is de enige manier om het metagegevensbestand te valideren via de voor de cloud geschikte poort.

DITA-elementtoewijzing aanpassen met AEM componenten id1679J600HEL

DITA-elementen in de AEM-hulplijnen worden toegewezen aan de corresponderende AEM. AEM Hulplijnen gebruiken deze toewijzing in workflows, zoals publiceren en reviseren, om het DITA-element om te zetten in een corresponderende AEM. De toewijzing wordt gedefinieerd in het dialoogvenster elementmapping.xml bestand, dat toegankelijk is via pakketbeheer.

U kunt de vooraf bepaalde elementen gebruiken DITA, of u kunt elementen DITA aan uw douane AEM componenten in kaart brengen. Als u uw aangepaste AEM wilt gebruiken, moet u de structuur van de component elementmapping.xml bestand.

elementmapping.xml-structuur

Een overzicht op hoog niveau van de elementmapping.xml de structuur wordt hieronder toegelicht :

DITA-elementschema

Hier volgt een voorbeeld van het DITA-elementenschema in elementmapping.xml bestand:

<ditaelement>
    <name>element_name</name>
    <class>element_class</class>
    <componentpath>fmdita/components/dita/component_name</componentpath>
    <type>COMPOSITE|STANDALONE</type>
    <attributeprop>propname_a</attributeprop>
    <textprop>propname_t</textprop>
    <xmlprop>propname_x</xmlprop>
    <xpath>xpath expression string</xpath>
    <target>head|para</target>
    <wrapelement>div</wrapelement>
    <wrapclass>class_name</wrapclass>
    <attributemap>
        <attribute from="attrname"         to="propname"         ispath="true|false"         rel="source|target" />
    </attributemap>
    <skip>true|false</skip>
</ditaelement>

De volgende lijst beschrijft de elementen in het DITA elementenschema:

Aanvullende opmerkingen

DITA-kaartconsole aanpassen id188HC08M0CZ

AEM de Gidsen geeft u de flexibiliteit om de mogelijkheden van de DITA kaartconsole uit te breiden. Bijvoorbeeld, als u een reeks rapporten hebt die van wat in de Gidsen van de AEM verschillend zijn, kunt u dergelijke rapporten aan de kaartconsole toevoegen. Als u de kaartconsole wilt aanpassen, moet u een AEM Client Library (of ClientLib) maken die de code bevat om de vereiste functionaliteit uit te voeren.

AEM hulplijnen biedt de apps.fmdita.dashboard-extn categorie voor het aanpassen van de kaartconsole. Wanneer de kaartconsole wordt geladen, wordt de functionaliteit onder de apps.fmdita.dashboard-extn rubriek wordt uitgevoerd en geladen.

Afbeeldingsuitvoering afhandelen tijdens het genereren van de uitvoer id177BF0G0VY4

AEM wordt geleverd met een set standaardworkflows en mediapandgrepen om elementen te verwerken. In AEM zijn er vooraf gedefinieerde workflows voor het verwerken van elementen voor de meest gangbare MIME-typen. Doorgaans worden voor elke afbeelding die u uploadt, AEM meerdere uitvoeringen van hetzelfde resultaat gemaakt in binaire indeling. Deze vertoningen kunnen van verschillende grootte, met een verschillende resolutie, met een toegevoegd watermerk, of één of andere andere veranderde eigenschap zijn. Voor meer informatie over hoe AEM activa behandelt, zie Middelen verwerken met behulp van mediafuncties en workflows in AEM documentatie.

Met AEM hulplijnen kunt u configureren welke afbeeldingsuitvoering moet worden gebruikt wanneer uitvoer voor uw documenten wordt gegenereerd. U kunt bijvoorbeeld kiezen uit een van de standaardafbeeldingsuitvoeringen of een uitvoering maken en hetzelfde gebruiken om uw documenten te publiceren. Afbeeldingsrenditie-toewijzing voor het publiceren van uw documenten is opgeslagen in het dialoogvenster /libs/fmdita/config/ **renditionmap.xml** bestand. Een fragment van renditionmap.xml bestand is als volgt:

<renditionmap>
   <mapelement>
      <mimetype>image/png</mimetype>
      <rendition output="AEMSITE">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="PDF">original</rendition>
      <rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="EPUB">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="CUSTOM">cq5dam.web.1280.1280.jpeg</rendition>
   </mapelement>
...
</renditionmap>

De mimetype -element geeft het MIME-type van de bestandsindeling aan. De rendition output element geeft het type uitvoerindeling en de naam van uitvoering aan (bijvoorbeeld cq5dam.web.1280.1280.jpeg) die moet worden gebruikt voor het publiceren van de opgegeven uitvoer. U kunt de afbeeldingsuitvoeringen opgeven die moeten worden gebruikt voor alle ondersteunde uitvoerindelingen: AEMSITE, PDF, HTML5, EPUB en CUSTOM.

Als de opgegeven vertoning niet aanwezig is, zoekt AEM publicatieproces voor hulplijnen eerst naar de webuitvoering van de opgegeven afbeelding. Als zelfs de webuitvoering niet wordt gevonden, wordt de oorspronkelijke uitvoering van de afbeelding gebruikt.

Automatische herstelperiode voor uitvoergeschiedenis configureren id19AAI070V8Q

Wanneer u een uitvoer genereert, wordt de uitvoer samen met de uitvoerlogboeken gemaakt. Voor grote DITA-kaarten nemen deze logboeken veel ruimte in uw opslagplaats in beslag. De logbestanden worden standaard opgeslagen op de volgende locatie in de opslagplaats:

/var/dxml/metadata/outputHistory

Over een periode, kon de collectieve grootte van alle logboekdossiers in GBs lopen. AEM Met hulplijnen kunt u een tijdsperiode configureren om deze logbestanden in de opslagplaats te bewaren. Na de opgegeven tijdsperiode worden de logbestanden samen met de productiegeschiedenis van de uitvoer verwijderd uit de opslagplaats.

Het configureren van de functie voor het opschonen van historie heeft invloed op de uitvoergeneratie voor alle DITA-kaarten in de opslagplaats. Op het lusje van Output van een kaart DITA, wordt de geschiedenis gezuiverd na het gespecificeerde aantal dagen en op de tijd die in het plaatsen wordt gespecificeerd.

Gebruik de instructies die worden gegeven in Configuratieoverschrijvingen om het configuratiebestand te maken. Geef in het configuratiebestand de volgende (eigenschap)-details op om een dag en tijd in te stellen voor het wissen van de uitvoergeschiedenis en logboeken:

De onlangs gegenereerde limieten in de lijst met uitvoerbestanden wijzigen id1679JH0H0O2

U kunt het maximumaantal geproduceerde output veranderen die in het lusje van Output voor een kaart DITA wordt getoond.

Gebruik de instructies die worden gegeven in Configuratieoverschrijvingen om het configuratiebestand te maken. Geef in het configuratiebestand de volgende (eigenschap)-details op om het aantal uitvoerbestanden te wijzigen dat in de lijst moet worden weergegeven: