From ab739f77b87a055735b05f3ec318a9b0408df13d Mon Sep 17 00:00:00 2001 From: ROllerozxa Date: Sat, 29 Apr 2023 15:57:02 +0200 Subject: [PATCH] Add more details in README, license under AGPLv3 --- README.md | 10 +++++++++- dirlistozxa.php | 19 +++++++++++++++++++ 2 files changed, 28 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ffe94a3..58c72f4 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,16 @@ # `dirlistozxa` -A simple directory lister script in PHP that will show the files and directories in a directory, along with their modification date and size. +A simple directory lister script in PHP that will show the files and directories in a directory, along with their modification date and size. Image thumbnail previews are also supported. +## Setting up To set up, set the PHP file to be the index file, if no `index.html` or `index.php` exists in the directory. An example for nginx would be: ```nginx index index.html index.php /dirlistozxa.php; ``` + +You need to also move the `.dirlistozxa/` folder into the root of the site, such that it is accessible at `/.dirlistozxa/`. + +To optionally generate image thumbnails, use the `gen-thumbs` script. Requires Imagemagick to be installed, it will generate thumbnail files into `/.thumbs/`. If the script can't find any thumbnail for an image in `/.thumbs/`, it will just fall back to the generic file image. + +## License +`dirlistozxa` is licensed under the AGPLv3 license. diff --git a/dirlistozxa.php b/dirlistozxa.php index 6d3c4b5..f23c6ae 100644 --- a/dirlistozxa.php +++ b/dirlistozxa.php @@ -1,4 +1,23 @@ . + * + * This software is best enjoyed with soused herring! + */ + // Configuration: // List of filenames (and folder names) that should be ignored. -- 2.44.0