Add a section for Quarto in Writing and Sharing

[SaintRod]

Hello, and thanks for putting this together.

I am submitting this issue to propose the inclusion of Quarto. The best place to include Quarto is in the writing section, however, it may be worthwhile to include it in the sharing section too (more on this below).

Thank you for your consideration.

What is Quarto?

Quarto® is an open-source scientific and technical publishing system built on Pandoc. You can weave together narrative text and code to produce elegantly formatted output as documents, web pages, blog posts, books, and more. source

Helpful links:

• This is the Quarto homepage
• Quarto now has a native Julia engine, "prior to 1.5, Julia code cells were executed through the Jupyter engine"
  • This is the blog post about the release of Quarto version 1.5 in which the native Julia engine was released
  • These are the instructions for using the new native Julia engine
  • This is the Github repo for the native Julia engine (AKA QuartoNotebookRunner.jl)

Why include Quarto in the writing section?

Ultimately, Quarto is called on for its side effects, to "produce ... output [such] as documents, web pages, blog posts, books, and more". Quarto can generate said output via .qmd markdown files, .rmd RMarkdown files, and .ipynb Jupyter Notebooks. Quarto works well with, "VSCode, JupyterLab, RStudio IDE, or any text editor."

I use .qmd files as I'm more comfortable with markdown than Jupyter Notebooks. I use Quarto because sharing Jupyter Notebooks with stakeholders or non-technical audiences can be daunting. I usually publish to HTML files and either omit to publish the code chunks or hide code chunks with an option to unhide them. Quarto is very flexible.

The new native Julia engine can also use project environments, which previous versions of Quarto did not.

Last, the vast output options make Quarto very useful. For example, I'm working on a blog post built with Python and Quarto (.qmd) that I will publish to GitHub Pages using the website publishing option, which is a good segway into the next section.

Adding Quarto to the writing section should fit in seamlessly as Jupyter Notebooks and environments are also discussed.

Why include Quarto in the sharing section?

How can I share documents and have people comment on them?
You can publish Quarto content to various locations. See the user guides for publishing for details on using Quarto Pub, GitHub Pages, Netlify, Posit Connect, and other services with Quarto. Once documents are published you can use hypothes.is, Utterances, or Giscus for commenting. Learn more in the documentation on commenting. source

Another option to share content is to host on GitHub Pages using the website publishing option. I'd be remiss not to mention that publishing to Quarto Pub is free!

[adrhill]

We very briefly mention Quarto in the "Literate programming" section of the "Sharing" page:

Quarto is another cross-language notebook system that supports Python, R and Julia

Quarto is much more than just a notebook system, so that mention should probably be expanded by a sentence or two with pointers to different output formats.

I also agree it should be mentioned in the "Notebook" section of the "Writing" page as an alternative to Jupyter notebooks.

[adrhill]

If you're willing to give it a shot, you could open a pull request with your desired changes.
The contents of the MoJuWo website are markdown based. You'll need to add your changes to the index.md files in the writing and sharing folders.

Our contributor's guide / style guide can be found here.

[SaintRod]

Hi, @adrhill:

I'm happy to try! If anything is unclear I'll post questions here.

[gdalle]

Closed by #122