The WebJaxe CMS is included in PAELLOS, and is used for collaborative creation of XML documents in the XPAGES language. An automatic transform can transform these documents into websites. It can be done directly in WebJaxe to get a preview for authors, or with the PAELLOS platform administration to generate the training website for students and tutors.

• WebJaxe administrator guide
• WebJaxe user guide
• The XPAGES language

The administrator account is created at initialization time. It is possible to change the fields for this account in the user management section.

It will be assumed for now on that you are connected to the site as the administrator, which enables the administrative functions.

Site parameters

The parameters page lets you edit the following parameters :

• Jaxe configuration : choice of the XML language used for all contributions (currently provided with WebJaxe : XPAGES French, XPAGES English, or XHTML strict)
• Name of the websites folder : folder in which websites will be generated
• Database server : the address of the server hosting the database
• Name of the database : by default : webjaxe
• Database login : login to connect to the database
• Database password : password to connect to the database
• Administrator email : address where you receive the alerts email
• Mail management : Manage sending email
• SMTP server address : your provider or host SMTP server

User management

Each registration request is recorded in the database, but the corresponding users cannot connect until their registration is validated by the administrator. If the administrator rejects a registration, it is deleted.

The list of registration queries on the "User management" page gives the list of the users who registered, and lets you accept or not each registration.

From the user management page, it is also possible to :

• Edit the fields for users in the database, in particular passwords (leave the field empty if you don't want to change a password).
• Remove a user definitely. His contributions then pass under control of the administrator.

Project management

The project management page is used to create new projects, and change the list of contributions and participants for each project. There is no direct link between contributions and users: the links are established through the projects.

The administrator can organize projects as a tree, which is handful when there are a lot of contributions. To change the tree structure, click on the "Sub-projects" button for the parent project on the project management page. The list of sub-projects can then be changed for this project. A user associated with a project is implicitely associated with all the descendant projects. An export of the parent project will contain all the contributions of the parent project and its descendants.

Contribution management

Each contribution is associated with a single project.

The contribution management page gives the list of the contributions, and can be used for each contribution to change the associated project, to edit it or remove it.

A form at the bottom can be used to create a new contribution.

This page can also be used to edit a contribution (by redirecting to the "user side" of WebJaxe), and to remove a contribution.

WebJaxe is distributed with a configuration for the "XPAGES" XML language (in French and in English), and another one for the "XHTML strict 1.0" XML language. It is possible to add new configurations to edit documents in other XML languages, and generate corresponding websites.

To add a new configuration, that we will call "MYCONFIG" :

• Create a folder named MYCONFIG in WebJaxe's config folder.
• Place inside the Jaxe configuration file using the file name MYCONFIG_config.xml, as well as the XML schema.
• To enable transformations into websites, it is necessary to create a file called MYCONFIG.php in a php folder inside the MYCONFIG folder, with the PHP function transfo_webjaxe($contribs_folder, $xml_to_process, $path_to_site, $config_folder, $temp_folder). The XHTML config gives a simple implementation example for this function, using an XSLT transform.

Registration on a WebJaxe website

To participate to the creation of a website with WebJaxe, it is first necessary to register. To do that, just go to the registration page (there is a link from the first page), and fill in the different fields.

The login is a unique identifier. A new user is choosing the login, but (as opposed to the fields for the firstname and the lastname), the only letters accepted are the letters from a to z, with no space or special character.

Choose an original password, but don't lose it ! You can ask for help to the administrator if you lose it, but changing a password is not automatic.

Once the registration form submitted, the administrator will be able to validate (or not) your registration. It is only after the registration is validated by the administrator that it becomes possible to log in, with the chosen login and password.

Login for a WebJaxe website

To log in, just enter the login and password chosen at registration time.

List of contributions

Creating a website is done with a number of contributions. A contribution corresponds to a set of pages on a given subject (usually less than 10 pages). A contribution is a folder containing an XML file with the text of the pages, and the files of the images used in the pages.

Certain contributions are only used to link contributions with each other. For instance, it is possible to create a contribution for the whole website to create, and this contribution will only contain links to the other contributions.

Contributions are organized into projects. A project gathers contributions and authors on a given subject. All the authors in a project can edit all the project's contributions.

As a user, you can create a new project, a new contribution, and edit the contributions created by other users if these contributions are in a project of which you are author. The administrator can add authors or contributions to a project.

A project can be exported. This operation starts the download of a ZIP file containing a copy of all the contributions in the project.

Nouvelle contribution

There are two methods to create a new contribution in WebJaxe: the creation of an empty contribution, and the import of an existing contribution. In both cases, it is necessary to specify the associated project and the Jaxe configuration (which corresponds to the XML language).

In the case of an import, the imported file must be a ZIP file with the name of the contribution. This ZIP file must contain a folder with the name of the contribution, containing an XML file with the name of the contribution. For instance, the imported file could be "my-contribution.zip", containing a "my-contribution" folder, with a "my-contribution.xml" file inside.

Since contribution export uses the same organization, it is easy to export a contribution from a WebJaxe site and to import it into another one.

Possible operations on a contribution

There are 10 possible operations on a contribution :

• Edit XML file : this operation launches the applet with the Jaxe editor. It is necessary to enable Java (version 1.6 or later) in order for this operation to work (Java is not to be confused with Javascript - Javascript is not necessary with WebJaxe).
• Manage associated files : this lets you deposit images on the server, and organize them into folders. The image files can then be referenced in the editor to be incorporated into pages.
• Generate website : this starts the automatic generation of the website, and redirects to the home page of the new website. It can be necessary to use the web browser "reload" button if old pages (preserved in the browser cache) are displayed.
• View website : available once the website has been generated, this operation can be used to go directly to the website without generating it.
• Export contribution : compresses all the contents of the contribution in a ZIP file, and downloads it. The ZIP file can then be uncompressed, and the XML file can be edited with the Jaxe application off-line.
• Changes history : when the XML document has been changed, this operation is used to check the differences between each version of the document and the latest version.
• Remove contribution (only available if the user is the only author for the contribution's project or if he is the administrator) : removes the contribution.
• Renaming of the contribution
• Export website: regenerates all the website, and compresses its content in a ZIP file.
• Clearing the generated website

Edition with Jaxe

WebJaxe's editor requires Java 1.6. It opens in a new window. Be careful not to close the initial window in the web browser, because that would make the edition window disappear without letting you save the document.

The editor works with the XML meta-language, and entered texts are thus organized with begin and end tags. Each piece of text is surrounded by tags that give it meaning. New elements can be inserted with the menus, or with the insertion panel on the left of the window. The insertion panel only displays elements that are allowed at the cursor position, in order to prevent the creation of an invalid document (a document that does not respect the rules of the chosen XML language).

The available elements, as well as the tree rules for the elements, are defined by the XML language chosen by the administrator. It is important to learn the chosen language to use the editor in the best way. A specific documentation exists for the XPAGES language, whose WebJaxe configuration is provided with WebJaxe.

There exists a user guide for the Jaxe application, that mostly applies to WebJaxe's editor. However, there are some features that don't exist in WebJaxe. Some other features are disabled because of security restrictions imposed to Java applets by web browsers, such as copy/paste (see below).

Management of associated files

This page is used to manage the files associated to a contribution. They are usually files of images used when editing the XML document. It is possible to organize these files with directories. To add a new file, just click on the corresponding button, choose the file on the local hard disk, and click on the "Add" button. It is then displayed in the list of files for the current directory.

Once an image file is added, it is possible to use it during edition. For instance, with the XPAGES language, an image is added by first creating an "Image environment", and then adding a "File" inside. The path to the image file in the contribution is used as the "file name", for instance "logo.png". The image is displayed in the editor when the dialog is validated.

Operations on a contribution: Changes history

The Changes history button displays when the XML document is changed.

Changes history

Each history is followed by the login of the author who has changed.

Comparison with the latest version

You can compare versions of the XML document, and check the differences between each version of the document and the latest version.

Differences between each version of the document and the latest version

User preferences: Change the language, the user password or email

Change the user interface language. The default language is one that was chosen during the registration on WebJaxe.

The new password must use at least 4 characters, and must contain only letters without accent, numbers, dashes or underscores.

The email adress must be valid.

Starting with WebJaxe 2.0, it is possible to choose the editor. Jaxe, the default editor, works as a Java applet and requires an enabled Java plugin in the web browser. Daxe works with Javascript and requires its activation. Daxe only works on modern web browsers (for instance, it does not work with Internet Explorer before version 9).

Do search

This page allows the user to search for a keyword in all the contributions of a project.

Organisation

XPAGES documents have a root element, XPAGES set, that is used in all the documents as a first level element. Under this element, the following elements can be found : Informations, Page, Ref. XPAGES document and XPAGES set.

• Informations is a metadata block, i.e. informations about the document. It is described later on.
• Page represents a web page, and has a title and a label used to create links to the page. In the latest version of XPAGES, it is possible to associate a semantic role to pages (as with sections).
• Ref. XPAGES document is a reference (via the label) to another XPAGES document, that will be included in place of the Ref. XPAGES document element. This is used to create a website with several levels : for instance, one can create a website with a home page, and several sets of pages. To do that, an XPAGES document is created for the website, containing the home page and Ref. XPAGES document references to the different sets of pages in the website.
• XPAGES set under XPAGES set can be used to add another level to the tree, as with REFXPAGES, but without creating a new document.

Inside a page, sections can be created with the Section element. This element has a title, a role that specifies the meaning of the section and can result in a different display for each function, and an importance that can be used to highlight the section if it is important.

The text is added inside paragraphs, with the Paragraph element. It is easy to insert a new paragraph with the command-P or control-P shortcut in Jaxe.

It is possible to create several contributions, each one containing an XPAGES XML file and the associated files (images, Java applets, ...). Each contribution corresponds to a folder whose name is the same as the label given in the Informations block in the XML file. This folder contains the XML file and the associated files.

The information block provides information about the document, and is also used to choose a skin for the generated website. It is required, and is located at the beginning of the document. It has the following children :

• Label : a name used later to reference the document with the Ref. XPAGES document element, to include the content of the document in a larger one. The label is required, and must match the name of the XML file without the ".xml" extension. In WebJaxe, this label must simply be the name of the contribution.
• Title : the document title (required).
• Author : an author of the document. It is of course possible to specify several authors.
• Author : the creation date of the document, with the syntax DD/MM/YYYY.
• Update date : the update date of the document, with the syntax DD/MM/YYYY.
• Logo : path to an image file with a logo to use on the website. The image must be in a standard format for the web (JPEG, PNG or GIF). It is possible to specify a link to use when the logo is clicked.
• Interface : choice of a skin for the pages.
• Menubar : to choose whether or not to display the buttons on top of web pages to navigate to the subsets referenced with REFXPAGES.
• Language : the code for the document language (en for English).

XPAGES has the following block elements :

• Section : used to identify an area inside a page, with a title, a semantic role, and an importance. The role is optional, but is important to give meaning to the different parts of the document. It can also be used later to display sections with the same role in a similar way, to visually distinguish them from other sections.
• Paragraph : a paragraph is one or several sentences. To do a "line break" (this idea is quoted because it is related to presentation instead of content), it is necessary to create a new paragraph.
• List : a list of List item elements with bullets or numbers. Items can contain text, but also paragraphs or sublists.
• Table : a table is formed with a given number of lines and columns. It is possible to specify a line of titles (the first line of the table). Also, cells can be merged, and an alignment can be specified inside the cells.
• Image environment : an element grouping the informations related to an image, animation or video (copyright and legend), and a link to the corresponding file. It is also possible to create a link on the image, so that a click on it redirects to another part of the site or an external page. In the case of a video available in several alternative formats, the files have to be specified inside a Formats element.
• Interactive application : a program written in Java, Flash, or HTML/Javascript. This new XPAGES element replaces the old elements Java applets and Flash object. If an application is used several times on the site, it is possible to store it in a contribution and to use it in other contributions. In that case, the contribution attribute is used to specify where to look for it.
• Comment : a comment of the author, that will not be displayed on the website. Very useful for instance to mark parts to develop or correct at the time of writing.
• Code : a block of computer code whose formatting must be preserved.
• Exercise : an exercise (see later).
• Quiz : a quiz (see later).
• Bibliography : a list of bibliographic and webographic references.

Some XPAGES elements can be mixed with text, for instance inside a paragraph. They are the following elements :

• Link to internal page : link to a page on the same website. To identify the page to link to, the label of the contribution and the label of the page have to be entered. If only the label of the page is given, it is assumed to be in the same contribution. If only the label of the contribution is given, the link directs to the first page in this contribution.
• External link : link to a web page external to the website. The address (URL) must start with "http://".
• Image link : link to an image environment. Can only be used for images on the same page. For instance, it is possible to change the displayed image with the "page" layout by using several image links in the text of the page.
• File : an image or animation file. Normally used inside an Image environment element, so that a legend can be specified, but it can also be used within the text (for instance to include a symbol that could not be created with an equation).
• Symbol : greek letter or mathematical symbol.
• Equation : equation based on Jaxe's equation editor syntax.
• TeX Equation : equation based on the TeX syntax.
• Glossary word : word to include in the glossary. The word to display is specified with the word attribute, and the definition for the word is given within the Glossary word tags.
• Emphasis : emphasis (to highlight one or several words).
• Superscript : superscript text
• Subscript : subscript text
• Code : computer science code (usually displayed with a monospaced font)
• Non-breaking space : non-breaking space

XPAGES can be used for many applications, but it is especially handy to create online courses, and was created in this context. For these reasons, the language contains elements specific to the definition of exercises, even though these elements might not be useful outside of the context of online courses.

There are two types of exercises : the question-answer type (Exercise element), and the quiz type (Quiz element). In both cases, an exercise can have a title (title attribute), an indication of the difficulty (Difficulty element), an indication of the time necessary to complete the exercise (Time element), and questions (Question and Quiz question elements).

Each question can have terms (Terms element) and one or more helps (Help element). Questions of type question-answer have a solution (Solution element) and a number of points that can be granted if the answer is correct (Points element). Questions of the quiz type have possible answers (Quiz answer element), each answer being either right or wrong (correct attribute), with the text of the answer (Answer text element) and a comment which will be displayed to the user should he choose this answer, for instance to explain why the answer is wrong (Answer comment element).

In Jaxe, solutions for evaluation exercises are not added to HTML when the "public website" is generated. They are added when the "production website" is created. WebJaxe always creates the production website. To create a public website from a contribution in WebJaxe, the contribution has to be exported and opened with Jaxe. In this way, it is possible to create, from the same XML files, a website for students, and another one for tutors for an elearning program.