Cocoon And Manakin

From Dryad wiki
Revision as of 10:13, 23 March 2018 by Ryan Scherle (talk | contribs)

Jump to: navigation, search

The DSpace user interface layer is called Manakin. It is based on Apache Cocoon. Here are some helpful notes.

Philosophy

  • An "aspect" is a bit of java code that creates XML to be inserted into a page. Aspects usually represent things that are repeated on multiple pages (e.g., the user's login status and associated menu items)
  • A "theme" applies XSL to create HTML, which dictates the content's basic layout. We use separate themes for the Dryad look-and-feel, and the DryadLab look-and-feel.
  • CSS dictates how the layout is rendered.
  • JavaScript dictates how the rendering behaves.

Samples

  • (repo)/xmltest/form/basic
  • (repo)/xmltest/form/inline
  • (repo)/xmltest/form/advanced
  • (repo)/xmltest/form/structural
  • (repo)/xmltest/form/HTML

Flow of control

  • the theme directs a call to sitemap.xmap for each abstract
  • sitemap.xmap determines what classes to call
  • pipeline may include a selector (decides which section of a pipeline to follow)
  • pipeline must have a generator and serializer.
  • pipeline may have an optional number of transformers in between
  • all steps in a pipeline may be subject to matchers that turn pieces on and off for certain URLs.
  • pipeline transformer classes modify the DRI
  • the serializer runs the DRI through XSL in i18n
  • the resultant page is sent to the browser, which may apply a CSS