SciFlow for Collaborative Writing

There are a few solutions out there for collaborative writing, and currently I like SciFlow best. The thing about collaborative writing platforms is that while there are many options out there, we’ll have to consider the least technical of the co-authors. Yes, we could use LaTeX (or perhaps better: Markdown because most journals want Word documents during submission) on GitHub, but in the social sciences this is often no realistic because many shy away from anything that doesn’t quite look like a word processor.

I guess a widely approach consists of a Word document that is either e-mailed around, or these days shared on Dropbox. It’s not too bad as long as one of the authors knows how to combine different versions of the same document, tracked changes are accepted from time to time, and someone is willing to clean up the messed-up formatting in the end.

In terms of collaboration, an online platform can be better: there is only one version — the latest one –, and all authors can write on the document at once. SciFlow offers a basic service for just this, and the “basic” part makes it just so suitable: the least technical of the co-authors is likely to handle it well. It offers all the necessary bits without distracting from the most important bit: writing.

It handles basic formatting, footnotes, references, figures, and equations. We are forced to use styles rather than direct formatting — something we should be doing in Word, too, but the least technical of the co-authors typically doesn’t do. Citations are built in (though not quite as nicely as in Authorea, where we can import references from the web, too!), and there are many templates to format the document and export it to PDF or Word documents as needed.

Yoshikoder won’t start on Ubuntu

Two days ago my Yoshikoder refused to start on the Ubuntu (GNU/Linux) machine. So I tried in the console java -jar Yoshikoder-0.6.4.jar and was informed that “Error: Assistive Technology not found: org.GNOME.Accessibility.AtkWrapper”. A quick on the web look turned out that the solution is simple. In the console, I opened the following file:

sudo leafpad /etc/java-11-openjdk/accessibility.properties

and commented out the line causing problems (in my case it was the last line), so that it reads:

#assistive_technologies=org.GNOME.Accessibility.AtkWrapper

Sorted.

Grammar Check in SciFlow

I have mentioned SciFlow, an exciting platform for collaborative academic writing. Wouldn’t it be nice to have a grammar checker? Head over to LanguageTool and install the bowser add-on of choice. Once you’ve done that, you can check any text in SciFlow (or anywhere on the web where you type):

Here we have a red wiggly line from the browser, indicating a typo. How about potential grammar problems? Click on that small blue circle at the end, and let LanguageTool do its magic.

(Here I used part of the demo text from LanguageTool, so obviously they have smuggled in many issues.) One thing I found less convenient is that when I simply click on the blue circle, the entire document is checked. This tends to bring up many potential issues, especially since author names are typically not in the dictionary. As a result, I find it difficult to be sure which section of the document an error refers to. The workaround is to select a paragraph (or section) a time, and then click that blue circle. Now we only have the selected text checked.

If you are uncomfortable having your text sent over the web (see their privacy rules here), you can install LanguageTool locally, and have the browser add-on use that one instead.

How to Add References in Footnotes in SciFlow

SciFlow is an exciting platform for collaborative academic writing. Perhaps similar to Authorea, SciFlow comes with no restrictions. One limitation I faced was that it seemed impossible to add reference in footnotes. If you enter a footnote, and add a reference there, the reference is added after the footnote. That’s not what we want. Let’s walk through the workaround:

You can add references in footnotes, though, if you copy the text (with the reference) into a footnote. To do so, write the text of the footnote on a new line, select the entire paragraph, and click on the “footnote” symbol (or cut and paste).

It turns out, there is a bug in the way references in footnotes are displayed (which the developers expect to iron out very soon), which made me believe that you cannot add references in footnotes. You get a “NO RENDERER SUPPLIED” error instead of the reference field.

Here’s your reference:

2018-09-01-121125_752x166_scrot

And this is what it looks like when you export the document:

updated on 1 September to reflect bug fix!

Join the serious conversation on immigration — CAS Migration and Diversity

Immigration is no doubt a topic high on the political agenda and omni-present in everyday debates. Jointly with the Master of Advanced Studies in Intercultural Communication, Università della Svizzera italiana, the Swiss Forum for Migration and Population Studies (SFM) of the University of Neuchâtel offers a Certificate in Advanced Studies on Migration and Diversity. There is still time to apply and joint the serious conversation on immigration.

CAS – Migration and Diversity – Leaflet