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

U kunt het tabblad Basislijn dat beschikbaar is op het dashboard voor de kaart configureren en verbergen.

De optie van het Lusje van de Basislijn van de Verbergen wordt niet toegelaten door gebrek en u moet dit van configMgr toelaten. Voer de volgende stappen uit om de optie door gebrek in de Redacteur van het Web toe te laten:

FrameMaker Publishing Server configureren id1678G0Z0TN6

U kunt FrameMaker Publishing Server (FMPS) gebruiken om uitvoer voor uw DITA-inhoud te genereren. Als u FMPS configureert, kunt u uitvoer genereren in meerdere indelingen die worden ondersteund door FMPS.

Als u AEM Guides wilt configureren voor het gebruik van FMPS, werkt u de volgende eigenschappen van de com.adobe.fmdita.config.ConfigManager -bundel bij in de webconsole.

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:

{width="300"}

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:

In de volgende schermafbeelding worden de eigenschappen weergegeven die in het standaardsjabloonknooppunt van AEM Guides zijn toegevoegd:

{width="800"}

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 .

Voor bestaande sites moet u echter handmatig de knooppunten topicContentNode en topicHeadNode toevoegen.

Voer de volgende stappen uit om de vereiste knooppunten aan uw bestaande site toe te voegen:

Uitvoer van AEM site aanpassen id166TG0B30WR

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 met AEM Guides gebruiken. 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

AEM Guides gebruikt een set vooraf gedefinieerde ontwerpsjablonen om AEM Site-uitvoer te genereren. U kunt de ontwerpsjablonen van AEM Guides aanpassen om de uitvoer te genereren die voldoet aan 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 Adobe Experience Manager 6.3 websiteen 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.

Bij het genereren van AEM site-uitvoer speelt de manier waarop URL's worden gegenereerd een belangrijke rol bij de ontdekkbaarheid van uw inhoud. Bij niet-UUID-bestandssystemen wordt de AEM Site-uitvoer gegenereerd met de bestandsnamen en niet met de titels van het bestand. 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 de URL's van AEM Site-uitvoer kunt genereren met de bestandstitel en niet met de bestandsnamen. Deze optie is standaard uitgeschakeld. Dit betekende dat wanneer u AEM Site-uitvoer genereert, de bestandsnamen worden gebruikt om de URL's te genereren en niet de titel van het bestand. U kunt ervoor kiezen de URL's te genereren op basis van de bestandstitels door deze optie in te schakelen.

Voer de volgende stappen uit om het genereren van URL's in AEM Site-uitvoer te configureren:

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.

Voer de volgende stappen uit om de geldige speciale tekens in bestandsnamen en AEM Site-uitvoer te configureren:

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:

{width="300"}

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:

{width="300"}

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.

{width="650"}

verhinderen afvlakking van de structuur van het AEM van het Nota 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:

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.

{width="650"}

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.

DITA-elementtoewijzing aanpassen met AEM componenten id1679J600HEL

DITA-elementen in 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 vanuit de modus CRXDE Lite. Open de volgende URL in de modus CRXDE Lite:

/libs/fmdita/config/elementmapping.xml

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 afwijken van wat er in AEM Guides beschikbaar is, 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.

Voer de volgende stappen uit 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. Standaard wordt een lijst met de laatste 25 gegenereerde uitvoerbestanden weergegeven. Om het aantal output te veranderen om in de lijst te tonen, werk de Limiet van de Lijst van Output het plaatsen in de com.adobe.fmdita.config.ConfigManager bundel bij.

Optimalisatie van uitvoerprestaties id176LB050VUI

AEM Guides staat u toe om de grootte van de de generatieprocessen van de outputproductie te vormen die het aantal processen van de outputgeneratie controleert die gelijktijdig lopen. Standaard is de grootte van de procespool ingesteld op het aantal verwerkingskernen dat beschikbaar is in uw systeem plus één. U kunt deze waarde wijzigen in 1 als u opeenvolgende publicaties wilt. In dit geval wordt de eerste publicatietaak uitgevoerd en wordt de volgende publicatietaak opgeslagen in de publicatiereeks.

Om de grootte van de de verwerkingspool van de outputgeneratie te veranderen, werk de het plaatsen van de Grootte van de Pool van de 1} generatie in de com.adobe.fmdita.publish.manager.PublishThreadManagerImpl bundel bij.