Uitvoer van AEM-site aanpassen

De AEM Guides ondersteunt het maken van uitvoerbestanden in de volgende indelingen:

  • AEM-site
  • PDF
  • HTML5
  • EPUB
  • Aangepaste uitvoer via DITA-OT

Voor de uitvoer van de AEM-site 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.

TIP
Zie de het publiceren van de Plaats van AEM sectie in de Beste praktijken gids voor beste praktijken rond het creëren van de output van de Plaats van AEM.

Ontwerpsjabloon aanpassen voor het genereren van uitvoer

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 subsysteem van AEM Guides terwijl het produceren van de output van de Plaats van AEM 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 ontwerpsjabloon op te geven die moet worden gebruikt voor het genereren van AEM Site-uitvoer:

  1. Gebruik de Manager van het Pakket om het standaardontwerpmalplaatje van de volgende plaats te downloaden:

    /libs/fmdita/config/templates

  2. Maak een kopie van de gedownloade bestanden op de volgende locatie in de Cloud Manager Git-opslagplaats:

    /apps/fmdita/config/templates

  3. U moet ook de sjablonen downloaden en kopiëren waarnaar wordt verwezen vanuit het standaardsjabloonknooppunt. De sjablonen waarnaar wordt verwezen worden onder:

    /libs/fmdita/templates/default/cqtemplates

    De eigenschappen van de AEM Guides-ontwerpsjabloon worden in de volgende tabel beschreven.

    EigenschapBeschrijving
    landingPageTemplate, searchPageTemplate, topicPageTemplate, shadowPageTemplateGeef het knooppunt cq:Template voor deze overeenkomende pagina's op (landen, zoeken en onderwerpen). Standaard is het knooppunt cq:Template voor deze pagina's te vinden in het knooppunt /libs/fmdita/templates/default/cqtemplates . Dit knooppunt definieert de structuur en eigenschappen van de bestemmings-, zoek- en onderwerppagina's.
    De lus shadowPageTemplate wordt gebruikt om de inhoud die u hebt afgekapt, te optimaliseren. U moet de waarde van deze eigenschap instellen op: fmdita/templates/default/cqtemplates/shadowpage
    Nota: u moet een waarde voor topicPageTemplate specificeren. De eigenschappen landingPageTemplate en searchPageTemplate zijn optioneel. Geef deze eigenschappen niet op als u niet wilt dat de zoek- en bestemmingspagina's worden gegenereerd.
    titleEen beschrijvende naam van de ontwerpsjabloon.
    topicContentNodeDe plaats van de knoop die de inhoud DITA in een onderwerppagina zal bevatten. Het pad is relatief ten opzichte van de onderwerppagina.
    topicHeadNodeDe locatie van het knooppunt dat de hoofdwaarden (of metagegevens) bevat die zijn afgeleid van de DITA-inhoud. Pad is relatief ten opzichte van onderwerppagina.
    tocNodeDe locatie van het knooppunt dat de inhoudsopgave zal bevatten. Het pad is relatief ten opzichte van de bestemmingspagina of het bestemmingspad.
    basePathPropDe eigenschapnaam voor het opslaan van het pad van de hoofdmap van de gepubliceerde site.
    indexPathPropDe eigenschapsnaam voor het opslaan van het pad van de bestemmings-/indexpagina van de gepubliceerde site.
    pdfPathPropDe bezitsnaam voor het opslaan van de weg van onderwerpPDF, als de generatie van onderwerpPDF wordt toegelaten.
    pdfTypePropDe eigenschapsnaam voor het opslaan van het type van de PDF-generatie. Momenteel bevat deze eigenschap altijd "Onderwerp".
    searchPathPropDe eigenschapsnaam voor het opslaan van het pad van de zoekpagina als de sjabloon een zoekpagina bevat.
    siteTitlePropDe eigenschapsnaam voor het opslaan van de titel van de site die wordt gepubliceerd. Deze titel is meestal dezelfde als de titel van de kaart die wordt gepubliceerd.
    sourcePathPropDe bezitsnaam voor het opslaan van de weg van het bronDITA onderwerp voor de huidige pagina.
    tocPathPropDe eigenschapnaam voor het opslaan van het pad van de inhoudsopgave-hoofdmap voor de gepubliceerde site.
NOTE
Nadat u een aangepaste ontwerpsjabloonnode hebt gemaakt, moet u de optie Ontwerpen in de uitvoervoorinstellingen van de AEM-site bijwerken om het aangepaste ontwerpsjabloonknooppunt te kunnen 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 uitvoer van AEM-sites te genereren

Bij het genereren van de uitvoer van de AEM-site speelt de manier waarop URL's worden gegenereerd een belangrijke rol bij de detecteerbaarheid 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 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 impliceerde dat wanneer u de output van de Plaats van AEM voor op UUID-Gebaseerde dossiersystemen produceert, de titels van het dossier worden gebruikt om URLs en niet UUIDs van de dossiers te produceren.

NOTE
U kunt regels verder configureren om alleen een set tekens toe te staan in de URL's van een AEM-site-uitvoer. Voor meer details, zie filename ontsmettingsregels voor het creëren van onderwerpen en het publiceren van de output van de Plaats van AEMvormen.

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 URL's te configureren die worden gegenereerd in AEM Site-uitvoer:

PIDEigenschappensleutelWaarde van eigenschap
com.adobe.fmdita.config.ConfigManageraemsite.pagetitleBoolean (true/false). Als u uitvoer wilt genereren met de paginatitel, stelt u deze eigenschap in op true. Standaard, wordt het geplaatst om het dossier te gebruiken - noem.
Standaardwaarde: vals