diff --git a/USAGE.md b/USAGE.md index 57504819..80faf150 100644 --- a/USAGE.md +++ b/USAGE.md @@ -111,7 +111,11 @@ The `--generator-arg` or `-g` argument can be used on the command line to pass t ## `Uploader` -The script `uploader` is a way to upload a set of already-generated wiki dumps to the Internet Archive with a single invocation. +The script `uploader` is a way to upload a set of already-generated wiki dumps to the Internet Archive with a single invocation. The script takes the filename of a list of wikis as argument and uploads their dumps to archive.org. You only need to: + +* Check the 7z compressed dumps are in the same directory as `listfile`. The file `listfile` contains a list of the api.php URLs of the wikis to upload, one per line. +* [Retrieve your S3 keys](http://www.archive.org/account/s3.php), save them one per line (in the order provided) in a keys.txt file in same directory as `uploader`. +* Run the script `uploader listfile`. Usage: @@ -119,10 +123,6 @@ Usage: uploader [-pd] [-pw] [-a] [-c COLLECTION] [-wd WIKIDUMP_DIR] [-u] [-kf KEYSFILE] [-lf LOGFILE] listfile ``` -For the positional parameter `listfile`, `uploader` expects a path to a file that contains a list of URLs to `api.php`s of wikis, one on each line (exactly the same as `launcher`). - -`uploader` will search a configurable directory for files with the names generated by `launcher` and upload any that it finds to an Internet Archive item. The item will be created if it does not already exist. - Named arguments (short and long versions): * `-pd`, `--prune_directories`: After uploading, remove the raw directory generated by `launcher`