X-Git-Url: https://git.r.bdr.sh/rbdr/blog/blobdiff_plain/d92ac8ccf6516011bc40bff2b17ef0d0d766f9de..3563ec23663e856fbaaa747bc174019ea4a3bcd4:/doc/README.md?ds=sidebyside 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 + +
Generates the blog index page
+Generates an RSS feed XML file
+Generates the static assets required for the blog
+Generates a TXT version of the blog
+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 |
+