Skip to content

Setting up a page to display your rivers

Andy Sylvester edited this page Nov 24, 2018 · 2 revisions

Once you have River5 set up on a public server and creating river files (Javascript files that can be read/displayed by other applications (for example, 1999bloggers.js)), you have some options for being able to display those files. When River5 is running, you can direct people to the public display of the rivers being created. An example can be seen at http://fedwiki.andysylvester.com:1337/, which is my main River5 installation. This install is creating multiple rivers, which are displayed in multiple tabs. If you only had one river, you would see only one tab.

Another option for making your river public without pointing to the River5 app display is to use a separate HTML page that accesses the river files. Dave Winer has created a toolkit for display of River5 river files (https://github.com/scripting/riverBrowser). To test the app, copy two files from the repo (frozenriver.js and riverbrowserdemo.html) to a directory on a web server. You should then see the contents of the frozen river file as shown in Dave Winer’s demo app (http://fargo.io/code/browsers/riverbrowserdemo.html).

Next, you will be replacing the text “frozenriver.js” with a URL to a list in your River5 installation. For example, I have a file called readinglist.txt, which contains a list of over 40 RSS feeds that I follow. When your River5 installation is running, you can feed a URL corresponding to a River5 list of feeds that you have created. The following is the line of Javascript from above with the URL for readinglist.txt from my server:

httpGetRiver (“http://fedwiki.andysylvester.com:1337/getoneriver?fname=readinglist.txt”, “idRiverDisplay”, function (){

For your setup, replace the URL part (http://fedwiki.andysylvester.com:1337) with the URL for your River5 server, and replace the text following “fname=” (readinglist.txt) with the name of your file in the lists folder within your River5 installation. Finally, upload the HTML file to a server. As long as the River5 server is running, your HTML page will display the latest version of the river. An example is available at http://andysylvester.com/files/riverbrowserdemo.html.

OK – now get started making rivers!

Reference: http://andysylvester.com/2018/11/23/creating-and-displaying-rivers-of-news/ (Creating and Displaying Rivers of News)

Clone this wiki locally