Skip navigation.
Home
ALICE Offline Pages
Home » For Editors

Guidelines for ALICE Editors:

Contents

Login Policy

In general, members of ALICE collaboration (Registered as CERN users having a NICE account valid) may login into the system. This list is not managed by the webmaster.  Altgough "recognized" you should not be granted with edition pemission. Only Logged In Users  belonging to a proper group will have addition/edition/deletion of contents. Please contact webmaster for this purpose.

If you have problems login in:

Page Edition:

If you are member of Editor Group, you should be able to edit any of the pages already created. A full list of them can be found in:

  1. Notice that only valid user will be able to display the procedure bellow.
  2. Navigation bar to the left » Administer » Content Management » Content
  3. A full list of pages will show up (you may filter it). Click on Edit
  4. Select one of the visibles in the navigation or point directly to the page of your choice.
  5. If you want more filtering options (user, roles, contents, dates, etc) you may use Administer » Content Management » Content Management Filter. Kindly notice that this engine relies on the Information you supplied at creation time, do not expect miracles.It may also be found on a dedicated tab into your account information (My account, you are allowed to see only resources authored by you so please change the "Autoring Information" field accordingly, it may has being created by someone else, i. e. Super User)
  6. Many pages might have been created by a webmaster. You may find the authoring so you may easily filter your own pages using filter engine described in Step 5.
  7. If you make a change into a page you may add its "Revision Information"

Content creation:

  1. In NavigationNavigation go to Create Content » Page
  2. Set Mandatory fields.
  3. Add it to the navigation select "Menu Settings"
    1. Set a link title (as will be shown in the navigation)
    2. Select the parent Item (i.e. if you select "AliRoot" it will b shown under "AliRoot" Block in the navigation)
    3. "Weight" helps you set the adecuate position in the list
  4. Add the content
    1. make a link using the editor. In the pop up window "Browse server" so you can check where to put/get things through that interface
  5. You can set as many info rtelated to the page as possible in links bellow "Revision Information" "File Attachment" etc. Specially for
    1. URL Path Setting: supply the alias for the page you create
    2. NOTICE: By default, at creation, the page is "Offline" if you want it to be public select "Publishing Information" and check the Published Field.
  6. You can preview/save/delete your page using the appropriate button at the end.

For instance: http://aliweb.cern.ch/Offline/AliRoot/Releases.html is the same as the url served previosuly http://aliceinfo.cern.ch/Offline/AliRoot/Releases.html. It has checked the field "Promoted to front page" so any time a change is done there there will be a link in the main page pointing to it. That's also the example of a "URL Path Setting" matching the URL construction as in Opencms.

How to protect a given page:

A secure page, similar in form to a page, is a simple method for creating and displaying information. By default, a secure page entry does not allow visitor comments. Create content with this type will prevent anonymous users from read it. Only authenticated users can. After Creation (i.e. saving it), Editor will an extra tab, "Access Control", to set or revoke permissions to given roles. If you need special role please contact webmaster.

  1. Follow the same procedure as content creation but choose Secure Page

How to revert changes

Changes in page contents can be reverted by yourself as long as you have follow this rules:

  1. When commiting a change into a given page fill accordingly "Revision Information" field.
  2. Everytime you are logged as editor and visit that page a new tab will show up (top of page) giving you the information on the version you are using and all previous one to which you may revert changes. Notice it will only show the changes only to versions where you set "Revision Information".

Where should I post my pictures or download-"able" files.

If you have not asked for a specific location there is a default one available.

  1. At creation of your document. Select in the WYSIWYG editor the image insert icon or edit/insert link.
  2. In the pop up window select "Browse server". It will provide you with an interface to manage (insert/upload/delete) files/images in a default location in the server.
  3. If you need special location (access secure by password) please contact ALICE webmaster to set it up.

 How to post a Frequently Asked Questions (FAQ)

  1. In Navigation go to Create Content » FAQ
  2. Webmasters have created a few categories that you must select at least one for your question and answer.
  3. Fill in the form
  4. In "Publishing options" Select "Published"
  5. Save the page and your Q&A will be posted in the FAQ section under the category you choose.
  6. If your Q&Answers do not match in any of those categories ask the webmaster to open a new one for you.

Editing pages

This part is meant to provide a guide for single layout and pursuit of standardization of contents presented in the Offline web pages. It will grow as long as users supply ideas in such matter. The changes will be easy to manage by user and it will require just a rough knowledge of HTML editing. The rest of the work will be done by the Cascade Sheet Style defined for Offline pages.
Extense usage of this features will lead to a faster and comprehensive web site and will help page editors to write down less complex codes. So everybody wins.

 

For those who edit directly the source code of the page

Stylish boxes

The following line:

<div id="code">This is a stylish line code</div>

will produce this:

This is a stylish line code

A more hightlighted box let say for a piece of file like:

This is a stylish code
This is a stylish code
This is a stylish code

will be produced by:

<div id="file">
This is a stylish code <br />
This is a stylish code <br />
This is a stylish code <br />
</div>

 

Stylish text

You probably have noticed that in this page there has been some nicely formated text suitable for ALICE coding hightlighting, which is spread all over the site. To achieve:

ALICE coding hightlighting

<font id="alicode">ALICE coding hightlighting</font>

Top of page

 

Using Opencms WYSIWYG editor

To accomplish above changes, users now may apply them using HTML WYSIWYG supplied by OpenCms. Special styles for the page are available in the Style drop-down menu on the default Tool Bar  (as showed in the picture bellow). At the moment only those depicted in previous paragraph.
 

styles-in-toolbar

Yet, some key knowledge on how to use the OpenCms editor are needed. First of all, users must know that every time Return key is pressed the OpenCms editor default behavior is to close a former and open a new paragraph tag (i.e. </p><p>). Such behavior is changed if the combination Shift + Return keys is used. In this case the Editor will break the line with the break line tag (<br />). For the usage of this special div, users are encouraged to know this simple action while typing or some undesirable div edition problems will arise.

Users are advised to proceed as:

  1. Write the piece of information (using <br /> to break lines -Press Shift + Return keys-)
  2. Mark text (it will appear highlighted on the screen)
  3. Apply the style from the drop-down menu.
  4. If in a future the information within the highlighted div (file or code) needs to be changed always use break line -Press Shift + Return key-.

 

Top of page

Troubleshooting while editing and using special div

In this section some problems of not following the guidelines above are showed. All examples follow the guideline but the failing at some point and showing the result. These two examples are avoided if Shift + Return key are used to break a line either in step 1 or 4 of the guidelines.

Example 1: What happens if one break lines pressing Return key.
 

This is an example
where lines were break using
Return key and later applying the special div
let say "code"

 

Example 2: A previously well formatted div where the user break a line pressing Return key.

This is an example
where this line was break afterwards
with a Return key
showing two boxes instead of one