X-Git-Url: https://git.r.bdr.sh/rbdr/blog/blobdiff_plain/d92ac8ccf6516011bc40bff2b17ef0d0d766f9de..3563ec23663e856fbaaa747bc174019ea4a3bcd4:/doc/README.md diff --git a/doc/README.md b/doc/README.md index 4e9e131..988e0e7 100644 --- a/doc/README.md +++ b/doc/README.md @@ -1,3 +1,27 @@ +## Classes + +
+
Blog
+
+
+ +## Members + +
+
HTMLGenerator
+

Generates the blog index page

+
+
RSSGenerator
+

Generates an RSS feed XML file

+
+
StaticGenerator
+

Generates the static assets required for the blog

+
+
TXTGenerator
+

Generates a TXT version of the blog

+
+
+ ## Blog @@ -8,6 +32,11 @@ * [.add(postLocation)](#Blog+add) ⇒ Promise.<undefined> * [.update(postLocation)](#Blog+update) ⇒ Promise.<undefined> * [.publish()](#Blog+publish) ⇒ Promise.<undefined> + * [.publishArchive()](#Blog+publishArchive) ⇒ Promise.<undefined> + * [.addRemote()](#Blog+addRemote) ⇒ Promise.<undefined> + * [.removeRemote()](#Blog+removeRemote) ⇒ Promise.<undefined> + * [.syncDown()](#Blog+syncDown) ⇒ Promise.<undefined> + * [.syncUp()](#Blog+syncUp) ⇒ Promise.<undefined> @@ -18,12 +47,12 @@ updating posts, and handling the publishing. | Param | Type | Description | | --- | --- | --- | -| config | Potluck.tConfiguration | the initialization options to extend the instance | +| config | Blog.tConfiguration | the initialization options to extend the instance | ### blog.add(postLocation) ⇒ Promise.<undefined> -Shifts the blog posts, adds the passed path to slot 0, and +Shifts the blog posts, adds the passed file to slot 0, and generates files. **Kind**: instance method of [Blog](#Blog) @@ -31,19 +60,19 @@ generates files. | Param | Type | Description | | --- | --- | --- | -| postLocation | string | the path to the directory containing the post structure | +| postLocation | string | the path to the blog post file | ### blog.update(postLocation) ⇒ Promise.<undefined> -Adds the passed path to slot 0, and generates files. +Update slot 0 with the passed gmi file, and generates files. **Kind**: instance method of [Blog](#Blog) **Returns**: Promise.<undefined> - empty promise, returns no value | Param | Type | Description | | --- | --- | --- | -| postLocation | string | the path to the directory containing the post structure | +| postLocation | string | the path to the blog post file | @@ -52,3 +81,91 @@ Publishes the files to a static host. **Kind**: instance method of [Blog](#Blog) **Returns**: Promise.<undefined> - empty promise, returns no value + + +### blog.publishArchive() ⇒ Promise.<undefined> +Publishes the archive to a host using rsync. Currently assumes +gemlog archive. + +**Kind**: instance method of [Blog](#Blog) +**Returns**: Promise.<undefined> - empty promise, returns no value + + +### blog.addRemote() ⇒ Promise.<undefined> +Adds a remote + +**Kind**: instance method of [Blog](#Blog) +**Returns**: Promise.<undefined> - empty promise, returns no value + + +### blog.removeRemote() ⇒ Promise.<undefined> +Removes a remote + +**Kind**: instance method of [Blog](#Blog) +**Returns**: Promise.<undefined> - empty promise, returns no value + + +### blog.syncDown() ⇒ Promise.<undefined> +Pulls the posts and archive from the remote + +**Kind**: instance method of [Blog](#Blog) +**Returns**: Promise.<undefined> - empty promise, returns no value + + +### blog.syncUp() ⇒ Promise.<undefined> +Pushes the posts and archive to the remote + +**Kind**: instance method of [Blog](#Blog) +**Returns**: Promise.<undefined> - empty promise, returns no value + + +## HTMLGenerator +Generates the blog index page + +**Kind**: global variable + +| Param | Type | Description | +| --- | --- | --- | +| source | string | the source directory | +| target | string | the target directory | +| posts | Array.<Blog.tPost> | the list of posts | + + + +## RSSGenerator +Generates an RSS feed XML file + +**Kind**: global variable + +| Param | Type | Description | +| --- | --- | --- | +| source | string | the source directory | +| target | string | the target directory | +| posts | Array.<Blog.tPost> | the list of posts | + + + +## StaticGenerator +Generates the static assets required for the blog + +**Kind**: global variable + +| Param | Type | Description | +| --- | --- | --- | +| source | string | the source directory | +| target | string | the target directory | +| posts | Array.<Blog.tPost> | the list of posts | + + + +## TXTGenerator +Generates a TXT version of the blog + +**Kind**: global variable + +| Param | Type | Description | +| --- | --- | --- | +| source | string | the source directory | +| target | string | the target directory | +| posts | Array.<Blog.tPost> | the list of posts | +