Readme

A test environment for contributors and technical operators.

You are welcome to test out the system, just raise an issue and indicate if you want to be an author, technical operator. Of course you can be both.

Your welcome to do what you like with the setup - it will be overwritten on a regular basis so there is no breaking things.

The system connects: Nextcloud, Zotero, Quarto, and Notebooks/interactive/data analysis platforms.

Contact: Simon Worthington, [email protected]

A Quarto book

To learn more about Quarto books visit https://quarto.org/docs/books.

Guide

Contributors

1. In the /docs directory edit your .DOCX files or add more .DOCX files as needed.
2. Note: To ensure reliable publishing the word processor needs to be used properly: Set you language, use styles and proper formatting for lists, figures, tables, paragraph spacing, etc. Use the Navigator function and the show invisibles. Ask a publication manager to review your file if uncertain about word processor formatting.
3. Images - please upload images to the /images directory and then in sert in your DOCX files as this helps with later publishing. You dont have to do thsi, but it helps keep things tidy.
4. Connect your Zotero account via Nextcloud by generating a Zotero API key, configuring Zotero permissions, adding to your personal account on Nextcloud. Note Nextcloud and Zotero use seems to be temperamental.
5. Invite co-authors.
6. To preview publishing raise an issue to request a publication render. Include the files order in your issue. Note this is a public test site, your edits will be made public on the web.

Table of contents e.g.

doc1.docx
doc2.docx
doc3.docx 

Backend

Have Quarto CLI installed or use via VScode.

Use Pandoc from inside Quarto to convert .DOCX to Markdown and generate media. Output to the markdown directory.

quarto pandoc --extract-media ./images sandboxdoc04.docx -o output2.qmd

Edit the Qurato table of contents as needed, see _quarto.yml

To preview use:

 quarto check
 quarto render
 quarto preview    

To publish use:

quarto publish gh-pages

Save and commit resources used if needed.