Instellingen voor uitvoergeneratie configureren id181AI0B0E30

AEM Guides wordt 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 is het knooppunt ditacontent bijvoorbeeld gereserveerd voor het opslaan 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 uw bestaande niet-DITA-inhoud wordt gewijzigd door het AEM Guides-publicatieproces.

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 de eigenschappen topicContentNode en topicHeadNode .

Uitvoer van AEM site aanpassen id166TG0B30WR

De AEM Guides ondersteunt 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 Guides. 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

De AEM Guides gebruikt een set vooraf gedefinieerde ontwerpsjablonen om AEM Site-uitvoer te genereren. U kunt de AEM Guides-ontwerpsjablonen aanpassen om de uitvoer te genereren die in overeenstemming is met uw bedrijfsbranding. 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 het publiceren van AEM Guides subsysteem terwijl het produceren van AEM 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 worden bijvoorbeeld alle JavaScript- en CSS-bestanden opgeslagen in de map /etc/designs/fmdita/clientlibs/siteoutput/default . 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 AEM Guides 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:

Voor meer informatie, zie Creërend uw eerste website van Adobe Experience Manageren de Grondbeginselenvan 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 Guides biedt u een configuratie waarmee u URL's van AEM Site-uitvoer kunt genereren met de bestandstitel 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 in worden gegeven met voeten treedt van de Configuratieom het configuratiedossier tot stand te brengen. 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 eigenschap @navtitle in <topichead> bijvoorbeeld alle speciale tekens bevat en u de eigenschap aemsite.pagetitle instelt op true, wordt standaard een scheidingsteken gebruikt. Als u de eigenschap nodename.systemDefinedPageName instelt op true, wordt de naam van het eerste onderliggende onderwerp weergegeven.

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. Door gebrek, bevat de geldige filename configuratie "a-z A-Z 0-9 - _". Dit houdt in dat u tijdens het maken van een bestand elk speciaal teken in de bestandstitel 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 van geldige karakters bepaalt, herinner dat deze karakters "*/:[\]|#%{}?&<>"/+"en a space altijd met een koppelteken \ (- ) zullen worden vervangen.

Gebruik de instructies die in worden gegeven met voeten treedt van de Configuratieom het configuratiedossier tot stand te brengen. 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 elk p element en zijn verdere sub-elementen is gecreeerd en een gelijkaardige structuur wordt gecreeerd voor elk ander element dat in het onderwerp wordt gebruikt.

AEM Guides 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 het element p af te vlakken, worden alle elementen die in het element p worden weergegeven, samengevoegd met het element main p . Er wordt geen aparte notitie gemaakt voor een subelement binnen het element p . In de volgende momentopname wordt de nodestructuur afgevlakt op het element p weergegeven:

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 het element p samengevoegd en opgeslagen in het element p zelf. U kunt de nieuwe afvlakkingseigenschappen voor het element p vinden in CRXDE.

Onderzoek een koord binnen de inhoud in AEM output van de Plaats

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 de tag <p> <= 1Mb is.

verhindert afvlakking van de structuur van de AEM van de Plaats

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 op het element body , maar geen table element body wilt afvlakken, kunt u de eigenschap exclude toevoegen binnen de definitie van het element table .

Als u het element table wilt uitsluiten van afvlakking, voegt u de volgende eigenschap toe aan de definitie van het element table :

<preventancestorflattening>true|false</preventancestorflattening>

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

Wanneer u AEM output van de Plaats met schrapping produceert en creeert ​ ​optie die voor het Bestaande plaatsen van de Pagina's van de Output wordt geselecteerd, wordt een versie gecreeerd voor pagina (s ) die worden geschrapt. 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 Experience Manager Guides custom-rewriter

Experience Manager Guides heeft een douane die herschrijvermodule leest voor de behandeling van de verbindingen in het geval van dwars-kaarten (verbindingen tussen de onderwerpen van twee verschillende kaarten) worden geproduceerd. Deze herschrijfconfiguratie is geïnstalleerd op het volgende pad:
/apps/fmdita/config/rewriter/fmdita-crossmap-link-patcher.

Als u nog een aangepaste schrijfbewerking voor tekenreeksen in uw codebase hebt, gebruikt u een 'order' -waarde groter dan 50, omdat Experience Manager Guides anders 'order' 50 gebruikt. Als u dit wilt overschrijven, hebt u een waarde > 50 nodig. Voor meer details, mening Output die pijplijnen herschrijft.

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

AEM Guides biedt een manier om aangepaste metagegevens door te geven tijdens het publiceren van uitvoer 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:

Nu zullen de douanemetagegevens omhoog in de DITA kaartconsole Eigenschappen drop-down lijst van Eigenschappen verschijnen.

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 Guides worden toegewezen aan de bijbehorende AEM. AEM Guides gebruikt deze toewijzing in workflows, zoals publiceren en reviseren, om DITA-elementen om te zetten in een overeenkomende AEM. De toewijzing wordt gedefinieerd in het elementmapping.xml -bestand, dat kan worden geopend met 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 het elementmapping.xml -bestand begrijpen.

elementmapping.xml-structuur

Hieronder vindt u een overzicht op hoog niveau van de elementmapping.xml -structuur:

DITA-elementschema

Hieronder ziet u een voorbeeld van het DITA-elementschema in het bestand elementmapping.xml :

<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:

Extra nota's

DITA-kaartconsole aanpassen id188HC08M0CZ

AEM Guides biedt u de flexibiliteit om de mogelijkheden van de DITA kaartconsole uit te breiden. Als u bijvoorbeeld een set rapporten hebt die afwijkt van de beschikbare rapporten in de AEM Guides, kunt u dergelijke rapporten toevoegen aan de kaartconsole. 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 Guides biedt de categorie apps.fmdita.dashboard-extn voor het aanpassen van de kaartconsole. Wanneer de kaartconsole wordt geladen, wordt de functionaliteit die onder de categorie apps.fmdita.dashboard-extn wordt gemaakt, 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 Assets die de Handlers en de Werkschema's van Media van de Verwerking gebruiktin AEM documentatie.

Met AEM Guides 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. Toewijzing van afbeeldingsuitvoering voor het publiceren van uw documenten wordt opgeslagen in het /libs/fmdita/config/ **renditionmap.xml** -bestand. Een fragment van het bestand renditionmap.xml ziet er als volgt uit:

<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>

Het element mimetype geeft het MIME-type van de bestandsindeling aan. Het element rendition output geeft het type uitvoerindeling en de naam van de uitvoering (bijvoorbeeld cq5dam.web.1280.1280.jpeg) aan 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 het AEM Guides-publicatieproces 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. Met AEM Guides 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 in worden gegeven met voeten treedt van de Configuratieom het configuratiedossier tot stand te brengen. 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 in worden gegeven met voeten treedt van de Configuratieom het configuratiedossier tot stand te brengen. Geef in het configuratiebestand de volgende (eigenschap)-details op om het aantal uitvoerbestanden te wijzigen dat in de lijst moet worden weergegeven: