Mallipohjan kääntäminen

Mallipohjan kääntämisen yhteydessä kullekin mallipohjan structure.json-tiedoston sivulle luodaan staattinen HTML-sivu.

Käännösvaiheessa sivun metatiedot (esimerkiksi 100.json) yhdistetään sivun asetteluun (esimerkiksi about.html). Tuloksena on HTML-sivu, joka näkyy heti. Ajonaikaista ohjainta ei siis tarvita. Mukautettujen kääntäjien avulla voit vähentää ajonaikaista JavaScriptin suoritusaikaa vielä enemmän, kun sivulle käännetään aikaisempia dynaamisia kohteita, kuten navigointia ja komponentteja.

cec compile-template -komento suorittaa seuraavat toimenpiteet sivuston kaikilla sivuilla:

Sivustojen ja sivun metatietojen lukeminen
Sivun asettelun lukeminen ja sivun asettelun kääntäjän käyttö
Sivun jokaisella paikalla:
- Laajenna paikka page.json-tiedostossa määritetyllä ruudukolla
- Nämä koskevat paikan jokaista komponenttia:
  - Käytä mitä tahansa komponentin kääntäjää.
  - Lisää luotu komponenttimerkintä paikan vastaavaan sijaintiin.
Laajenna kaikki mahdolliset makrot käännetyssä merkinnässä ja lisää SCS JavaScript -objekti, jota Oracle Content Management -muodostusohjelma käyttää ajon aikana.
Tallenna käännetyn sivun merkintä src/templates/<template>/static-kansioon.

Aja seuraavat sivuston kääntämistä varten:

> cec compile-template BlogTemplate
Compile Template: compiling template BlogTemplate
Oracle Content Management Site Compiler

createPage: Processing pageId 100. Preview URL:
http://localhost:8085/templates/BlogTemplate/index.html
createPage: Processing pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail.html
createPage: Processing pageId 401. Preview URL:
http://localhost:8085/templates/BlogTemplate/about.html
createPage: Processing pageId 402. Preview URL:
http://localhost:8085/templates/BlogTemplate/search.html
createPage: Processing pageId 403. Preview URL:
http://localhost:8085/templates/BlogTemplate/authors.html
All page creation calls complete.

Käännösvirheet

Voit saada koodin kääntämisen aikana kolmenlaisia sanomia: tieto-, varoitus- ja virhesanomia.

Tietosanomissa sinulle kerrotaan asioista, jotka on hyvä ottaa huomioon. Nämä sanomat ovat todennäköisesti odotettavissa oleva osa koodin käännösprosessia:
- Paikanvaraajina toimivat sisältökohteet, jotka muodostetaan ajon aikana.
- Puuttuvat sivun asettelun kääntäjät. Sivun asetteluissa ei ole välttämättä yhtään dynaamista elementtiä, joten niiden puuttumista ei pidetä ongelmana.
- Kohteet, joka on merkitty "muodosta käytön yhteydessä". Sivuston kehittäjä haluaa, että kyseinen komponentti muodostetaan dynaamisesti ajon aikana, vaikka sivun koodi onkin käännetty.
Varoitussanomat kertovat käynnissä olevan sivustoon suorituskykyyn vaikuttavista tilanteista, jotka pitäisi korjata mahdollisuuksien mukaan. Tähän luokkaan kuuluvat kohteet:
- Puuttuvat sisällön asettelun tai mukautettujen komponenttien kääntäjät. Ilman niitä komponentit muodostetaan sivulle dynaamisesti entiseen tapaan.
- Puuttuvat sisällön asettelun kartat. On epätodennäköistä, että haluaisit käyttää järjestelmän oletusarvoista sisällön asettelua sisältökohteiden muodostukseen.
Virhesanomat osoittavat koodin käännöksen epäonnistuneen. Sivut jatkavat koodin kääntämistä mahdollisuuksien mukaan, mutta kokonaisuudessaan kääntäminen lopetetaan virheeseen.
- Tämä johtuu todennäköisesti mukautetuissa kääntäjissä olevista JavaScript-virheistä, ja kaikki virheet on korjattava.

Huomautus::

Toistuvien sanomien vähentämiseksi sama sanoma näytetään vain kerran käännöstä kohden riippumatta siitä, esiintyykö se usealla sivulla.

Edellä mainitulla esimerkillä on seuraava käännöksen lopetuksen tila:

Compilation completed with 0 errors and 3 warnings. 
to display warnings, run with --verbose (-v) option.

Jos ajat käännösvaiheen uudelleen käyttämällä "-v"-valintaa, näet seuraavan tuloksen:

> cec compile-template BlogTemplate --verbose
Compile Template: compiling template BlogTemplate
Oracle Content Management Site Compiler

createPage: Processing pageId 100. Preview URL:
http://localhost:8085/templates/BlogTemplate/index.html
createPage: Processing pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail.html
Info: no content item specified for placeholder: a890a65c-c0fc-451b-966b-e606ca18a1f4
component will render at runtime.
Info: no content item specified for placeholder: c90bbc10-c9d8-4a54-8dd4-7a8251e8efbb
component will render at runtime.
Info: no content item specified for placeholder: f12691e1-79ab-4d1f-a8b9-3af8c638dd26
component will render at runtime.
createPage: Processing pageId 401. Preview URL:
http://localhost:8085/templates/BlogTemplate/about.html
createPage: Processing pageId 402. Preview URL:
http://localhost:8085/templates/BlogTemplate/search.html
Info: Component: "fdfd0392-e901-48f6-8044-36803c836aa1" of type "scs-contentlist" marked as
"render on access", will not be compiled.
Info: Component: "ba9f3711-4367-444e-ae38-71289fc10e73" of type "scs-contentlist" marked as
"render on access", will not be compiled.
createPage: Processing pageId 403. Preview URL:
http://localhost:8085/templates/BlogTemplate/authors.html
All page creation calls complete.

Creating detail pages:
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063051-developing-content- layout-for-content-and-experience-cloud
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063052-dynamic-dom- manipulation-in-content-layout
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063045-getting-media-url-in- the-content-layout
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063053-getting-reference- items-in-content-layout
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063048-navigating-to-a- search-page-with-search-query
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063050-alex-read
Warning: failed to find content layout map entry for: Starter-Blog-Author:header. Will compile
using the system default layout.
Warning: failed to find content layout map entry for: Starter-Blog-Author:content. Will compile
using the system default layout.
Warning: failed to find content layout map entry for: Starter-Blog-Author:sidebar. Will compile
using the system default layout.
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063047-jerrold-summers
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063049-kelly-emerson
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063043-samantha-howard
createPage: Processing detail pageId 105.
Preview URL: http://localhost:8085/templates/BlogTemplate/post-detail/1481786063046-raising-triggers-from- content-layout
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063044-rendering-the-content- layout-using-mustache-template
All detail page creation calls complete.

Compilation completed with 0 errors and 3 warnings.

*** compiled template is ready to test
*** to render non-compiled pages, remove compiled files from under: /private/tmp/cec-
src/src/templates/BlogTemplate/static

Tietosivun kääntäminen

Tietosivun käännöksessä kootaan kaikki kääntämisen aikana vastaan tulleet sisältökohteet. Sen jälkeen kunkin löydetyn sisältökohteen tietosivu käännetään uudelleen käyttämällä tietokentän arvoa uuden tietosivun URL-osoitteen määrittämiseen.

Edeltävä käännös suoritetaan kahdessa osassa:

Sivun kääntäminen
Tietosivun kääntäminen

Edeltävässä esimerkissä näkyy varoituksia siitä, että Starter-Blog-Author-sivulla ei ole sisällön asettelun karttamerkintöjä. Starter-Blog-Author-tietosivuja ei kuitenkaan haluta. Tietosivu koskee vain Starter-Blog-Post-sisältökohteita. Nämä virheet voidaan korjata jättämällä sisältökohteet pois tietosivun käännöksestä, jos niiden asetuksissa ei ole viitattu täsmälliseen tietosivuun. Tämä valinta sopii siihen:

--noDefaultDetailPageLink, -o  Do not generate compiled detail page for items/content lists
      that use the default detail page.

Jos käännös suoritetaan uudelleen ja suljetaan pois tietosivun luonti, jossa käytetään oletustietosivua, tuloksena on seuraava:

> cec compile-template BlogTemplate --noDefaultDetailPageLink 
Compile Template: compiling template BlogTemplate 
Oracle Content Management Site Compiler 

createPage: Processing pageId 100. Preview URL: 
http://localhost:8085/templates/BlogTemplate/index.html 
createPage: Processing pageId 105. Preview URL: 
http://localhost:8085/templates/BlogTemplate/post-detail.html 
createPage: Processing pageId 401. Preview URL: 
http://localhost:8085/templates/BlogTemplate/about.html 
createPage: Processing pageId 402. Preview URL: 
http://localhost:8085/templates/BlogTemplate/search.html 
createPage: Processing pageId 403. Preview URL: 
http://localhost:8085/templates/BlogTemplate/authors.html 
All page creation calls complete.

Creating detail pages: 
createPage: Processing detail pageId 105. Preview URL: 
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063051-developing-content-
layout-for-content-and-experience-cloud
createPage: Processing detail pageId 105. Preview URL:
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063052-dynamic-dom -manipulation-in-content-layout
createPage: Processing detail pageId 105. Preview URL: 
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063045-getting-media-url-in- the-content-layout
createPage: Processing detail pageId 105. Preview URL:  
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063053-getting-reference- items-in-content-layout
createPage: Processing detail pageId 105. Preview URL: 
http://localhost:8085/templates/BlogTemplate/post-detail/1481786063048-navigating-to-a- search-page-with-search-query
All detail page creation calls complete.

Compilation completed with no errors.

*** compiled template is ready to test 
*** to render non-compiled pages, remove compiled files from under: /private/tmp/cec-
src/src/templates/BlogTemplate/static

Tiettyjen sivujen koodin kääntäminen

Kaikkia mallipohjan sivuja ei tarvitse kääntää, ja voit valita käännettävät sivut. Tämä on kätevää silloin, kun haluat suorittaa virheenetsinnän tai päivityksen tietyille sivuille etkä kääntää koko sivuston koodia jatkuvasti uudelleen.

Jos haluat kääntää tiettyjä sivuja, käytä --pages (-p)-valintaa, jonka perässä on lista sivuista, joiden koodin haluat kääntää.

Huomautus::

Huomautus: jos sisältökohteet ovat listaviitteen tietosivuilla, myös tietosivut käännetään, vaikka niitä ei lisätäkään erikseen.

cec compile-template BlogTemplate --pages 401,402 
Compile Template: compiling template BlogTemplate 
Oracle Content Management Site Compiler

createPage: Processing pageId 401. Preview URL: 
http://localhost:8085/templates/BlogTemplate/about.html 
createPage: Processing pageId 402. Preview URL: 
http://localhost:8085/templates/BlogTemplate/search.html 
All page creation calls complete.

Compilation completed with no errors. 
*** compiled template is ready to test 
*** to render non-compiled pages, remove compiled files from under: /private/tmp/cec- 
src/src/templates/BlogTemplate/static