Creating Directory and adding files. Easy?

Alexandre Rafalovitch writes:
 > Hi,
 > I am playing with Jigsaw for 2 days and got quite deep into theory, but the
 > simple things evade me.
 > I would be grateful if anybody could walk me through a simple operation.
 > I want to create a directory and copy 20 html files into yet. What I do not
 > understand is do I have to add a directory through forms or I can add it
 > manually and then index it or some such. Also, if I want to put 20 files in
 > that directory, how do I do that.

Well,, first of all, you are right, it's not in the doc. I'll go into
deep details here, trying to explain as much as the "theory" while
keeping things simple.

The simple way first: if you use the default Jigsaw setting, creating
the directory in the appropriate place and copying your twenty files
should be enough to make them visible through Jigsaw (if this is not
the case, then there is a bug).

The complex way: if you read the DirectoryResource reference manual -
/User/Reference/w3c.jigsaw.resources.DirectoryResource.html - you will
see that it has an 'extensible' parameter. When this parameter is set
to true, the DirectoryResource will "extend" itself automatically by
creating the appropriate resource objects to export the (new) files it
contains. For the sake of simplicity, Jigsaw default configuration
comes with a single DirectoryResource template -
/Admin/DirectoryTemplates/WWW - which has this flag set to true (so
all the directories Jigsaw will create will inherit the
'extensible-true' setting).

For some reasons, I would rather have the 'extensible' flag set to
false (security), but this means that webmasters have to manually
register their new files/directories, using the /Admin/Editor and the
AddResource link out there (if they want to add resources to the root
directory). You can't expect that from them, as they have been used to
other servers...

I am not sure these explanations answer the questions. Anyway, in your
case, it looks like your directory hasn't got the 'extensible=true'
setting. If this is so, to add to it a new resource (file or
directory, or a resource of your own), you have to popup it's resource
editor. If your directory is /foo/bar, you do this by pointing your
browser to /Admin/Editor/foo/bar. You can then follow the addResource
link (at the bottom), which will query you for both the name of the
resource to be added, and its class. In your case, you want to use the
"w3c.jigsaw.resources.DirectoryResource" class (since you are adding a
directory. Press the OK button, you're all set.

 > So if anybody can give me a walk through creating a directory (call it
 > Alex) on top, or better not on top level and adding 20(or 2) existing files
 > to it, I would be grateful.

Let me know if all the blurb above doesn't answer your question, or if
you have problems running it.

 > Thank you,
 >      Alex.
 > 
 > Ps. I would expect  that to be in FAQ. I would make sure that I know how to
 > put html files into directory, before I write custom content handlers for
 > web server.

Yep,

 > PPs. I do not think it is anywhere in the docs, at least not as a walk
 > through, but if it is I would gladly accept pointers.

Correct, the place for it would probably be some document under
/User/Administration, BTW have you checked:
http://www.w3.org/pub/WWW/Jigsaw/User/Administration/resedit.html
It looks like it contains some of this stuff. If you haven't seen it,
I'll try to link to it from more visible places.

Anselm.

Received on Friday, 7 June 1996 09:26:30 UTC