doathon
doathon copied to clipboard
sparcopen
Reinventing the scholarly writing stack with the Manubot
Confused? New to Github? Visit the GitHub help page on our site for more information!
At a glance
- Submission Name: Continuous Publishing with the Manubot
-
Contact Lead: @dhimmel (
Daniel Himmelstein <[email protected]>) - External Site Link: https://github.com/greenelab/manubot-rootstock
- Region: Global
- Issue Area: OpenAccess, OpenResearch
- Issue Type: Project
- Types of Support Needed: Coding, GraphicDesign, Users
Description
The Manubot let's you write and continuously publish a manuscript on GitHub. Write in markdown and cite using just DOIs or other identifiers. Free yourself from antiquated or proprietary software such as Microsoft Word, LaTeX, EndNote, Mendeley, BibTeX, or MathType. While still young, the Manubot already powers the Deep Review (a massively collaborative review paper), the Sci-Hub Coverage Study, and has even reproduced the Bitcoin Whitepaper.
The Manubot aims to make scholarly publishing transparent, reproducible, and collaborative. It's an open source project and gratis to use. In a world of ever-increasing scholarly publishing costs, take a stand to show how publishing can be entirely free of charge, while also offering a superior user experience to existing journals. More details in these slides.
What are we working on during the do-a-thon? What kinds of support do we need?
At the do-a-thon, we will first help users setup new Manubot instance for their manuscripts. The setup process can be a bit technical, so this tutorial may be helpful for many users.
Next, attendees are encouraged to help improve the Manubot and contribute features they'd like to see. While the Manubot already supports tables, figures, equations, citation by identifiers, custom bibliographic styles, templating, timestamping, and more, there's still work needed to perfect the system and make it more user friendly as well as interoperable with the existing scholarly infrastructure.
Specifically expertise that's relevant for contributions is frontend or Python development, creating bots / automation, documentation writing, continuous integration, git / GitHub, Pandoc, publishing experience, and copyediting. If you have other skills, we can likely use them as well!
How can others contribute?
Try setting up your own manuscripts!
Specific issues for anyone looking for tasks are:
- [ ] diffing manuscripts: https://github.com/greenelab/manubot-rootstock/issues/54
- [ ] perfecting the bibliographic style: https://github.com/greenelab/manubot-rootstock/issues/53
- [ ] archiving manuscripts and comments on GitHub: https://github.com/greenelab/manubot-rootstock/issues/45
- [ ] measuring manuscript contribution: see https://github.com/greenelab/meta-review/pull/16
- [ ] automating the setup process and further automation in general
- [ ] improving the viewer or integrating with JATS-based viewers: https://github.com/greenelab/manubot-rootstock/pull/82
- [ ] retrieve ISBN citation metadata: https://github.com/greenelab/manubot/issues/14
- [ ] retrieve legal citation metadata: https://github.com/greenelab/manubot/issues/1
- [ ] improving citation parsing: https://github.com/greenelab/manubot/issues/13
- [ ] accept multiple paths/URLs with templating variables https://github.com/greenelab/manubot/issues/18
This post is part of the OpenCon 2017 Do-A-Thon. Not sure what's going on? Head here.
Excited for the do-a-thon tomorrow. Attendees are encouraged to bring a laptop, so you can get involved and setup your own manuscripts. However, even if you don't have a laptop, your feedback will be appreciated!
One more note: You don't need to know Python or any other programming language to attend. If you write manuscripts / scholarly documents, then you are the target audience! You will likely get the most out of Manubot if you're computer-savvy, but we're looking for diverse feedback, so don't be shy.
Location
11:30: We will initially meet in Goethe (the main auditorium) at a table in the rear. Look for the Manubot table tent.
Added issues:
- https://github.com/greenelab/manubot-rootstock/issues/85
- https://github.com/greenelab/manubot-rootstock/issues/86
- https://github.com/greenelab/manubot-rootstock/issues/87
- https://github.com/greenelab/manubot-rootstock/issues/88
- https://github.com/greenelab/manubot-rootstock/issues/90
For new mansucript setup, see https://github.com/greenelab/manubot-rootstock/blob/master/SETUP.md.
Windows users, try Git Bash to enter to commands.
Here is a link to the instances: https://github.com/schliebs/open_manuscript
Sorry I didn't get to this today! Genuinely want to know how this works / try it out, for obvious reasons. Is it possible to do this remotely another time please?
Thanks!!
Is it possible to do this remotely another time please?
Certainly! It's always possible, and we're trying to document the setup process, so most users won't need any in-person help. At the moment, things are a bit more complicated for Windows users... but macOS and Linux users should have an easier time. @npscience also happy to help you out or discuss the project more generally. Just drop me an email anytime.
2018 OpenCon Update
I won't be at OpenCon 2018 sadly, but attendees should feel free to contribute or experiment with Manubot as part of the Do-A-Thon.
For some more up-to-date information on the project, see
- the project manuscript titled Open collaborative writing with Manubot
- slides from FORCE2018
Some things Do-A-Thon attendees could do in 2018 (or future years):
- Set up a Manubot manuscript for their next paper (or migrate an existing paper to Manubot). We are especially interested in suggestions or pain points users experience.
- Look through open GitHub Issues and implement a solution or contribute a discussion. It may be a good idea to comment here if you're interested with your skillset and I can point you in the right direction.
Happy DO-ing!