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.