W3C

W3C Web Editing Tools for Media Annotations WG.


Tools and Guidelines for editing specification in WG space

These tools allow editing any document in the Working Group space (http://www.w3.org/2008/WebVideo/Annotations/)

  1. Editors SHOULD use Jigedit to publish on w3C web site.
  2. Editors should use an HTML authoring tool that allows to publish on our web site using a PUT, else you should use our internal PUT tools, or WebDav or CVS.
  3. Editors MUST use Validation Tools

A- Use an HTML authoring tool that allows to publish on our web site using a PUT.

If your Web authoring tool does not support PUT, you should use our internal internal PUT tools,:

B- Use WebDav

WebDAV is an HTTP-based protocol that allows accessing the content of an HTTP server as a networked filesystems; to put it simply, it allows to edit directly a Web site as if it were an additional disk on your computer. JigEdit accounts are configured to allow users to use the WebDAV protocol.

C- Use CVS

CVS accounts are available for web account holders at member and public level access. They are described as follows:

Nota bene: In order to process requests for either of the above types of CVS account, the request MUST include a SSH public key (the id_{dsa,rsa}.pub file) in OpenSSH format from the end user.

Note: CVS is only recommended for expert users. If you would prefer to use a simpler interface to edit pages on the Web site, consider WebDAV. Refer to the guidebook Use of CVS in W3C

Send your request to Thierry Michel , (tmichel@w3.org) for a CVS account if you need one.

Validation Tools

Append one of these magic words to the end of any URI on www.w3.org for quick access to the tool (it does not work in DEV space (http://dev.w3.org).

Editors must conform to W3C Publication Guidelines

Note. It is not the role of the Team Contact or of the W3C Communications or Web Teams to ensure that documents are valid; it is the Editor's responsibility. The Editor should ensure validity before requesting publication. The W3C makes available validation services to assist Editors.

Please follow these steps to ensure that your documents are valid once in TR space:

Jigedit

Here are some hints about Jigedit, our publishing tool.

You MUST have a Jigedit account to publish on w3C web site. Send your request to Thierry Michel , (tmichel@w3.org) for a jigedit account if you need one.

Jigedit is our PUT server that allows users to easily upload documents on our web site, and to concurrently edit the same documents. It is based on jigsaw, the W3C HTTP server, and CVS, the Concurrent Versioning System.
There is documentation in the Jigedit Guide on how to use Jigedit. The documentation needs work, but it would get you started.

You can browse your area in jigedit: http ://jigedit.w3.org/your-jigedit-account/
It looks like a file system. The Root of the W3C Web site is at http ://jigedit.w3.org/your-jigedit-account/WWW/

You can select any html file, and then edit it using one of the PUT-capable HTML editors, and then save it: it will be uploaded on our web site, and immediately browsable using the regular www.w3.org URL. The recommended way to PUT is using our PUT tool. The other recommended tool is W3C's own browser/editor, Amaya

Access is limited to http ://jigedit.w3.org/your-jigedit-account/WWW/2008/WebVideo/Annotations/ only. You can't browse or PUT documents in other areas of our web site through jigedit.
What you see in http ://jigedit.w3.org/your-jigedit-account/WWW/2008/WebVideo/Annotations/ is a copy of the content of our web site in the SYMM Working Group area. When you upload a new document, it will automatically be propagated to the 'live' copy on the main web site.

For example if you need to publish a document to http://www.w3.org/2008/WebVideo/Annotations/foo.html
Use jigedit and upload it to: http ://jigedit.w3.org/your-jigedit-account/WWW/2008/WebVideo/Annotations/foo.html

In order to change your Jigedit Password use http ://jigedit.w3.org/your-jigedit-account/ChangePassword

Questions and requests about jigedit should go to webreq@w3.org . There is some information on how jigedit works in the Jigedit Guide.

Tools and Guidelines for editing specification in DEV space

These tools allow editing any document in the Working Group space (http://dev.w3.org/2008/video/mediaann/)

  1. Editors MUST use CVS and XML spec tool to publish on W3C DEV webspace.

A-Use CVS

CVS accounts are available for web account holders at member and public level access. They are described as follows:

Nota bene: In order to process requests for either of the above types of CVS account, the request MUST include a SSH public key (the id_{dsa,rsa}.pub file) in OpenSSH format from the end user.

You MUST have a CVS account to publish on W3C DEV webspace. Send your request to Thierry Michel , (tmichel@w3.org) for a CVS account if you need one.

Refer to the guidebook Use of CVS in W3C

B-Use of XMLSpec

You need CVS read and write access to the W3C Public CVS Repository. After getting the access, checkout the complete Media Annotations directory

Refer to the XMLSPEC info page

http://www.w3.org/2008/WebVideo/Annotations/editors.html#xmlspec


Thierry Michel , (tmichel@w3.org), W3C staff contact.

last revised $Date: 2009/12/08 21:45:18 $ by $Author: tmichel $