How to do cross-references in SciFlow

SciFlow is one of several options when it comes to collaborative writing. I like the intuitive interface, but sometimes it can be hard to see some useful features built in — like cross-references to other sections and figures/tables. This is super easy in SciFlow.

Let’s start with a new document. In this example, I have two sections on the left, with a table in Section 2. I have also pressed the “outline” button to see the document outline on the right.

In this example, I want to add a cross-reference to section 2 at the end of the “Main text” section. I simply select the section I want to refer to on the right

and drop it in the text where I want the cross-reference to appear.

Here we go, the placeholder for the cross-reference is included.

We can cross-reference figures and tables in the same way. Select the figure or table on the right (note the “Figures, Tables & Equations” below the list of sections),

and drag it

into the main text:

At the time of writing, the placeholder makes no distinction between figures and tables, but it’s just a placeholder…

A bit like when using LaTeX, in SciFlow you use “What You See is What You Mean”, so the output will probably look different from what you have on the screen. Indeed, this is a strength of SciFlow, both in that it allows you to export in many formats, and in that it prevents you from spending hours tinkering with the formatting. Unlike some other online editors, SciFlow is good at producing Word documents that are commonplace in the social sciences (many journals insist on a Word document during submission), or PDF, as you like. You choose the style and can readily change that style because SciFlow separates content from form.

Here’s that little section in one style:

and here in another style:

There you go, placeholders replaced with the relevant text depending on the template used.

SciFlow does Spelling and Grammar

Just a short shout that SciFlow has been checking spelling and grammar for a bit now. It’s an integration of LanguageTool, a bit like the suggestion I mentioned before. Integration is nice, but depending on the length of the document, it can take a while because the entire document is checked.

For a fuller description, see the post at SciFlow.

More Support and Templates in SciFlow

SciFlow is an online editor for academics. They have recently updated and expanded the documentation, so should you ever get stuck, here’s how to. That said, the interface is pretty intuitive, so I’m not sure you’ll ever need to navigate to the support pages for basic editing.

There are some useful hints, though, like using zbib (Zotero) with Sciflow (instructions here). This gets pretty close to Authorea’s citation feature, and is also useful for collaborative texts (and doesn’t suffer from the slowness of direct Zotero/Mendeley connections if you have a large database of references).

The SciFlow team have also recently updated the Templates feature:

There are many journal styles to choose from. It’s not quite (yet) like typeset.io, but the social sciences are not well covered by typeset anyway. SciFlow offers some useful templates, but in most cases, it’s necessary to do some finishing before submitting to a journal. On the other hand, there’s a template for minutes — that’s useful for anyone working in a team, and who isn’t?

In most cases the generic templates will do, including the SciFlow templates which support many common citation styles.

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.

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!