blob: ebf8aacdf00e03d2ae428daf3d914f4fdb77d029 [file] [log] [blame] [view]
Tyler Scott08263852015-07-31 19:05:52 -06001NDN Catalog (NDN Query and Retrieval Tool)
2==========================================
3
4This is the front end to the catalog which contains all of the client html and code.
5
6Setup
7-----
8
Tyler Scott1ffb3b12016-08-21 03:46:07 +00009Simply run a webserver on THIS directory (aka
10.../ndn-atmos/client) and point clients to /catalog on either the domain or
11IP that the server is running on.
Tyler Scottb59e6de2015-09-18 14:46:30 -060012
Tyler Scott1ffb3b12016-08-21 03:46:07 +000013Good suggestions are http-server in npm, pythons SimpleHTTPServer, or a standard
14webserver like nginx or apache.
Tyler Scottb59e6de2015-09-18 14:46:30 -060015
Tyler Scott1ffb3b12016-08-21 03:46:07 +000016__Note:__
17HTTPS is not supported unless the ndn websocket server is running a valid
18certificate as well as the web server. This is due to a security rule in most
19browsers that restricts the ws protocol from running in https tabs/frames. All
20content in the https frame MUST be secure including the websocket.
21(HTTPS is untested at this time but you can ask questions on the mailing list
22if you have problems.)
Tyler Scott08263852015-07-31 19:05:52 -060023
Tyler Scott9eb6abd2015-08-04 14:48:23 -060024config.json
25-----------
26
Tyler Scottb59e6de2015-09-18 14:46:30 -060027###Global
Tyler Scott1ffb3b12016-08-21 03:46:07 +000028* CatalogPrefix - Where should the catalog attach in the URI scheme? (Usually the
29root of a catalog)
Tyler Scottb59e6de2015-09-18 14:46:30 -060030* FaceConfig - A valid NDN node location running the websocket for NDN-JS.
Tyler Scott9eb6abd2015-08-04 14:48:23 -060031
Tyler Scottb59e6de2015-09-18 14:46:30 -060032###Retrieval
Tyler Scott1ffb3b12016-08-21 03:46:07 +000033* DemoKey - The public and private portion of an RSA in Base64. This key must be
34valid in the NDN Network for it to work.
35* Destinations - A list of retrieval URIs. These must be running the retrieval
36code or retrieval will fail.
Tyler Scott9eb6abd2015-08-04 14:48:23 -060037
38Changing the theme
39------------------
40
Tyler Scott1ffb3b12016-08-21 03:46:07 +000041Currently the theme is a modified bootstrap theme that is running larger fonts
42and custom colors.
Tyler Scott9eb6abd2015-08-04 14:48:23 -060043
Tyler Scott1ffb3b12016-08-21 03:46:07 +000044If you would like to modify the theme go to [this url](http://bootstrap-live-customizer.com/).
45To modify the current theme, then upload the variables.less in this folder, make
46your modifications, and overwrite the variables.less file when you are done
47(and the theme.min.css).
Tyler Scott9eb6abd2015-08-04 14:48:23 -060048
49