--- /dev/null
+<HTML>\r
+<HEAD>\r
+ <!-- Created by GNNpress/1.2 -->\r
+ <TITLE>The resource editor administration guide</TITLE>\r
+<!-- Changed by: Anselm Baird-Smith, 4-Feb-1997 -->\r
+</HEAD>\r
+<BODY BGCOLOR="white">\r
+ <A HREF="http://www.w3.org/pub/WWW/" TARGET="_top_"><IMG BORDER="0" SRC="/icons/WWW/w3c_home.gif"\r
+ ALT="w3c" WIDTH="72" HEIGHT="48"></A>\r
+ <A HREF="http://www.w3.org/pub/WWW/Jigsaw/" TARGET="_top_"><IMG SRC="/icons/jigsaw" WIDTH="212" HEIGHT="49"\r
+ BORDER="0"></A>\r
+<H1>\r
+ <B>Jigsaw </B>generic resource editors\r
+</H1>\r
+<P>\r
+<B>Jigsaw</B> uses the meta-resource description to generate automatically\r
+editors for specific resources.The generated editors actually uses HTML form,\r
+although this may change in the future. The fact that these editors are\r
+automatically generated makes them share the same user interface, which we\r
+describe in this document.\r
+<P>\r
+To give some insights about how the resource editors work, we will describe\r
+two representative instances of them: the <A HREF="#file-resource">FileResource\r
+editor</A>, and the <A HREF="#directory-resource">DirectoryResource</A> editor.\r
+<H2>\r
+ <A NAME="file-resource">The FileResource editor</A>\r
+</H2>\r
+<P>\r
+While reading this section, it might be a good idea to have another window\r
+displaying the\r
+<A HREF="../Reference/w3c.jigsaw.resources.FileResource.html">FileResource\r
+reference documentation</A>. You might also want to browse around its\r
+<A HREF="../api/w3c.jigsaw.resources.FileResource.html">api documentation</A>.\r
+<P>\r
+We will start by showing a screen dump of the file resource editor (this\r
+screen dump has been generated out of the document you get when you point\r
+your browser to <CODE>/User/Overview.html</CODE>).\r
+<P>\r
+<TABLE BORDER CELLPADDING="2">\r
+ <TR>\r
+ <TD><IMG BORDER="0" SRC="redit.gif" ALT="" WIDTH="410" HEIGHT="549"></TD>\r
+ </TR>\r
+</TABLE>\r
+<P>\r
+If you have read <A HREF="propeditor.html">the administration guide for the\r
+property editor</A>, this may sound familiar to you. Anyway, we'll re-describe\r
+the general layout of the form here. The form is made of three distinct zones:\r
+<UL>\r
+ <LI>\r
+ The first zone (the form <I>header</I>), is the title section. For all editors,\r
+ this section will always include at least, the name of the resource being\r
+ edited (here, <I>Overview.html</I>), and its resource class\r
+ (<CODE>w3c.jigsaw.resources.FileResource</CODE>).\r
+ <LI>\r
+ The second zone (the <I>form card zone</I>) contains the actual data to be\r
+ edited. Here, the editor displays the resource attributes (check the\r
+ <A HREF="../Reference/w3c.jigsaw.resources.FileResource.html">FileResource\r
+ reference guide</A>)\r
+ <LI>\r
+ The last zone contains a number of links: each link points to another <I>form\r
+ card zone</I> that will allow you to edit another set of characteristic of\r
+ the resource. For an unfiltered file resource, the only other available card\r
+ is the one that allows you to add a new filter.\r
+</UL>\r
+<P>\r
+Just being curious, you may want to follow the <I>AddFilter</I> link, which\r
+should popup a form similar to the one below:\r
+<P>\r
+<TABLE BORDER CELLPADDING="2">\r
+ <TR>\r
+ <TD><IMG BORDER="0" ALIGN="Middle" SRC="rfedit.gif" ALT="" WIDTH="411" HEIGHT="199"></TD>\r
+ </TR>\r
+</TABLE>\r
+<P>\r
+The <I>form card zone</I> has changed, it now displays an area were you can\r
+type in the class of the filter you want to add (see the\r
+<A HREF="../Reference/filters.html">reference manual on filters </A>for the\r
+xhaustive list of them). Note also that the last zone now displays only an\r
+<I>Attribute</I> link, that you may follow to go back to the previous form\r
+card. Let's continue here by adding a filter to the\r
+<CODE>/User/Overview.html</CODE> resource. We'll just add a\r
+<A HREF="../Reference/w3c.jigsaw.filters.CounterFilter.html">CounterFilter</A>\r
+(a filter that counts the number of hits to some resource). We tyoe in the\r
+filter's class name <CODE>w3c.jigsaw.filters.CounterFilter</CODE>, and press\r
+the <I>OK</I> button. Here is the new form that you get back:\r
+<P>\r
+<TABLE BORDER CELLPADDING="2">\r
+ <TR>\r
+ <TD><IMG BORDER="0" SRC="rfadd.gif" WIDTH="408" HEIGHT="193"></TD>\r
+ </TR>\r
+</TABLE>\r
+<P>\r
+Notice the two new links at the bottom of the form: they allow you to\r
+respectively edit the filter attributes, and the attribute values the filter\r
+shadows for its target (see the\r
+<A HREF="../Introduction/architecture.html"><B>Jigsaw</B> architectural\r
+overview</A> for more informations on shadowed attribute values).\r
+<P>\r
+By now, you should know enough to use the generic editor. You may want to\r
+remove the CounterFilter filter from the <CODE>/User/Overview.html</CODE>\r
+resource, by following the <I>w3c.jigsaw.filters.CounterFilter</I> link,\r
+and pressing the <I>Remove</I> button that will appear here.\r
+<H2>\r
+ <A NAME="directory-resource">The DirectoryResource editor</A>\r
+</H2>\r
+<P>\r
+You may now want to have two additional windows, one displaying the\r
+<A HREF="../Reference/w3c.jigsaw.resources.DirectoryResource.html">DirectoryResource\r
+reference guide</A>, and the other displaying the DirectoryResource api\r
+documentation.\r
+<P>\r
+The directory resource editor is very similar to the file resource editor,\r
+however, it provides two additional form cards to display (and modify) its\r
+existing children resources, and to add new children resources. To get acquainted\r
+with these two new kind of forms, we will pop up the directory resource editor\r
+on the <CODE>/User</CODE> resource (which is a DirectoryResource instance).\r
+By pointing your browser to <CODE>/Admin/Editor/User</CODE>, and following\r
+the <I>ExistingResources</I> link you should get the following (and now familiar)\r
+form:\r
+<P>\r
+<TABLE BORDER CELLPADDING="2">\r
+ <TR>\r
+ <TD><IMG BORDER="0" SRC="dedit.gif" ALT="" WIDTH="348" HEIGHT="408"></TD>\r
+ </TR>\r
+</TABLE>\r
+<P>\r
+We still have our three zones, the title zone indicates that we are editing\r
+a DirectoryResource whose name is <CODE>User</CODE>. The bottom zone shows\r
+the usual navigation links. The form card zone, however, now displays the\r
+list of children resources of the directory resource. You can follow any\r
+of the links to edit the corresponding resource. There is also a new\r
+<I>Command</I> field, to indicate what operations you want to perform on\r
+the marked children resources. To mark a resource, click on the checkbox\r
+at the right of its name. You can then execute one of the selected command\r
+by pressing the <I>OK</I> button. The <B>update</B> command will update any\r
+attribute that depends on the wrapped file content, the <B>remove</B> command\r
+will delete the resource (but <I>not</I> the underlying file), and the\r
+<B>reindex</B> command will re-run the\r
+<A HREF="../Introduction/indexer.html">resource factory </A>to make it create\r
+a new resource for the wrapped file (this is usefull if you have changed\r
+your resource factory configuration).\r
+<P>\r
+By following the <I>AddingResource</I> link, you will get the following form:\r
+<P>\r
+<TABLE BORDER CELLPADDING="2">\r
+ <TR>\r
+ <TD><IMG BORDER="0" SRC="dadd.gif" ALT="" WIDTH="358" HEIGHT="316"></TD>\r
+ </TR>\r
+</TABLE>\r
+<P>\r
+This form prompts you for a resource name, and a resource class (consult\r
+the reference manual for the <A HREF="../Reference/resources.html">list of\r
+available resources</A>). Fill both of them to create a new resource, and\r
+press the <I>OK</I> button: the new resource is created, and you will be\r
+relocated to a suitable editor of it.\r
+<P>\r
+ <HR>\r
+<P>\r
+<I><A HREF="mailto:jigsaw@w3.org">Jigsaw Team</A><BR>\r
+$Id: resedit.html,v 1.1 2010/06/15 12:20:58 smhuang Exp $</I>\r
+</BODY></HTML>\r
projects / Benchmarks_CSolver.git / blobdiff