VRoot.org Editor's Guide

Introduction

The Editor's Guide is a reference for VRoot.org users who want to participate by submitting news, job proposals or by documenting/maintaining the Wiki Resources. Step-by-step scenarios are presented in order to facilitate the process of content creation or modification. A section of this guide also gives detailed explanation on how to insert image(s) in your content. Notice that VRoot.org content creation/modification is only offered to registered users in order to minimize spam.

Log In or Register

You need to log in in order to create/edit any content. When logged in, you should see your personal menu on the left side of every VRoot.org pages with your username as the title and the following options: "Create content", "Recent posts", "My account" and "Log out". For non-registered users, the login form is displayed on the left side of the VRoot.org main page. To become a member, click on the "Create new account" link. Just follow the instructions to create your account.

News Submission

A complete step-by-step guide for news submission is given below:
  1. Go to the "Submit Story" page either by clicking on the "Submit News" link in the horizontal top menu or by clicking on the "Create content -­> Story" links in your personal menu.
  2. Enter the title of the news.
  3. Choose one or more topics to categorise the content of your post. The category picture of the first alphabetically ordered topic will be automatically inserted in your post. Feel free to suggest a new category on the Management Forum if you think it should be available.
  4. Enter the content of your news in the "Body" text field by either using the Filtered HTML (limited set of Html tags), MediaWiki or DokuWiki syntax. You will also need to select the chosen format in the "Input format" form showed at the end of the page. Please notice it is possible that not all formatting options are supported at the moment for the MediaWiki and DokuWiki syntaxes. In order to alleviate this problem, you may now use Html inside your MediaWiki or DokuWiki post to format a section in a specific way.
  5. (Optional) Insert one or many images in your post by clicking on the "Add images" picture button (just below the body text field). Notice that an added image will normally be inserted at the last position you let your cursor in the body text field. Please consult the "Adding Images" section below for more information on this topic.
  6. In the "Input format" section, select the syntax you have previously used to format your content.
  7. Click on the "Preview" button in order to see how your content looks like. Click on the "Submit" button to submit your content. Your news post should be published soon on the front page after a quick admin approval.

Wiki Resources Editing

To create a new child page, you need to:
  1. Click on the "Add child page" link at the bottom-right of a wiki page or on your personal menu "Create content -­> Book page" links.
  2. Enter a title for your page.
  3. Select the desired Parent Page under the Wiki Resources element (ex.: Research, Development, etc.). The previous parent page is already selected when using the "Add child page" link.
  4. Enter your page content in the "Body" text field by either using the MediaWiki or the DokuWiki syntax. You will also need to select the chosen format in the "Input format" form showed at the end of the page. Please notice it is possible that not all MediaWiki and DokuWiki formatting options are supported at the moment. In order to alleviate this problem, you may now use Html inside your WikiMedia or DokuWiki page to format a section in specific way.
  5. (Optional) Insert one or many images in your page by clicking on the "Add images" picture button (just below the body text field). Notice that an added image will normally be inserted at the last position you let your cursor in the body text field. Please consult the "Adding Images" section below for more information on this topic.
  6. In the "Input format" section, select the syntax you have previously used to format your content.
  7. (Optional) Enter a short description of the new page in the "Log message" field.
  8. Click on the "Preview" button in order to see how your content looks like. Click on the "Submit" button to submit your content. Your page should now be published and linked at the end of the Parent Page.

Feel free to manually link your page inside other related Wiki Resources pages.

To modify an existing Wiki Resources page, you need to:

  1. Be on the Wiki Resources page you want to modify.
  2. Click on the top-right "Edit" tab link.
  3. Check first the Wiki syntax used by the original author in the "Input format" section.
  4. Edit the "Body" content by using the same wiki syntax.
  5. (Optional) Enter a short description of the changes you made in the "Log message" field.
  6. Click on the "Preview" button in order to see how your content looks like. Click on the "Submit" button to submit your content. The changes should now be published.

Job Proposal Submission

To add new jobs proposals, you need to click on the top-right "Edit" tab link of the "Virtual Reality Jobs" page. You may now add new proposals in the "Body" field by using the MediaWiki syntax.

Adding Image(s) In Your Content

Images can be added inside news posts, comments, job proposals and Wiki Resources pages. While it's possible to display external images (by using the same syntax as in your post), we recommend that you upload them since it gives you more control on their final appearance. An uploaded image is also independant of the content syntax: the same filter tag is used for Html, WikiMedia or DokuMedia content. All the images you're uploading are keeped in your personal library so that you can reuse them in the future. Here's how to insert images and configure their properties while editing some content:
  1. In the "Body" section, place the cursor where you want to insert an image.
  2. Click on the "Add images" picture button:
  3. An "Add image" window whould now pop-up. You may now (a) upload a new image by clicking on the "Upload" button or (b) choose an image you have already uploaded by clicking on it (if so, go directly to step 5).
  4. The upload image form: Just enter an appropriate title and click on the "Choose..." button to select the image to upload (from your own computer). You may now click on the "Preview" button to see how it looks like or/and click on "Submit" when ready. Notice: uploaded images must be under 800 Kb in size and 640x640 resolution.
  5. The image properties form: When filled, the "Title" and "Description" data are shown below the image. The "thumbnail" size option will display your image with a max resolution of 250x130. It's generally the best option for left aligned context pictures of news post. The "preview" option will use the original size of your image if it is under 640x640 or will generate a preview version under 640x640 if not. You may now choose between the "left", "right", "none" or "center" alignment options. Click on the "Insert" button when ready.
  6. Back to your "Body" field content, you should now see that a filter tag ([img_assist|...) has been inserted where you previously placed your cursor. You may copy/paste it somewhere else if you're not happy with the current position. The filter tag should have the following format: img_assist|nid=img_node_no|title=?|desc=?|link=?|align=?|width=?|height=?. You may directly edit the "?" fields in order to modify the image properties.
  7. Repeat the same steps to add more images.