added doc pages

app/resources/templates/md/pages/doc-features.md

@@ -0,0 +1,18 @@
+{:layout :page
+ :title "Doc: features"
+ :page-index 4001
+ :navbar? true
+ :generated-at 1526528884
+ :last-modified 1526522869
+ }
+
+# Features
+
+* Fully offline boilerplate
+* Source of multimedia enriched RSS feeds 
+* RSS aggregator for multiple multimedia enriched feeds
+* Scripts to import existing YouTube videos and playlists
+* Integrates with CDN for unlimited read scalability
+* Video guides help newbies become experts
+* One script to get started from a new RasPi... Go.sh
+

app/resources/templates/md/pages/doc-glossary.md

@@ -0,0 +1,12 @@
+{:layout :page
+ :title "Doc: glossary"
+ :page-index 4000
+ :navbar? true
+ :generated-at 1526528884
+ :last-modified 1526522823
+ }
+
+# Glossary
+
+* boilerplate -
+* 

app/resources/templates/md/pages/doc-operations.md

@@ -0,0 +1,113 @@
+{:layout :page
+ :title "Doc: operations"
+ :page-index 4002
+ :navbar? true
+ :generated-at 1526528885
+ :last-modified 1526513584
+ }
+
+# Vodcast Origin Operations
+
+
+These are literal instructions, in time difficult parts can be replaced with scripts.
+
+It's worth understanding each of these commands, tho, and examining the script 
+by using `cat scripts/thescript.sh` before running it... it should be understood before too long.
+
+## Add a page
+
+Assume you want to create a page A from the `ispooge.com-v2` directory.
+
+* `touch md-pages/A.md`
+* Edit the page with your editor... `nano` in CLI, `Bluefish` in X.
+
+From here we can fall back to Cryogen documentation.
+
+
+## Create a new playlist
+
+Playlists are created in two parts. The playlist-Random post and optionally by the video post having 
+the playlist-Random tag combined with a filter of same name in config.edn--creating a filtered playlist for rss readers.
+
+```text
+
++- md
+   +- posts
+      +- DATE-video-TITLE-ID.md
+      +- DATE-playlist-NAME.md
+   videos
+   +- TITLE-ID.mp4
+   playlists
+   +- NAME-ID.json
+
+```
+
+From here, these are just pages.
+
+
+## Create a new video
+
+Creating a new video is accomplished by copying it and a cover image to the `$ISPOOGE_MEDIA/videos`
+directory and running the following scripts from the `ispooge.com-v2` directory.
+
+Assuming you have files `MyVideo.mp4` and `MyVideo.jpg`:
+
+* `mkdir A.hls` - directories can end in dot extensions, no worries
+* `cd A.hls`
+* `../../../tinydatacenter/ispooge.com-v2/scripts/segment-video.sh ../A.mp4` - will take time relative to length of video
+* `ls -la` - you should see `out.m3u8` and `out0.ts` listed.
+* `cd ../../../tinydatacenter/ispooge.com-v2`
+* `scripts/make-video-page.sh A > md-pages/video-A.md`
+
+The video page has in the EDN header
+
+```clojure
+{:layout :video
+ :tags ["video" "playlist-Random"]
+}
+```
+
+
+That's it... see the `Add a page` section for more details.
+
+## Import a video from YouTube
+
+Importing a video from YouTube is accomplished by using a tool to download the video
+file and a thumbnail. Currently it's done at the Playlist level and downloads all videos.
+Starting in the `ispooge.com-v2` directory:
+
+* `cd $ISPOOGE_MEDIA/videos`
+* `scripts/../../../tinydatacenter/ispooge.com-v2/scripts/download-video.sh VideoId`
+* `ls -l` -- note the name of the file, `Title_of_Video-VideoId.mp4`
+* Follow the steps from to in `Create a video` for the rest.
+
+
+## Start a live stream
+
+Assuming you are familiar with LiveStreaming to YouTube or Twitch and use OBS, 
+this setup should be pretty familiar. As of now the archiving and posting does not
+happen manually, but can be accomplished by recorded within OBS and following the 
+process to create a new video.
+
+If you are doing a simple local stream, you configure OBS to push to the URL
+
+    rtmp://$RASPI_IP/ispoogedaily_local` with sream key `ispoogedaily`.
+
+## Relay a live stream to YouTube, Twitch, FB Live, Periscope, etc
+
+This is a one time setup for YouTube Live in the simplest case, or can be changed before
+a broadcast to change providers or use the Event system with a custom stream key for the event.
+From the `ispooge.com-v2` directory:
+
+* `cd ../rtmp-proxy-docker`
+* Edit `nginx.conf` to include your credentials in the `ispoogedaily_live` section, configuring desired upstream providers.
+* `./build.sh`
+* `./stop-proxy.sh ; ./start-proxy.sh` to restart the proxy with new config
+* Ensure that OBS is pushing to `ispoogedaily_live`.
+
+## Use RasPi OMX Hardware Transcoding
+
+You can safely run multiple transcoding streams via the OMX hardware. I use three
+and am experimenting with the best settings. Using a custom compiled ffmpeg
+you can get substantial speedups in video processing.
+

scripts/make-docs-pages.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+
+# we have run download-playlist.sh in $PLAYLIST_DIR
+# we have segmented each video in the playlist
+# there is a thumbnail for each downloaded video
+
+DOCS_DIR="${1:-doc}"
+
+
+DOC_FILES=$( find $DOCS_DIR -maxdepth 1 -type f -name '*.md' )
+
+i=4000
+for docFile in $DOC_FILES; do
+  export PAGE_INDEX="$i"
+  baseName="$(basename -s .md $docFile)"
+  pageFile="md-pages/doc-$baseName.md" # todo flatten
+  
+  title="Doc: ${baseName}"
+
+  scripts/md-to-page.sh "$docFile" "$title" > "$pageFile"
+  
+  i=$(expr $i + 1)
+done
+