Site AEM id205BE3008SW
De volgende opties zijn beschikbaar voor de AEM Site-uitvoer:
U kunt de AEM sitevoorinstelling op twee manieren maken:
Vanuit de webeditor: Open in het deelvenster Opslagplaats het DITA-kaartbestand in de Kaartweergave en selecteer vervolgens op het tabblad Uitvoer het pictogram + om een uitvoervoorinstelling te maken. Selecteer vervolgens AEM Site in de keuzelijst Type in het dialoogvenster Voorinstelling toevoegen. In de redacteur van het Web zijn de configuraties georganiseerd onder Algemene en Geavanceerde lusjes:
Algemeen
De Algemeen bevat de volgende configuraties:
- Sitenaam
- Uitvoerpad
- Bestaande uitvoerpagina's
- Orphan-sitepagina's verwijderen
- Voorwaarden toepassen met (als de voorwaarden voor een kaart zijn gedefinieerd)
- Basislijn gebruiken (als een basislijn is gemaakt voor een kaart)
- Workflow na generatie
Geavanceerd
Het tabblad Geavanceerd bevat de volgende configuraties:
- Tijdelijke bestanden downloaden
- Afzonderlijke PDF genereren voor elk onderwerp
- Eigenschappen Kaart als standaard gebruiken
Zie voor meer informatie AEM.
Van het kaartdashboard
Als u uitvoervoorinstellingen voor AEM site wilt openen, klikt u op een DITA-toewijzingsbestand in de interface Middelen, klikt u op Uitvoervoorinstellingen en klikt u vervolgens op de uitvoeroptie AEM Site.Klik in het dashboard voor de kaart op Bewerken bovenaan om de verschillende configuraties bij te werken, en klik dan Opslaan.
AEM id_aem_site_config
De volgende opties zijn beschikbaar voor de AEM Site-uitvoer:
Er wordt een knooppunt in de AEM gemaakt met de hier opgegeven naam. Als u de Sitenaam niet opgeeft, wordt het siteknooppunt gemaakt met de naam van het DITA-toewijzingsbestand.
De sitenaam die u hier opgeeft, wordt ook gebruikt als titel op het browsertabblad.
U kunt ook variabelen gebruiken bij het instellen van de sitenaam. Voor meer informatie over het gebruik van variabelen raadpleegt u Variabelen gebruiken voor het instellen van de opties Doelpad, Sitenaam of Bestandsnaam.
Neem contact op met de publicatiebeheerder voor meer informatie over het gebruik van aangepaste ontwerpsjablonen om uitvoer te genereren.
user-guide
en het bestemmingspad als /content/output/aem-guides
, wordt de einduitvoer gegenereerd onder de /content/output/aem-guides/user-guide
knooppunt.U kunt ook variabelen gebruiken bij het instellen van het bestemmingspad. Voor meer informatie over het gebruik van variabelen raadpleegt u Variabelen gebruiken voor het instellen van de opties Doelpad, Sitenaam of Bestandsnaam.
Geen toegepast: Selecteer deze optie als u geen voorwaarde wilt toepassen op de gepubliceerde uitvoer.
DITAVal-bestand: Selecteer DITAVal-bestand(en) om geconditioneerde inhoud te genereren. U kunt meerdere DITAVal-bestanden selecteren via het dialoogvenster Bladeren of door een bestandspad te typen. Gebruik het kruispictogram bij de bestandsnaam om het te verwijderen. DITAVal-bestanden worden in de opgegeven volgorde geëvalueerd, zodat de voorwaarden die in het eerste bestand zijn opgegeven voorrang hebben op de voorwaarden die in latere bestanden worden vermeld. U kunt de bestandsvolgorde behouden door bestanden toe te voegen of te verwijderen. Als het DITAVal-bestand naar een andere locatie wordt verplaatst of wordt verwijderd, wordt het niet automatisch verwijderd van het kaartdashboard. U moet de locatie bijwerken als bestanden worden verplaatst of verwijderd. U kunt de muisaanwijzer boven de bestandsnaam plaatsen om het pad te zien in de AEM opslagplaats waar het bestand is opgeslagen. U kunt alleen DITAVal-bestanden selecteren en er wordt een fout weergegeven als u een ander bestandstype selecteert.
Voorinstelling voorwaarde: Selecteer een voorinstelling voor de voorwaarde in het keuzemenu om een voorwaarde toe te passen tijdens het publiceren van de uitvoer. Deze optie is zichtbaar als u een voorwaarde voor het DITA kaartdossier hebt toegevoegd. De voorwaardelijke instellingen zijn beschikbaar op het tabblad Voorinstellingen voorwaarde van de DITA-kaartconsole. Zie voor meer informatie over voorinstellingen voor voorwaarden Voorinstellingen voor voorwaarden gebruiken.
Selecteer de Verwijderen en maken gebruiken om bestaande pagina's tijdens het publiceren te verwijderen. Met deze optie verwijdert u het paginaknooppunt samen met de inhoud ervan en alle onderliggende pagina's eronder. Gebruik deze optie als u de ontwerpsjabloon van de uitvoervoorinstelling hebt gewijzigd of als u extra pagina's wilt verwijderen die zich al in het doel bevinden.
Stel dat u een DITA-kaart hebt gepubliceerd, die de onderwerpen a.dita, b.dita en c.dita bevat. Alvorens de kaart opnieuw te publiceren, verwijderde u b.dita onderwerp van de kaart. Nu, als u deze optie hebt geselecteerd, dan wordt alle inhoud met betrekking tot b.dita verwijderd uit de output van de AEMPlaats en slechts a.dita en c.dita worden gepubliceerd.
Deze functie verwijdert geen gepubliceerde onderliggende kaart. Bijvoorbeeld, als uw ouderkaart een kindkaart bevat, en u de volledige kindkaart verwijdert, dan wordt de inhoud van de kindkaart niet geschrapt van de gepubliceerde output. Nochtans, als u om het even welk onderwerp uit een kindkaart verwijdert en opnieuw publiceert, dan wordt de inhoud van het verwijderde onderwerp geschrapt van de plaatsuitvoer.
Als er inhoud waarnaar wordt verwezen is en die inhoud wordt verwijderd voordat de inhoud opnieuw wordt gepubliceerd, worden de gegevens van de inhoud waarnaar wordt verwezen niet verwijderd.
Opmerking: Informatie over verwijderde weespagina's wordt ook vastgelegd in de logbestanden van de uitvoergeneratie. Voor meer informatie over de toegang tot van de logboekdossiers, zie Logbestand weergeven en controleren.
Selecteer na het genereren van de uitvoer de optie Tijdelijke bestanden downloaden
![pictogram Tijdelijke bestanden downloaden](./media_196349ecf0408f30151d0240aafcb1489409c24e1.png?width=750&format=png&optimize=medium)
Opmerking: Als u bepaalde bestandseigenschappen selecteert en vervolgens de tijdelijke bestanden downloadt, krijgt u ook de opdracht metadata.xml in de ZIP-map.
In het Splitste gebied van de Weg van de PDF, specificeer de weg om de PDF op te slaan die voor elk onderwerp worden geproduceerd.
Opmerking: AEM Hulplijnen gebruiken de insteekmodule DITA-OT met de naam pdfx om PDF voor elk onderwerp te genereren. Deze plug-in is gebundeld met het DITA-OT-pakket dat buiten de box wordt geleverd. U kunt deze plug-in naar wens aanpassen om PDF te genereren. Als u een aangepaste insteekmodule DITA-OT gebruikt, moet u de insteekmodule pdfx integreren voor het genereren van PDF op onderwerpniveau.
Belangrijk: Wanneer u incrementele uitvoer voor de AEM Site genereert, wordt de uitvoer gemaakt met de huidige versie van de bestanden en niet met de gekoppelde basislijn.
Zie Werken met basislijn voor meer details.
Opmerking: De eigenschappen van de metagegevens zijn hoofdlettergevoelig.
Als u een basislijn hebt geselecteerd, zijn de waarden voor de eigenschappen gebaseerd op de versie van de geselecteerde basislijn. Als u geen basislijn hebt geselecteerd, zijn de waarden voor de eigenschappen gebaseerd op de meest recente versie.
U kunt de metagegevens ook doorgeven aan de uitvoer met DITA-OT-publicatie. Zie voor meer informatie Geef de metagegevens door aan de uitvoer met DITA-OT.
Opmerking: Als u geen definitie hebt gegeven van
cq:tags
in de optie Eigenschappen, dan de waarden voor cq:tags
worden gekozen uit de huidige werkkopie, zelfs als u een basislijn hebt geselecteerd voor publicatie.Alleen eigenschappen String, Date of Long (enkelvoudig en geavanceerd) kunnen worden doorgegeven aan de AEM sitepagina's. De metagegevenswaarden voor een eigenschap van het type String ondersteunen geen speciale tekens (zoals
@, #, " "
).* Deze optie dient te worden gebruikt in combinatie met de
Properties
-optie.Aanvullende notitie op AEM site
Op artikel gebaseerde uitvoer genereren vanuit de webeditor
U kunt de output van de Plaats van de AEM voor één of meerdere onderwerpen, of de volledige kaart DITA van de Redacteur van het Web produceren. U moet uitvoervoorinstellingen maken voor uw DITA-kaart en vervolgens kunt u de AEM Site-uitvoer voor uw kaart eenvoudig genereren. Als u een paar onderwerpen in uw kaart hebt bijgewerkt, kunt u de output van de AEMPlaats slechts voor die onderwerpen van de Redacteur van het Web ook produceren. Zie voor meer informatie Publiceren op basis van artikelen vanuit de webeditor.
Output die onderwerpen van andere kaarten verbinden
Het is een zeer gemeenschappelijk scenario om een grote reeks documentatie te hebben die zich over veelvoudige omslagen en kaarten DITA uitgespreid. Het wordt bijzonder ingewikkeld om inhoud te publiceren die van diverse plaatsen verbonden is. Standaard alle koppelingen <xref>
worden gemaakt met de local
@scope
. Het publiceren van dergelijke onderwerpen impliceert geen uitdaging, aangezien het directe verbinding aan het onderwerp gebruikt. Als het onderwerp buiten de huidige kaart DITA is, toont de verbinding niet de verbonden inhoud.
Een andere manier om inhoud te koppelen, is het maken van een koppeling met de peer
@scope
. Voor dergelijke inhoud, wordt de verbinding opgelost in runtime door de titel van het dossier en de gevormde context voor het verbonden onderwerp van de DITA kaart te kiezen publiceert context. In de volgende schermafbeelding ziet u het deelvenster Eigenschappen voor een koppeling met de peer
@scope
:
Om het publiceren van complexe kaarten en onderwerpen te vereenvoudigen die met andere onderwerpen in andere kaarten verbinden, staat AEM Gidsen u toe om de het publiceren context voor elke vooraf ingestelde output te plaatsen.
De het publiceren context staat u toe om te specificeren welk onderwerp moet worden gebruikt waarvan kaart voor het publiceren van een specifieke output. Laten we dit begrijpen met behulp van een voorbeeld — laten we zeggen dat u vier mappen hebt: voorbeeld a, monster b, monster c en monster d. Elke omslag bevat een kaart DITA — kaart A DITA, kaart B DITA, kaart C DITA, en kaart D DITA. De kaart D van DITA dwars-kaart zal verbinden gebeuren wanneer een onderwerp in kaartA van DITA met een onderwerp in kaart B DITA, C, of D. verbindt. In het volgende schermafbeelding bevat een onderwerp met voorbeeldconcepten koppelingen (of verwijzingen) naar bestanden die deel uitmaken van andere DITA-kaarten.
Wanneer u nu de publicatie-instellingen voor AEM site configureert voor het kaartbestand dat dit onderwerp bevat, kunt u selecteren welke publicatiecontext voor de gekoppelde inhoud wordt gebruikt tijdens het publiceren. Een publicatiecontext is een combinatie van een DITA-kaart en de bijbehorende uitvoervoorinstelling. De uitvoervoorinstelling bevat op zijn beurt een specifieke versie van de inhoud en voorwaardelijke voorinstellingen. Deze volledige combinatie van de DITA-kaart, de uitvoervoorinstelling, de versie (bestanden) en de voorwaarden definiëren de publicatiecontext voor een gekoppelde kaart.
Voer de volgende stappen uit om de publicatiecontext voor cross-linked bestanden op te geven:
-
Open de Voorinstellingen uitvoer tabblad van de DITA-kaart die u wilt publiceren.
-
Selecteer de Site AEM uitvoervoorinstelling.
U krijgt de AEM vooraf instelt Montages en Publish lusjes van de Context.
-
Open de Context publiceren tab.
U wordt getoond een lijst van afhankelijke onderwerpen. Dit zijn de onderwerpen die van één of ander onderwerp in de huidige kaart verbonden zijn, maar zij zijn beschikbaar in sommige andere kaarten DITA.
note note NOTE Op het tabblad Publicatie worden onderwerpen weergegeven die zijn gekoppeld met het tabblad peer
@scope
alleen. Voor koppelingen metlocal
@scope
hoeft u de publicatiecontext niet op te geven.Standaard zijn voor alle gekoppelde onderwerpen de meest recente uitvoervoorinstelling en -toewijzing geselecteerd.
-
Als u de standaardselectie van de DITA-kaart en voorinstelling wilt wijzigen, klikt u op Bewerken (in de hoofdwerkbalk).
-
Als u de laatst gepubliceerde uitvoer van elk afhankelijk bestand op de kaart wilt gebruiken, selecteert u Laatst gegenereerde publicatiecontext gebruiken voor alle afhankelijke onderwerpen.
-
In de Bovenliggende kaart Selecteer in de vervolgkeuzelijst het kaartbestand met de uitvoer van de huidige kaart die u wilt koppelen.
Bij het selecteren van een kaartdossier, wordt UUID van de kaart getoond in de Ouderlijke kolom van UUID van de Kaart. De uitvoervoorinstellingen die aan de geselecteerde kaart zijn gekoppeld, worden vermeld in de lijst Voorinstellingen bovenliggende kaart.
-
In de Voorinstelling bovenliggende kaart Selecteer de uitvoervoorinstelling waarmee u de uitvoer van de huidige kaart wilt koppelen.
-
Selecteer de vereiste kaart en zijn output vooraf ingesteld voor alle afhankelijke onderwerpen en klik Gereed.
De context voor de afhankelijke onderwerpen is nu ingesteld. U kunt de uitvoer voor de huidige kaart genereren. Voor meer informatie over het produceren van output, zie Produceer output voor een kaart DITA van de kaartconsole.
Overvloeien van publicaties
AEM hulplijnen ondersteunen het publiceren van DITA-inhoud binnen uw bestaande AEM. Als u bijvoorbeeld een bestaande site hebt, kunt u met de AEM Site-uitvoer alleen de DITA-inhoud op die site publiceren. In dit proces wordt de bestaande niet-DITA-inhoud niet gewijzigd door het publicatieproces. Neem contact op met de publicatiebeheerder voor meer informatie over het instellen van uw site om alleen DITA-inhoud te publiceren.
Publiceren conref
Als u conref
in uw inhoud, dan wordt het gepubliceerd als normale of ingebedde inhoud samen met de inhoud in het bron \ (of verwijzend ) onderwerp. De conref
inhoud wordt samen met de hoofdinhoud gerenderd en er wordt geen aparte sitepagina voor dezelfde inhoud gemaakt. Wanneer u naar de inhoud zoekt die in conref
en vervolgens alleen het hoofdonderwerp of de pagina met het conref
inhoud wordt weergegeven in de zoekresultaten.
conref
met AEM versie 3.5 of lager van de hulplijnen, wordt aangeraden deze pagina's te verwijderen of opnieuw te verwijderen met de opdracht Orphan-sitepagina's verwijderen -optie.Zoeken in een tekenreeks binnen de inhoud
U kunt zoeken naar een tekenreeks in de uitvoer AEM Site. Standaard kunt u alleen in de titels naar de tekenreeks zoeken. Als u naar de tekenreeks in de inhoud of de hoofdtekst van de AEM site-uitvoer wilt zoeken, neemt u contact op met de systeembeheerder om de eigenschap flattening.enabled in te schakelen.
Zie voor meer informatie Samenvoegen van AEM siteknooppuntstructuur configureren in de handleiding Adobe Experience Manager-hulplijnen installeren en configureren.
Bovenliggend onderwerp: Uitvoervoorinstellingen