@@ -51,78 +51,6 @@ Contributed by E. David Aja ([edavidaja][]).
5151[ lambda ] :https://docs.aws.amazon.com/lambda/latest/dg/lambda-edge.html
5252[ s3 ] :https://aws.amazon.com/s3/
5353
54- ##Beaker Browser (secure sharing)
55-
56- If your project contains sensitive data that prevents you from publicly sharing
57- the results, one alternative option is to self-host your workflowr website using
58- [ Beaker Browser] [ beaker ] .
59-
60- [ Beaker Browser] [ beaker ] allows website creation, cloning, modification, and
61- publishing locally. After the site is ready, hitting "share" produces a unique
62- [ Dat project dat://] [ dat ] hyperlink, for example:
63-
64- dat://adef21aa8bbac5e93b0c20a97c6f57f93150cf4e7f5eb1eb522eb88e682309bc
65-
66- This dat:// link can then be shared and the site opened* all the while being
67- hosted locally on the site producer's machine.* The particular example above is
68- a site, produced in RStudio using workflowr, with placeholder content and R code
69- chunks, compiled as usual.
70-
71- Security for your site is achieved with site encryption inherent in the Dat
72- protocol (see[ Security] [ dat-security ] on the[ datproject docs page] [ dat-docs ] ),
73- as well as the obscurity of the unique link. Beaker Browser saves your
74- individual project sites in the folder` ~/Sites ` .
75-
76- To create a Beaker Browser version of your workflowr site:
77-
78- 1 . [ Install] [ beaker-install ] Beaker Browser and run it.
79- 1 . Select "New Site" in the three-bar dropdown menu found to the right of the
80- "omnibar" for web link entry, and enter its Title and (optional) a Description
81- of the site. This creates a folder in the Beaker Browser` ~/Sites ` directory
82- named for your Title, for example, "placeholder_workflowr", and populates the
83- folder with a` dat.json ` file.
84- 1 . In the main Beaker Browser pane, use "Add Files" or "Open Folder" to copy the
85- entire contents of the workflowr` docs/ ` folder to your new Beaker Browser site
86- folder (see Symlink Synchronization, below).
87- 1 . Once copied, the new site is ready to go. Pressing "Share" in the main Beaker
88- Browser pane reveals the unique dat:// link generated for your Beaker Browser
89- site. Sharing this link with anyone running Beaker Browser will allow them to
90- access your workflowr HTML files...* directly from your computer* .
91-
92- Instead of having to manually copy your workflowr` docs/ ` directory to your
93- Beaker Browser site directory, you can create a symlink from your workflowr
94- ` docs/ ` directory to the Beaker Browser site directory. The line below links the
95- ` docs/ ` directory of a hypothetical "workflowr-project" saved in` ~/github/ ` to
96- the hypothetical Beaker` placeholder_workflowr ` subdirectory:
97-
98- ln -s ~/github/workflowr-project/docs ~/Users/joshua/Sites/placeholder_workflowr
99-
100- The direct-sharing nature of the above workflow means that the host computer
101- needs to be running for site access. Two alternative recommended by Beaker
102- Browser developer[ Paul Frazee] [ pfrazee ] are[ hashbase.io] [ ] and the Beaker
103- Browser subproject[ dathttpd] [ ] . While hosting Beaker Browser sites is outside
104- of the scope of this direct sharing paradigm, each of these options has
105- strengths. The former, hashbase.io (free account required), is a web-hosted
106- central location for dat:// -linked content, removing the need for the host
107- computer to be running. The latter dathttpd example is an additional
108- server/self-hosting option that can be used if desired.
109-
110- This solution was contributed by[ Josh Johnson] [ johnsonlab ] . For more details,
111- please read his[ blog post] [ johnsonlab-blog ] and the discussion in Issue
112- [ #59 ] [ ] .
113-
114- [ #59 ] :https://github.com/workflowr/workflowr/issues/59
115- [ beaker ] :https://beakerbrowser.com/
116- [ beaker-install ] :https://beakerbrowser.com/install/
117- [ dat ] :https://dat.foundation
118- [ dat-docs ] :https://docs.datproject.org/
119- [ dat-security ] :https://docs.datproject.org/docs/security-faq
120- [ dathttpd ] :https://github.com/beakerbrowser/dathttpd
121- [ hashbase.io ] :https://hashbase.io
122- [ johnsonlab ] :https://github.com/johnsonlab
123- [ johnsonlab-blog ] :https://johnsonlab.github.io/blog-post-22/
124- [ pfrazee ] :https://github.com/pfrazee
125-
12654##GitLab Pages
12755
12856To deploy your workflowr website with[ GitLab Pages] [ gitlab ] , you can use the