From 9865d846e7684ed6dc4c37b2008edd1aa9f08aff Mon Sep 17 00:00:00 2001 From: Niels Simenon Date: Tue, 17 Apr 2018 00:14:23 +0200 Subject: [PATCH] Added README. --- README.md | 40 ++++++++++++++++++++++++++++++++++++++++ fetchContent.js | 2 +- 2 files changed, 41 insertions(+), 1 deletion(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..55aa991 --- /dev/null +++ b/README.md @@ -0,0 +1,40 @@ +# reddit-post-dump + +## Installation +`npm install` + +## Usage +`node app.js --user={username}` + +## Configuration +The default configuration aims to be sensible, and the application may be used without any further tweaking. However, this application came to life because I was not satisfied by the organizatory facilities of similar applications, thus a multitude of options are at your disposal as described in this document. + +### Patterns +Path patterns dictate where and how a file will be saved. Various variables and options are available, and you may use subdirectories divided by `/`. + +### Variables +* `$postId`: The ID of the reddit post +* `$postTitle`: The title of the reddit post +* `$postUser`: The user that submitted the post, almost always equivalent to the `--user` command line argument +* `$postDate`: The submission date of the reddit post, formatted by the `dateformat` configuration described below + +* `$albumId`: The ID of the media host album +* `$albumTitle`: The title of the media host album +* `$albumDescription`: The description of the media host album +* `$albumDate`: The submission date of the media host album, formatted by the `dateformat` configuration described below + +* `$itemId`: The ID of the individual image or video +* `$itemTitle`: The title of the individual image or video +* `$itemDescription`: The description of the individual image or video +* `$itemDate`: The submission date of the individual image or video, formatted by the `dateformat` configuration described below +* `$itemIndex`: The index of the individual image or video in an album, offset by the `indexOffset` configuration described below +* `$ext`: The extension of the file. Must practically always be included. + +### Date format +Affects the representation of `$postDate`, `$albumDate` and `$itemDate` and defaults to `YYYYMMDD`. See [this documentation](https://date-fns.org/v1.29.0/docs/format) for an overview of all available tokens. + +### Index offset +Arrays start at 0, but as to not tire myself out debating the matter, you may offset it my any numerical value you like. Affects the `$itemIndex` variable for album items. + +### Slash substitute +The patterns are Unix file paths, and a `/` therefore indicates a new directory. You may freely use directories in your paths, but titles or descriptions may contain a `/` that is not supposed to create a new directory. All instances of `/` in a variable value will be replaced with the configured slash substitute. diff --git a/fetchContent.js b/fetchContent.js index c014a34..ce3c542 100644 --- a/fetchContent.js +++ b/fetchContent.js @@ -14,7 +14,7 @@ const extensions = { }; function interpolate(path, post, item, index) { - const dateFormat = config.patterns.date || 'YYYYMMDD'; + const dateFormat = config.patterns.dateformat || 'YYYYMMDD'; const vars = { $postId: post.id,