Uitvoer van AEM-site aanpassen
De AEM Guides ondersteunt het maken van uitvoerbestanden in de volgende indelingen:
- AEM-site
- 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.
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:
-
Gebruik de Manager van het Pakket om het standaardontwerpmalplaatje van de volgende plaats te downloaden:
/libs/fmdita/config/templates
-
Maak een kopie van de gedownloade bestanden op de volgende locatie in de Cloud Manager Git-opslagplaats:
/apps/fmdita/config/templates
-
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.
Eigenschap Beschrijving landingPageTemplate
,searchPageTemplate
,topicPageTemplate
,shadowPageTemplate
Geef het knooppunt cq:Template
voor deze overeenkomende pagina's op (landen, zoeken en onderwerpen). Standaard is het knooppuntcq: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 lusshadowPageTemplate
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 voortopicPageTemplate
specificeren. De eigenschappenlandingPageTemplate
ensearchPageTemplate
zijn optioneel. Geef deze eigenschappen niet op als u niet wilt dat de zoek- en bestemmingspagina's worden gegenereerd.title
Een beschrijvende naam van de ontwerpsjabloon. topicContentNode
De plaats van de knoop die de inhoud DITA in een onderwerppagina zal bevatten. Het pad is relatief ten opzichte van de onderwerppagina. topicHeadNode
De locatie van het knooppunt dat de hoofdwaarden (of metagegevens) bevat die zijn afgeleid van de DITA-inhoud. Pad is relatief ten opzichte van onderwerppagina. tocNode
De locatie van het knooppunt dat de inhoudsopgave zal bevatten. Het pad is relatief ten opzichte van de bestemmingspagina of het bestemmingspad. basePathProp
De eigenschapnaam voor het opslaan van het pad van de hoofdmap van de gepubliceerde site. indexPathProp
De eigenschapsnaam voor het opslaan van het pad van de bestemmings-/indexpagina van de gepubliceerde site. pdfPathProp
De bezitsnaam voor het opslaan van de weg van onderwerpPDF, als de generatie van onderwerpPDF wordt toegelaten. pdfTypeProp
De eigenschapsnaam voor het opslaan van het type van de PDF-generatie. Momenteel bevat deze eigenschap altijd "Onderwerp". searchPathProp
De eigenschapsnaam voor het opslaan van het pad van de zoekpagina als de sjabloon een zoekpagina bevat. siteTitleProp
De 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. sourcePathProp
De bezitsnaam voor het opslaan van de weg van het bronDITA onderwerp voor de huidige pagina. tocPathProp
De eigenschapnaam voor het opslaan van het pad van de inhoudsopgave-hoofdmap voor de gepubliceerde site.
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.
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:
PID | Eigenschappensleutel | Waarde van eigenschap |
---|---|---|
com.adobe.fmdita.config.ConfigManager | aemsite.pagetitle | Boolean (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 |