You Only Write Thrice: Creating Documents, Computational Notebooks and
Presentations From a Single Source
- URL: http://arxiv.org/abs/2107.06639v1
- Date: Fri, 2 Jul 2021 21:02:09 GMT
- Title: You Only Write Thrice: Creating Documents, Computational Notebooks and
Presentations From a Single Source
- Authors: Kacper Sokol and Peter Flach
- Abstract summary: Academic trade requires juggling multiple variants of the same content published in different formats.
We propose to significantly reduce this burden by maintaining a single source document in a version-controlled environment.
We offer a proof-of-concept workflow that composes Jupyter Book (an online document), Jupyter Notebook (a computational narrative) and reveal.js slides from a single markdown source file.
- Score: 11.472707084860875
- License: http://creativecommons.org/licenses/by-nc-nd/4.0/
- Abstract: Academic trade requires juggling multiple variants of the same content
published in different formats: manuscripts, presentations, posters and
computational notebooks. The need to track versions to accommodate for the
write--review--rebut--revise life-cycle adds another layer of complexity. We
propose to significantly reduce this burden by maintaining a single source
document in a version-controlled environment (such as git), adding
functionality to generate a collection of output formats popular in academia.
To this end, we utilise various open-source tools from the Jupyter scientific
computing ecosystem and operationalise selected software engineering concepts.
We offer a proof-of-concept workflow that composes Jupyter Book (an online
document), Jupyter Notebook (a computational narrative) and reveal.js slides
from a single markdown source file. Hosted on GitHub, our approach supports
change tracking and versioning, as well as a transparent review process based
on the underlying code issue management infrastructure. An exhibit of our
workflow can be previewed at https://so-cool.github.io/you-only-write-thrice/.
Related papers
- Collaborative, Code-Proximal Dynamic Software Visualization within Code
Editors [55.57032418885258]
This paper introduces the design and proof-of-concept implementation for a software visualization approach that can be embedded into code editors.
Our contribution differs from related work in that we use dynamic analysis of a software system's runtime behavior.
Our visualization approach enhances common remote pair programming tools and is collaboratively usable by employing shared code cities.
arXiv Detail & Related papers (2023-08-30T06:35:40Z) - Coeditor: Leveraging Contextual Changes for Multi-round Code Auto-editing [57.776971051512234]
In this work, we explore a multi-round code auto-editing setting, aiming to predict edits to a code region based on recent changes within the same.
Our model, Coeditor, is a fine-tuned language model specifically designed for code editing tasks.
In a simplified single-round, single-edit task, Coeditor significantly outperforms GPT-3.5 and SOTA open-source code completion models.
arXiv Detail & Related papers (2023-05-29T19:57:36Z) - Cross-Modal Entity Matching for Visually Rich Documents [4.8119678510491815]
Visually rich documents utilize visual cues to augment their semantics.
Existing works that enable structured querying on these documents do not take this into account.
We propose Juno -- a cross-modal entity matching framework to address this limitation.
arXiv Detail & Related papers (2023-03-01T18:26:14Z) - XDoc: Unified Pre-training for Cross-Format Document Understanding [84.63416346227176]
XDoc is a unified pre-trained model which deals with different document formats in a single model.
XDoc achieves comparable or even better performance on a variety of downstream tasks compared with the individual pre-trained models.
arXiv Detail & Related papers (2022-10-06T12:07:18Z) - Repro: An Open-Source Library for Improving the Reproducibility and
Usability of Publicly Available Research Code [74.28810048824519]
Repro is an open-source library which aims at improving the usability of research code.
It provides a lightweight Python API for running software released by researchers within Docker containers.
arXiv Detail & Related papers (2022-04-29T01:54:54Z) - ReservoirComputing.jl: An Efficient and Modular Library for Reservoir
Computing Models [0.17499351967216337]
ReservoirComputing.jl is an open source Julia library for reservoir computing models.
The code and documentation are hosted on Github under an MIT license.
arXiv Detail & Related papers (2022-04-08T13:33:09Z) - Multi-View Document Representation Learning for Open-Domain Dense
Retrieval [87.11836738011007]
This paper proposes a multi-view document representation learning framework.
It aims to produce multi-view embeddings to represent documents and enforce them to align with different queries.
Experiments show our method outperforms recent works and achieves state-of-the-art results.
arXiv Detail & Related papers (2022-03-16T03:36:38Z) - skrl: Modular and Flexible Library for Reinforcement Learning [0.0]
skrl is an open-source modular library for reinforcement learning written in Python.
It allows loading, configuring, and operating NVIDIA Isaac Gym environments.
arXiv Detail & Related papers (2022-02-08T12:43:31Z) - Named Tensor Notation [117.30373263410507]
We propose a notation for tensors with named axes.
It relieves the author, reader, and future implementers from the burden of keeping track of the order of axes.
It also makes it easy to extend operations on low-order tensors to higher order ones.
arXiv Detail & Related papers (2021-02-25T22:21:30Z) - Reusable Learning Objects: An Agile Approach [0.0]
This paper argues that part of the reason is that the granularity of the learning objects that are in use today is not conducive to true reuse.
The paper proposes applying approaches originating in the software engineering community, such as agile methodology, version control and management.
The paper examines CourseGen, an open source software platform designed for creating, sharing, reusing and publishing reusable course content.
arXiv Detail & Related papers (2020-07-09T21:27:47Z) - ReproduceMeGit: A Visualization Tool for Analyzing Reproducibility of
Jupyter Notebooks [0.0]
We present ReproduceMeGit, a visualization tool for analyzing the GitHub of Jupyter Notebooks.
The tool provides information on the number of notebooks that were successfully reproducible, those that resulted in exceptions, those with different results from the original notebooks, etc.
arXiv Detail & Related papers (2020-06-22T10:05:52Z)
This list is automatically generated from the titles and abstracts of the papers in this site.
This site does not guarantee the quality of this site (including all information) and is not responsible for any consequences.