Quarto 소개

과학 및 기술 출판을 위한 오픈 소스 도구

목표

Quarto의 궁극적인 목표는 과학 및 기술 문서를 작성하고 협업하는 과정을 획기적으로 개선하는 것입니다. 다음과 같은 여러 측면에서 이를 달성하고자 합니다:

  • 기술 콘텐츠를 위한 우수한 통합 도구를 갖춘 작성 및 출판 환경을 만듭니다. 코드 임베딩, 수식, 그림, 복잡한 다이어그램, 대화형 위젯, 인용, 상호 참조 및 과학적 담론의 수많은 특수 요구 사항을 모든 사람에게 간단하고 생산적으로 만들고자 합니다.

  • 저자가 웹을 연결되고 대화형인 커뮤니케이션 플랫폼으로 최대한 활용할 수 있도록 돕는 동시에, 동일한 문서 소스에서 훌륭한 인쇄 출력물을 만들 수 있는 기능을 제공합니다. 연구자는 LaTeX, MS Word, HTML 중에서 선택할 필요 없이 동시에 모두를 대상으로 하는 문서를 작성할 수 있어야 합니다.

  • 재현 가능한 연구 및 출판을 예외가 아닌 표준으로 만듭니다. 재현성을 위해서는 원고를 작성하는 데 필요한 코드와 데이터가 원고의 통합된 부분이어야 합니다. 그러나 실제로는 이것이 종종 간단하지 않습니다. Quarto는 재현 가능한 워크플로를 채택하지 않는 것보다 채택하는 것을 더 쉽게 만드는 것을 목표로 합니다.

Quarto는 오픈 소스 소프트웨어입니다. 우리는 연구와 과학에 사용되는 도구가 무료이고 개방되어 있을 때 모두에게 더 나을 것이라고 믿습니다. 재현성, 지식과 기술의 광범위한 공유, 비용 장벽을 제거하여 경쟁의 장을 평평하게 만드는 것은 과학에서 자유 소프트웨어의 공유 이점 중 일부에 불과합니다.

프로젝트

Quarto의 핵심은 강력하고 유연한 문서 처리 도구인 Pandoc입니다. Quarto는 과학 및 기술 출판을 위해 Pandoc에 다음과 같은 여러 기능을 추가합니다:

  1. Jupyter, Knitr, Observable과의 통합을 통해 Python, R, JavaScript의 코드 및 출력을 임베딩합니다.

  2. 상호 참조, 하위 그림, 레이아웃 패널, 호버 가능한 인용 및 각주, 콜아웃 등 기술 문서 작성에 유용한 다양한 Pandoc 마크다운 확장 기능을 제공합니다.

  3. 문서 그룹을 한 번에 렌더링하고, 문서 간에 옵션을 공유하며, 웹사이트 및 책과 같은 집계 출력을 생성하는 프로젝트 시스템을 제공합니다.

Quarto의 개발은 Posit, PBC가 후원하며, 우리는 이전에 동일한 목표를 공유하지만 주로 R 언어 사용자를 대상으로 하는 유사한 시스템(R Markdown)을 만들었습니다. 동일한 핵심 팀이 Quarto와 R Markdown 모두를 작업합니다:

Quarto를 통해 이러한 도구를 훨씬 더 많은 사람들에게 제공하기를 희망합니다.

Quarto는 Posit의 등록 상표입니다. Quarto 상표 사용에 대한 가이드라인은 상표 정책을 참조하십시오.

기여하기

다음과 같은 여러 방법으로 Quarto에 기여할 수 있습니다:

  • 이슈를 열어 피드백을 제공하고 아이디어를 공유합니다.
  • 열린 이슈를 수정하기 위해 풀 리퀘스트(PR)를 제출합니다.
  • 새로운 기능을 제안하기 위해 풀 리퀘스트(PR)를 제출합니다(새로운 기능에 대한 풀 리퀘스트를 작업하기 전에 토론을 위해 이슈를 여는 것이 좋은 관행으로 간주됩니다).

다른 커뮤니티 구성원과 상호 작용할 때 행동 강령을 염두에 두시기 바랍니다.

풀 리퀘스트

풀 리퀘스트를 환영합니다! PR을 통해 기여하는 방법은 다음과 같습니다:

  1. 저장소를 포크하고, 로컬에 복제한 다음, PR에 특정한 새 브랜치에서 변경 사항을 만듭니다. 예를 들어:

    Terminal
    # clone your fork
$ git clone https://github.com/<username>/quarto-cli

# 플랫폼에 맞게 구성 (Windows의 경우 ./configure.sh 또는 ./configure.cmd)
$ cd quarto-cli
$ ./configure.sh

# 새 브랜치 체크아웃
$ git checkout -b feature/newthing

  2. 중요한 변경 사항(예: 작은 버그 수정 이상)의 경우, 적절한 개인 또는 법인 기여자 계약서에 서명했는지 확인하십시오. 서명한 사본은 으로 보낼 수 있습니다.

  3. 풀 리퀘스트를 제출합니다. 아직 작업 중이지만 우리로부터 피드백을 받고 싶다면 초안으로 제출해도 괜찮습니다. 작업 중임을 공개적으로 공유하는 것은 항상 좋습니다.

우리는 풀 리퀘스트를 검토하고 수락하는 데 최대한 신속하게 대응하도록 노력하겠습니다.