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

OPMERKING
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

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

  1. Gebruik de instructies die in worden gegeven met voeten treedt van de Configuratieom het configuratiedossier tot stand te brengen.
  2. In het configuratiedossier, verstrek de volgende (bezit) details om de paginanamen voor de onderwerpen te vormen.
PIDEigenschappensleutelWaarde van eigenschap
com.adobe.fmdita.common.SanitizeNodeNamenodename.systemDefinedPageNameBoolean (true/false). Standaardwaarde: false

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.

Configureer de regels voor bestandsontsmetting voor het maken van onderwerpen en het publiceren van uitvoer in AEM Sites en andere indelingen

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 Site-pagina'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.

OPMERKING
Als u de geldige lijst met speciale tekens niet configureert, kan het maken van bestanden onverwachte resultaten opleveren.

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) gegevens op om de geldige speciale tekens in bestandsnamen en uitvoer van AEM-site te configureren:

PIDEigenschappensleutelWaarde van eigenschap
com.adobe.fmdita.common.SanitizeNodeNameImplaemsite.DisallowedFileNameCharsControleer of de eigenschap is ingesteld op '<>`@$ . U kunt meer speciale tekens aan deze lijst toevoegen.
OPMERKING
De bovenstaande configuratie geldt voor alle uitvoerindelingen. Dit betekent dat bij het genereren van een PDF-, HTML- of aangepaste uitvoer de uiteindelijke uitvoer de geconfigureerde regels voor bestandsontsmetting volgt.

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:

EigenschappensleutelWaarde van eigenschap
nodename.uselowerBoolean (true/false).
Standaardwaarde: waar
nodename.separatorElk teken.
Standaardwaarde: _ \ (onderstrepingsteken )
nodename.maxlengthWaarde van gehele getallen.
Standaardwaarde: 50