Scrivener + Quarto: a technical/academic publishing workflow

Cool! Do you know a way to get homebrew to pull the preview version? I imagine it won’t be long now before the full release as I can see the 1.3 milestone is marked 100% in Github Issues anyway.

At least the first 3 were from my original quarto project, not sure if Bernardo has those in his bib file. But the others are probably expected. The issue is that crossref and citeproc use @ for their tags, and so warnings will be issued as the cross-references are not bibkeys; the warnings are harmless. You can turn off these warnings IIRC using a pandoc setting (verbose, I’m not on my mac to check ATM)…

I tried to post a new reply but it ended up here?

Could you share those — I’m just wanting comparability of output and results between the various attempts? (Or I can just construct suitable dummy entries. Plus hoffman2014, siegel2015, simmons2013?)

That’s helpful info re the crossrefs.

Not to worry, I’m sure they’ll release 1.3 soon. I can just wait for that. I’ve added an issue for quarto-run Lua filters calling the system pandoc version.

1 Like

I was just providing a small variation of Ian’s original project to allow the inclusion of multiple bibliographies. The original project is listed in the initial post, here it is: GitHub - iandol/scrivomatic: A writing workflow using Scrivener's style system + Pandoc for output…

This time I started from Ian’s original template again and tried to diverge as little as possible from the original. It’s the same template with a couple of new section types, styles, and minor changes to the ruby script.

@lyndondrake, hopefully, this time it will work better. :wink:
Many thanks again @nontroppo for sharing his Scrivener, Scrivomatic, and Quarto tools.

3 Likes

This is a really nice update, thanks for sharing this!!!

1 Like

Many thanks, I’ll give that a go and switch to the new thread

1 Like

Something that I would like to ask, maybe to @nontroppo , is if I installed Quarto correctly. When invoked from the Mac Terminal it seems to work, so it should.

However: I let the .pkg install it. It installed a “quarto” folder inside my main Applications folder. Inside it, two other folders, named “bin” and “share”. I guess I should simply leave them there, and not move, for example, the “quarto” app into the /bin/ folder of my system.

Thank you for helping me dissolve some fog!

Paolo

Hi, Paolo (@ptram), if I may chime in, I could not quite get what you are saying: is it working or not? Does it work on the terminal with a dummy file? If so, does it also work from Scrivener? If not, what do you see in the Quarto.log?

The Quarto folders seem right—no need to move them around.

Yes, Quarto is working fine. Typing the name in the Terminal recalls it. So, I assume the installation is fine as it is.

Paolo

Ouch, I had missed this part. So, the answer to the question I’m wandering around is – no, you can’t directly use an .md file compiled by Scrivener to create a web site or book with Quarto.

I’m trying with chunkedhtml in Pandoc, but I have yet to understand how to use the produced .html files with Quarto.

Paolo

I am working on a template to do just that. I will share it shortly.

Edit: also, see this: Scrivener + Quarto + Cite Tools: advanced bibliography for a technical/academic publishing workflow - #9 by bernardo_vasconcelos

Yes, while quarto installs into /Applications, it also adds a softlink to /usr/local/bin:

 ▶︎ ls -al /usr/local/bin/q*
lrwxr-xr-x root wheel 31 B Fri May 19 08:36:27 2023  /usr/local/bin/quarto@ ⇒ /Applications/quarto/bin/quarto

So no need to move it around, the terminal path will find it.

As Bernardo mentions he has some code to do this already. But I would just add that the output from the standard quarto templates may be perfectly sufficient for a book or website page, as it still includes a lot of functionality and navigation. There is overlap between using headings in a single document as chapters, or multiple documents as chapters in terms of structure…

1 Like

In printed terms, the material I have to convert to a web site is a little less than 2,000 pages. Unless I can break it into an articulate web site made of several sections and pages, I doubt that it would be usable.

But, in more general terms, I wonder what the use of a single-page web site could be. In particular, if the source of the “narrative” text is Scrivener, a tool dedicated to long writing.

I’m for sure missing the point, but I really can’t see the use of Scrivener with Quarto as it is. I’m sure it will develop further, but I’m a bit lost at this point.

Paolo

The script is very interesting, and thank you very much for developing it!

But I have to say that it would be great if this feature was added natively to Quarto. It would make the procedure a lot smoother. I’ll try to see if this has already been suggested in the dedicated forum.

Paolo

1 Like

As of now, the only workaround I see is to compile individual sections from Scrivener, and then let Quarto assemble a website or book from them.

With a big project, this would be a big task the first time. I guess it would be much easier with subsequent updates, when one has only to compile the modified/updated sections from Scrivener. The newly compiled .md files would replace the older ones, and put together with the ones that have not changed.

It would obviously be great if Scrivener could compile to separate .md files, split at a certain hierarchy level. Or if Quarto could understand pagebreak commands as instructions to split the source document into separate .html pages. I’m even surprised it doesn’t to it already.

Paolo

1 Like

I suppose because the tools for navigating are similar. Here is a standard Scrivener>Quarto document:

The TOC floats to the left, and both top-level chapters and sub-chapters are all available to navigate through. A browser can easily handle cross-linking within a long document. You can link from any chapter to any other. Why must a long document be physically split into different files? You may say sharing chapter links are easier? But Quarto allows easy copying of any chapter links:

Screenshot 2023-06-06 at 20.32.56

Splitting to different files adds complexity, for example search which is trivial within-document becomes more technically complex across documents (however Quarto handles this too!) Quarto does do some nice things for their multi-file outputs, like put document TOC on the left and within-doc TOC on the right, which someone may prefer (I don’t, as a reader I care about content, not navigating file structures!)

So the reason I think Quarto doesn’t do this is more to do with the fact that this is more a workstyle preference of the author (if you are writing markdown in a plain text editor maybe you prefer a folder of files, not an issue with Scrivener), than it is a limitation of the output for the reader.

Still, the more options the better and as Pandoc does now support chunked HTML the job for Quarto or an extension developer should be much easier. You should open an issue on the Quarto github and see where it goes! :+1: Bernardo already has core code to do this for Scrivener so this will be a second route for those who prefer juggling multiple file projects.

1 Like

@nontroppo or any one that can help, my apologies, I’m new to this, I have downloaded the Quarto.scriv folder/project and I have installed quarto (I’m in a win 11 x64, Scrivener: 3.1.5.1, quarto quarto-1.3.433-win) what would be the next steps to compile such a nice looking pdf as the sample output ? Thank you in advance

Congratulations on completion of the PhD - a fantastic achievement