TRIUMF Lenya Help Documentation

Using Lenya

A Lenya web site provides convenient content management: web pages are created and deployed in a user-friendly fashion from the comfort of a web browser.  Web pages are versioned, and it is easy to 'rollback' to a previous version of the web page. Authenticated users may edit web pages at their leisure without the public seeing the intermediate pages; they may upload images and other content to the site from their browser.  Only when the user is happy with the page does she 'submit' the web page for approval.  If the user has been assigned enough privileges she may also approve the page for publishing.  Only at that moment does the public see the newly-editted pages.

Live vs Authoring Pages

The public sees the live, or published, pages. Authoring pages, on the other hand, are only visible to the logged-in user who has the rights to edit those pages.

When you authenticate to a Lenya-based web site you see a set of 4 tabs in the top menu - Admin, Site, Authoring, and Live - as in the following image:

Clicking on the Live tab will result in a view of the currently-selected page as the public sees it.  Clicking on the Authoring tab shows a view of the currently-selected page with the set of menu tabs at the top as shown.
On the right of the tabs is the status of the workflow state (authoring or live) and the login name.
The other two tabs, Admin and Site are described in the detailed description.

User Accounts

For authentication a typical Lenya web site would have web site login accounts with different roles:

  • Role editor - the user has the right to create, edit and submit pages for publication.
  • Role reviewer - the user has the right to publish or reject submitted web pages.
  • Role admin - see the detailed description.
This TRIUMF Grid web site has combined the authoring roles.  Thus our authoring accounts have both editor and reviewer rights, and may therefore submit and publish in one step, by selecting publish from the Workflow menu., as in the following menu image:

Creating / Deleting Pages

A new web page can be inserted by selecting the 'New Document' option from the File menu, either from under the Authoring tab, or from under the Site tab:

The new document will be created under the page hierachy of the currently selected web page. To understand more about the page hierarchy in a publication please visit the Site Tab Help.

You must give the page minimally a ' Document ID ' and a ' Navigation Title '. The Document ID turns out to be the name of the page and the directory where the page resides in statically-generated HTML.  Therefore please do not use spaces in the name, and keep the name short and sweet.  The Navigation Title is the title for the menu entry on the left for that document.  It should be short and sweet also.  Click on the Create button to create the page.  The web page that appears is a template page that you will need to edit.  From the Edit menu select 'Edit Metadata' to set the Page Title.  This would typically be the same as the Navigation Title, or optionally longer and more descriptive.

A page may not be deleted until it has been deactivated, which is to say that it has been removed from the public, live site.  This is accomplished using the Workflow menu and selecting Deactivate for the currently-selected page.  Once the page is deactivated it may be removed by selecting 'Delete' from the Edit menu under the Site tab.

Editting Pages

To edit the page you must be in Authoring mode.  Select the web page to edit, and then an editor from the Edit menu. There are 2 WYSIWYG javascript editors - Kupu is the preferred editor at this time, as BXE is very fussy about imperfect html, and it does not coexist happily with Kupu.  See the Kupu help pages for tips on using Kupu.