atomic-server icon indicating copy to clipboard operation
atomic-server copied to clipboard

Quatro export / publish support for AtomicServer

Open joepio opened this issue 1 year ago • 1 comments

Quatro is a tool for writing and publishing articles, popular in (computer) science circles.

@AlexMikhalev said it might be a good idea for us to write an export feature to their CLI. This has already been done for Confluence (ts, docs), for example.

Before we dive into this, I'd like to further explore how much value we're adding by making this.

  • In which situations would publishing to AtomicServer make sense? IMO primarily when the user migrates from Quatro to AtomicServer.
  • How well does the data model map? Both AtomicServer Articles and Quaotro Articles use markdown, so probably a lot? But perhaps there are some things that Quaotro supports that we don't (math formatting, for example)

joepio avatar Aug 07 '24 09:08 joepio

I use Quarto https://quarto.org/ for customers and for ourselves, use cases:

  1. build sane and stylish docs (better than mkdocs)
  2. Turn docs into pdf, docx
  3. Create dashboards out of Python notebooks or markdown files
  4. Turn any of the above into Markdown is quite common, but for publishing, you need a different type of markdown, this is where pandoc and quarto (wrapper on top of it) come into play: For example https://quarto.org/docs/output-formats/hugo.html transformation required to publish into hugo or into docusaurus: https://quarto.org/docs/output-formats/docusaurus.html I want to have a single source of truth for my content in Markdown (version controlled) and then publish it to multiple platforms, including Atomic CMS.

AlexMikhalev avatar Aug 20 '24 06:08 AlexMikhalev