X-Git-Url: http://git.tremily.us/?a=blobdiff_plain;f=doc%2Fplugins%2Famazon_s3.mdwn;h=caa0c01530be6251683de0fe8b7bda6b790e0354;hb=a50fb83394b11aa9d794fed7b471b27b66a553d3;hp=f1887d97072258bf0f29917a94ae338426499112;hpb=9e6a4ccfddab3fc90ac8ce63522047fe85aeefcd;p=ikiwiki.git diff --git a/doc/plugins/amazon_s3.mdwn b/doc/plugins/amazon_s3.mdwn index f1887d970..caa0c0153 100644 --- a/doc/plugins/amazon_s3.mdwn +++ b/doc/plugins/amazon_s3.mdwn @@ -11,11 +11,6 @@ modules and an Amazon S3 account to use this plugin. ## configuration -Important note: You should seriously consider turning off `usedirs` before -enabling this plugin. If `usedirs` is enabled, every page has to be stored -in S3 *twice*, as "page/index.html" and as "page/". That will cost you -money and bandwidth. - This plugin uses the following settings in the setup file: * `amazon_s3_key_id` - Set to your public access key id. @@ -32,6 +27,13 @@ This plugin uses the following settings in the setup file: empty string. * `amazon_s3_location` - Optionally, this can be set to control which datacenter to use. For example, set it to "EU" to for Europe. +* `amazon_s3_dupindex` - Normally, when `usedirs` is enabled, + "foo/index.html" is stored in S3 as a key named "foo/", and all links + between pages use that name. If you also needs links that include + "index.html" in their names to work, you can enable this option. Then + each index.html file will be stored in S3 *twice*, under both names. This + will use more disk and bandwidth, and is not recommended unless you really + need it for some reason. Note that you should still set `destdir` in the setup file. The files that are uploaded to Amazon S3 will still be written to the destdir, too. @@ -57,3 +59,8 @@ type uploads. Copy and rename detection is not done, so if you copy or rename a large file, it will be re-uploaded, rather than copied. + +## deleting a bucket + +You can use "ikiwiki -setup my.setup --delete-bucket" to delete anything +that's in the configured bucket, and remove the bucket.