A sablon fordítása

A sablon fordítása statikus HTML-oldalt hoz létre a sablonon belüli webhelyhez tartozó structure.json fájlban lévő minden egyes oldalhoz.

A fordítási lépés az oldal metaadatait (például 100.json) egyesíti az oldalelrendezéssel (például about.html), ami olyan HTML-oldalt eredményez, amely futásidejű vezérlő nélkül azonnal megjelenik. Az egyéni fordítók lehetővé teszik a futásidejű JavaScript végrehajtás további csökkentését a korábban dinamikus elemek, például navigálás és összetevők, fordításának oldalra való beszúrásával.

A cec compile-template parancs a következő műveleteket hajtja végre a webhely minden oldalánál:

A webhely és az oldal metaadatainak beolvasása
Az oldalelrendezés beolvasása és az oldalelrendezés fordítójának alkalmazása
Az oldal minden rekeszénél:
- A rekesz kibontása a page.json fájlban definiált ráccsal
- A rekeszen belüli minden összetevőnél:
  - Összetevő-fordító alkalmazása
  - Az összetevő előállított kódjának beszúrása a rekeszen belüli megfelelő helyen
A lefordított kódban lévő makrók kibontása és az SCS JavaScript objektum beszúrása, amelyet az Oracle Content Management megjelenítője használ futásidőben
Az oldal lefordított kódjának mentése a src/templates/<sablon>/static mappába

A webhely fordításához futtassa a következőket:

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

Fordítási hibák

A fordítás során az üzenetek három típusa jelenhet meg: Tájékoztatás, Figyelmeztetés és Hiba.

A tájékoztató üzenetek olyan problémákat jeleznek, amelyeket meg kell ismernie, de ezek valószínűleg a fordítás részeként várható üzenetek:
- Futásidőben megjelenített helyőrző tartalomelemek.
- Oldalelrendezés hiányzó fordítói. Az oldalelrendezések rendszerint nem rendelkeznek dinamikus elemmel, így nem tekinthető hibának, ha ez hiányzik.
- A „render on access” jelölésű elemek, azaz a webhely fejlesztője ezt az összetevőt dinamikusan kívánja megjeleníteni futásidőben még akkor is, ha az oldal le van fordítva.
A figyelmezető üzenetek olyan problémákat ismertetnek, amelyek vélhetőleg hatással lesznek a futó webhely teljesítményére, és ezeket lehetőség szerint javítani kell. Az ebbe a kategóriába tartozó elemek a következők:
- Tartalomelrendezés vagy egyéni összetevő hiányzó fordítói. Ezek nélkül az összetevők dinamikusan fognak megjelenni az oldalon, ahogy korábban.
- Hiányzó tartalomelrendezési leképezések. Nem valószínű, hogy a rendszer alapértelmezett tartalomelrendezését kívánja használni a tartalomelemek megjelenítéséhez.
A hibaüzenetek olyan problémákról szólnak, amelyek fordítási hibát jeleznek. Ahol lehetséges, folytatódik az oldalak fordítása, de a teljes fordítási művelet hibával fog kilépni.
- Ezt valószínűleg a JavaScript hibái okozzák az egyéni fordítókban, és az összes problémát meg kell oldani.

Megjegyzés:

Az ismétlődő üzenetek csökkentése érdekében ugyanaz az üzenet fordításonként csak egyszer fog megjelenni függetlenül attól, hogy az több oldalon is előfordul.

Az előző példa fordításánál a kilépési állapot a következő:

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

Ha a fordítási lépést a "-v" beállítással újból futtatja, a következő eredményt kapja:

> 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

Részletező oldal összeállítása

A részletező oldal összeállítása leválogatja az összes olyan tartalomelemet, amelyet az összeállítás során talál. Ezután újból összeállítja a részletező oldalt minden egyes talált tartalomelemhez, ehhez a részletértéket használja az új részletező oldalra mutató URL-cím definiálásához.

Az előző összeállítás eredménye két szakaszt érint:

Oldal összeállítása
Részletező oldal összeállítása

Az előző példában figyelmeztetések jelentek meg arról, hogy a tartalomelrendezéseknél nincsenek leképezési bejegyzések a Starter-Blog-Author oldalhoz. A Starter-Blog-Author oldalhoz azonban nincs szükség részletező oldalakra. A részletező oldal csak a Starter-Blog-Post tartalomelemeihez készül. A hibák eltávolításához a következő beállítással kizárhatjuk a tartalomelemeket a részletező oldal összeállításából, ha azok a beállításaikban nem rendelkeznek kifejezett hivatkozással részletező oldalra:

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

Így az összeállítás újbóli futtatása, amely kizárja az alapértelmezett részletező oldalt használó összeállítást, a következő eredményt adja:

> 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

Adott oldalak fordítása

Nem kell fordítania a sablonban lévő összes oldalt, és megadhatja a fordítani kívánt oldalakat. Ez akkor hasznos, ha olyan oldalakon dolgozik, amelyeken hibakeresést vagy módosítást kíván végrehajtani, és nem szeretné állandóan újrafordítani a teljes webhelyet.

Adott oldalak fordításához használja a --pages (-p) beállítást, és utána adja meg a fordításra szánt oldalak listáját.

Megjegyzés:

Megjegyzés: Ha a listán lévő oldalakon tartalomelemek hivatkoznak részletező oldalakra, akkor a részletező oldalakat is lefordítja a rendszer, bár kifejezetten nem szerepelnek a listán.

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