X-Git-Url: https://git.p6c8.net/devedit.git/blobdiff_plain/1fbf10bec35aeb289a9cf3e1c65a826883bffdea..3b69a56ae05c5a9f8de83528657cefd784c95a8f:/README?ds=sidebyside diff --git a/README b/README index c20d6fa..db1de9c 100644 --- a/README +++ b/README @@ -1,5 +1,5 @@ -ReadMe for Dev-Editor 3.0 (CVS) -=============================== +ReadMe for Dev-Editor 3.2 +========================= Description ----------- @@ -9,6 +9,23 @@ terms of the Artistic License, which allows remote changes to files and directory structures on a web server. That's useful if you aren't able to access the files on your homepage directly, for example if you are on holiday. +Features +-------- + +- Browsing through directory structures +- Viewing text files +- Editing text files +- Removing files and directories +- Moving/renaming files and directories +- Copying files and directories +- Creating new files and directories +- Executing a HTTP download of a file +- Uploading files to the server via HTTP +- Changing permissions (chmod) and group (chgrp) of files and directories (on + Unix systems) +- Unpacking some types of archive files (Perl module Archive::Extract is + required) + Installation ------------ @@ -17,7 +34,7 @@ are able to execute scripts (in most cases, this is "cgi-bin"). I suggest to create a sub directory for Dev-Editor. Then, you have to change the first line of devedit.pl: Just replace /usr/bin/perl by the path to your Perl interpreter. -If you are on a UNIX based system, you have to set devedit.pl as executable +If you are on a Unix based system, you have to set devedit.pl as executable (chmod 755 in most cases). You will also need to configure Dev-Editor. See the next section for details. @@ -29,7 +46,7 @@ Configuration ------------- Open the file devedit.conf. This file contains keys and values separated by a -"=" sign. +"=" sign. Lines beginning with a "#" sign are ignored. Here is a list of the configuration options currently available: Option Description @@ -44,6 +61,9 @@ httproot This is the equivalent HTTP URL to the root directory. It's just used for visual output, so it doesn't need to be correct. +startdir Here you may define the default directory Dev-Editor + opens on start. + max_file_size Here you may define a maximum size for files (Bytes). If the user wants to view or edit a file larger than this defined size, Dev-Editor denies file access (but @@ -82,9 +102,29 @@ use_gmt Set this option to 1 if you want to use Greenwich Mean Time (GMT/UTC) in directory listing and in the About dialogue instead of the local time. -forbidden Specify . The filenames have to be separated by space characters. - If a filename contains space characters, you have to - put it into double quotation marks ("/filename"). +hide_dot_files Set this option to 1 if you want to hide files or + directories beginning with a dot (e.g. ".htaccess") in + directory listing. + The files are just hidden in the directory listing, + you can still access them typing the name into the + "Go to directory/file" box. + +forbidden Specify a list of filenames the user is not allowed to + access. The filenames have to be relative to the + virtual root directory (they must also begin with a + slash) and have to be separated by space characters. If + a filename contains space characters, you have to put + it into double quotation marks ("/file name"). + +disable_commands Specify a list of commands the user is not allowed to + execute. The commands have to be separated by space + characters. + If you add "@write" to the list, all writing commands + (for example edit, copy, rename etc.) get disabled. + +userconf_file Specifies the path to a file which contains + user-dependent configuration options (see next section + for details). error_file The path to the file which defines the error messages. The file has the same format as this one. @@ -93,6 +133,63 @@ template_file The path to the file which defines the paths to the template files. The file has the same format as this one. +User-dependent configuration +---------------------------- + +If you have placed Dev-Editor inside a directory protected using HTTP +authentication, you may override some default configuration values for a defined +list of users. You may override the values for the following configuration +options: + +- fileroot +- httproot +- startdir +- hide_dot_files +- forbidden +- disable_commands + +For overriding configuration values you need a special configuration file. The +path to this file is defined using the "userconf_file" configuration option in +the main configuration file (add the option if necessary). This file consists of +key-value-pairs and sections, marked by a string encapsulated in square brackets +(perhaps you know this format, it is nearly the same as the Windows INI files). +Each section in this file describes an individual configuration, whereby the +name of the section is the username for whom this configuration should be used. +Here is an example: + +[homer] +fileroot = /var/www/homer/htdocs +httproot = / + +This sets the physical file root directory to "/var/www/homer/htdocs" and the +virtual HTTP root to "/" - but only for the user whose HTTP authentication +username is "homer". + +Using the "aliases" option, you may also define some other usernames for whom +this configuration should be used: + +[homer] +fileroot = /var/www/homer/htdocs +httproot = / +aliases = marge bart + +Using this, the users whose usernames are "marge" and "bart" use the same +configuration as "homer". You can place an arbitrary number of usernames +seperated by whitespaces here. +Note: If one of the users mentioned as an alias and an individual configuration +section for this user exists too, the one mentioned as an alias is ignored. + +If there are some files marked as inaccessible using the "forbidden" +configuration option in the main configuration file, but some users should have +access to these files, you may clear the default value of "forbidden": + +[homer] +fileroot = /var/www/homer/htdocs +httproot = / +forbidden = + +Using this, "homer" has access to all files in "/var/www/homer/htdocs". + Notes ----- @@ -111,7 +208,7 @@ Hard links are not affected by this. ------------------------------------------------ (C) 1999-2000 Roland Bluethgen, Frank Schoenmann -(C) 2003-2005 Patrick Canterino +(C) 2003-2011 Patrick Canterino E-Mail: patrick@patshaping.de WWW: http://devedit.sourceforge.net/ \ No newline at end of file