[Lenya Wiki] New: ContentEditorGuide

[de...@lenya.apache.org]

   Date: 2005-03-08T15:40:24
   Editor: JosephGrist
   Wiki: Lenya Wiki
   Page: ContentEditorGuide
   URL: http://wiki.apache.org/lenya/ContentEditorGuide

   no comment

New Page:

== Overview ==

This is intended as something that can be copied and turned into a manual for end users of your Lenya site. You may need to update parts of it if you, for example, have changed the workflow from the default. This assumes the site has already been set up for your end user with some sample content.

== Document ==

=== Overview and basic concepts ===

Your site is built using a system called Apache Lenya.  This provides you with the ability to maintain your site without any technical knowlege on building web sites.  All you need is a web browser.

Your site has two different "views".  One is the "authoring" view, and one is the "live" view.  They exist in different locations on the web.  You use the "authoring" view to edit the web site.  Public internet users see the "live" view of your web site.

When you make an update to your site using the authoring view, the changes will not be seen on the live view automatically.  The pages must first go through a process known as a workflow.  This involves different users and entails a review and approval process. When the changes to the page have been appropriately reviewed, they are sent to the live view.  This is known as "publishing" the page.

Documents in Lenya have "metadata".  Metadata can be described as information about a document, for example the author, the subject, the keywords.  It is important that the metadata of all the pages on your site is correct and up to date.


=== Basic Site Maintenance ===

==== How to access your site ====

Access the live site by entering the following location into your web browser [insert url here].

The location for the authoring view is [insert url here].

=== Logging in ===

There are two users defined.  The first user, username [xxx] and password [yyy], is an editor and has the ability to update documents.  The second user, username [xxx] and password [yyy], is a reviewer and has the ability to review documents and publish them onto the live site.

Type in the username and password for the user you wish to use.

=== What are the tabs at the top of the screen? ===

The "Admin" tab, is present, is for advanced administrative tasks.

The "Site" tab enables you to add/remove/move pages from your site, and edit page metadata.

The "Edit" tab enables you to navigate through your site visually and edit the text of pages.

The "Live" tab opens up the current page you are working with in a new browser window.  This lets you see how the current published version of the page looks.

=== How do I edit the text of a page? ===

If the "Edit" tab at the top of a page is not highlighted, click on it now.  You will see a visual representation of your site on the screen underneath the Lenya toolbar.  You can navigate through your site by clicking on the links as you normally would.  When you get to the page you want to edit, click on the edit menu.  From the menu, select "WYSIWYG Editor (Kupu)".  

You will proceed to a new screen and you may now edit the text of the page.  You can copy and paste text into the box from other applications.

Tip: if you completely ruin your formatting and want to start again, select all the text, and then select "Formatted" from the drop down box in the top righthand corner.  Then select "Normal".  this will clear all your formatting.

You can highlight sections of text and change them into heading using this drop down box also.

The "Formatted" option allows you to enter text in a monspaced font and align things using spaces.  This is great for things like computer code, or basic tabular data. 

When finished, ckick the disk icon to save, and then the red "power button" icon to exit.

=== How do I keep the metadata up to date? ===

Find the page who's metadata you wish to maintain using the same method as the previous step.  When you find the page, from the "Edit" menu, select "Edit Metadata".


Ensure the text in all the boxes is correct and up to date.  When done, click "save".

=== How do I publish my changes onto the live site ===

If you are logged in as a content editor you cannot do this directly.  You must, however, pass control to the content reviewer before documents can be published.  To do this, select "Submit" from the "Workflow" menu while viewing the document you wish to publish.

If you are logged in as a reviewer, first navigate to the page that needs to be published in the edit view.  Read the text carefully.  If you find problems such as spelling mistakes or incorrect content, the page cannot be published. Select "Reject" from the "Edit" menu to pass control of this page back to the content author.  If the page is OK to be published, select "Publish" from the "Workflow" menu to proceed.

=== How do I add a new page, and delete old ones ===

Todo

== Advanced Site Maintenance ==

=== How do I add an image to a page ===

Todo: there's a wiki page on this somewhere, link it.

=== Other things ===

Like language versions &c.  This is probably too implementation specific to be covered here.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lenya.apache.org
For additional commands, e-mail: dev-help@lenya.apache.org