emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Daniele Pizzolli <dan@toel.it>
To: Org Mode <emacs-orgmode@gnu.org>
Subject: Re: Open Peer-Review Reproducible Publication with Org and GRASS
Date: Mon, 06 Jun 2016 22:12:19 +0200	[thread overview]
Message-ID: <87a8iyzzzzqdp8@me.localhost.invalid> (raw)
In-Reply-To: <ir4fusucob0.fsf@lycastus.phy.bnl.gov> (Brett Viren's message of "Fri, 03 Jun 2016 10:57:55 -0400")

On Fri, Jun 03 2016, Brett Viren wrote:

> Thanks for your example.
>
> A few ideas:
>
> - When you begin developing your paper, or sometime before submission,
>   make a break from your personal ~/.emacs.d/ environment and begin
>   processing the .org in an explicitly configured Emacs session.  Submit
>   the needed, minimal, paper-specific Emacs setup as part of the
>   supplementary material.
>
> - Bundle the document building into a shell script which calls Emacs so
>   that you can assure that personal ~/.emacs.d/ is excluded and only the
>   paper-specific Emacs setup is used.  It also helps users to rebuild
>   the paper, especially if they may not yet be Emacs aficionados.

Hello,

nice, but I suggest to start from scratch in a Virtual Machine.

I am currently trying to develop a generic extensible template for
this.

Right now I did only custom tailored installation.

When I have something interesting I will share it.  In the meantime I
will follow thread related to this topic closely!

> - Instead of multi-GB VM image, provide a few kB Dockerfile which can be
>   used to build a Linux container with base OS and all required
>   applications needed to run the Babel code blocks.
>
> - The Dockerfile could go so far as to create a user account, get the
>   supplementary material from a repository or the publisher's web page,
>   unpack and run the shell script which calls Emacs to build the
>   document.  If you go this far then in principle just this Dockerfile
>   is enough to reproduce the paper - but this will rely on some binaries
>   to remain available (Docker base OS images and OS packages).
>
> The reliance on long-term availability of the Docker base OS image and
> binary packages is problematic for long term automated reproducibility.
> However, even after those bits disappear from the 'net the Dockerfile
> serves as a concise and explicit recipe for future humans to follow.

I think that using debian only packages and the debian archive you
will be able to reproduce the environment with few effort in the
future, but I did not ever tried hard.

I will suggest to use are Vagrant rather than Docker (because it is
simpler to star, expressive enough, supports free software only
provider (like libvirt)) and some shell scripts or ansible playbooks.

I do not know the licence of the data, but I suggest to make at least
one private mirror and use a variable to switch between the two.

You may also want to verify sha256sum and/or gpg signatures on the
data and on the code (that should be hosted using a source code
management system).

Best,
Daniele

  reply	other threads:[~2016-06-06 20:12 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-06-03 14:19 Open Peer-Review Reproducible Publication with Org and GRASS Ken Mankoff
2016-06-03 14:57 ` Brett Viren
2016-06-06 20:12   ` Daniele Pizzolli [this message]
2016-06-06  9:08 ` Christian Moe
2016-06-06 20:11 ` Daniele Pizzolli
2016-06-06 23:01 ` Samuel Wales

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87a8iyzzzzqdp8@me.localhost.invalid \
    --to=dan@toel.it \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).