From csardi.gabor at gmail.com  Tue Sep  9 19:04:31 2014
From: csardi.gabor at gmail.com (=?UTF-8?B?R8OhYm9yIENzw6FyZGk=?=)
Date: Tue, 9 Sep 2014 13:04:31 -0400
Subject: [Rd] r wiki
In-Reply-To: <CANLFJPpg0tGZyas0SfYT5CPgCbfH7TWhdvi4TzD0=fDG9=mUSg@mail.gmail.com>
References: <6604241409959069@web8j.yandex.ru>
	<540B2825.40403@statistik.tu-dortmund.de>
	<618E9DC0-7ADA-4E6F-95CD-3551B55386B3@umons.ac.be>
	<CANROs4fk_Ve6tV0qRrqn+BeiCkpRBe8z6Q4vCXB-T79ArzNO-g@mail.gmail.com>
	<CABtg=Km5oaFJCGDKpC_5qVhCm+a_MhjnNhntnAGKQjgeBvx1Yw@mail.gmail.com>
	<846A1514-C508-46EF-978F-685C0DE3B730@sciviews.org>
	<21519.1306.551292.683057@stat.math.ethz.ch>
	<CANLFJPpg0tGZyas0SfYT5CPgCbfH7TWhdvi4TzD0=fDG9=mUSg@mail.gmail.com>
Message-ID: <CABtg=K=C8QVOQwrEF9aX00p2+vC0WyVhehm4Z8TAuqKretO-Qw@mail.gmail.com>

On Tue, Sep 9, 2014 at 10:29 AM, Baptiste Auguie
<baptiste.auguie at gmail.com> wrote:
> One small technical issue currently limiting the deployment of true
> reproducible wikis based on knitr + github-markdown is the lack of reverse
> synchronisation between the rendered output (markdown), edited online, and
> the original Rmd source.

The idea is that you would edit the (r)md file on github, e.g. like this:
https://github.com/gaborcsardi/r-wiki-engine/edit/wiki/welcome.md
You need to fork to do it, unless you are a collaborator.

If you use .md file extensions instead of .rmd, then you even get a
preview. (You can still treat the files as Rmd, of course when
building the web site.) Then, when you save your edit (and are a
collaborator), your edit will be a commit, and Travis will build the
new version of the web page.

If you are not a collaborator, then you need to submit a pull request,
and whenever this is
OK-d, the wiki and web pages will be updated.

It is not exactly a real wiki, but probably as close as you can get
with free services and without setting up a server.

Another possibility would be using the wikis Github provides, for
editing, but one would still need to build the web pages with Travis,
to run the R code, so I am not sure how much that would be better.

The good thing with this setup is, that you can switch to a dedicated
server later, as all the build tools are open-source. Then you would
get a real wiki, but the effort you need is much bigger.

Gabor



[Rd] r wiki
=?UTF-8?B?R8OhYm9yIENzw6FyZGk=?=