Authorea review & questions
I generally see Authorea as a medium for collaborative writing. I know that there's much more about publishing, but I'm still a bit far away to be concerned about it.
Personally, I prefer to use a local setup with my customized editor, Pandoc for generating output, Git with meaningful commit messages, etc. And I want to use Authorea as an interface to be used by other coauthors (my supervisors or colleagues) that don't want or don't need to use git/command line directly: for reviewing, commenting, minor fixes and additions that can be easily done through the web-editor "in-place".
So it's important for me to understand how I can write locally, but in a way that won't break the appearance of the article on the web-side exposed to other coauthors.
What I haven't found in the docs is the way Authorea manages the git repo and processes the special files:
layout.md: the master-document structure, plain list of references to other files (
title.md: contains the document title string
abstract.md: just the abstract text
authors.tex: appears when you try to modify the authors list through the web-interface. Can it be also
authors.md? Anything else? (see my Pandoc YAML header feature request)
header.tex: TeX preamble (related doc). Not clear how it is incorporated in the rest of the template used by Pandoc internally.
bibliography/biblio.bib: BibTeX bibliography. Does the name matter? Why the folder? Can I have several files there?
figures/: folder for pictures. I'm not sure about the structure and format.
Update: it appears that there are various solutions to what I described above (wrappers for Pandoc with YAML config to handle any Pandoc options and pre/post-processing):
And probably more.
Probably a generally better way to work with it is to have diagrams LaTeX/TikZ code separate and generate SVGs for each of them, then just insert the pictures in the main document. But then I have to setup some other CI service to generate those pictures.
!(...)for inserting local pictures doesn't work (see below)
\[...\]helps, sometimes not.
See an overview of LaTeX math-mode problems here.
Use Pandoc YAML metadata block extension for storing information about
This would replace
title.md with say
In addition to the YAML metadata extension it would be awesome to support panzer styles: a simple way to pass options to Pandoc and adjust any kind of document-specific styling.
Editing document sections/chapters separately within common web-interface. I see that one can access to the
Data of a document and paragraphs/sections are stored as separate Text