원고 작성

개요

이 페이지에서는 Jupyter Lab에서 Quarto로 학술 원고를 작성하는 방법을 보여드립니다. 다음을 배우게 됩니다.

  • Jupyter Lab에서 원고 미리보기

  • 논문을 설명하는 학술 프론트매터 추가

  • Quarto 전용 마크다운으로 그림, 표, 상호 참조, 인용 추가

  • 인라인 코드 또는 외부 노트북 임베드로 계산 출력 포함

여기서 배우는 명령과 문법은 Jupyter Lab뿐 아니라 노트북을 편집하는 어떤 도구에도 적용됩니다. 또한 Python 코드 예시를 사용하지만, Quarto는 어떤 커널과도 동작하므로 R이나 Julia를 사용할 수도 있습니다.

이 튜토리얼이 나에게 맞나요?

다음 사항을 전제로 합니다.

  • Jupyter Lab에서 파일을 열고 편집하는 데 익숙함
  • GitHub 계정을 보유하고, 리포지토리를 로컬로 클론하는 데 익숙함
  • 파일 시스템을 탐색하고 터미널에서 명령을 실행하는 데 익숙함

설정

따라서 진행하려면 Jupyter Lab Quarto 확장을 설치하고 템플릿 리포지토리를 클론해야 합니다.

Important먼저 Quarto 설치

아직 설치하지 않았다면 원고 개요에 설명된 대로 Quarto 최신 릴리스 버전을 설치하세요.

Jupyter Lab Quarto 확장 설치

설치는 사용하는 JupyterLab 버전에 따라 다릅니다:

Quarto JupyterLab 확장은 다음 두 가지 방법 중 하나로 설치할 수 있습니다:

  1. JupyterLab UI에서: Extension Manager에서 ’Quarto’를 검색해 jupyterlab-quarto 확장을 설치합니다. 완료되면 페이지를 새로고침하라는 안내가 표시됩니다.

    Jupyter Lab Extension Manager에서 검색 상자에 'quarto'가 입력되어 있고, 검색 결과로 'jupyterlab-quarto' 이름의 확장이 표시된 화면.

  2. pip 사용:

    플랫폼 | 명령 |
    Mac/Linux 
    Terminal
    python3 -m pip install jupyterlab-quarto
    Windows 
    Terminal
    py -m pip install jupyterlab-quarto

Quarto JupyterLab 확장은 다음 두 가지 방법 중 하나로 설치할 수 있습니다:

  1. pip을 사용해 jupyterlab-quarto를 다음과 같이 설치합니다:

    플랫폼 | 명령 |
    Mac/Linux 
    Terminal
    python3 -m pip install jupyterlab-quarto==0.1.45
    Windows 
    Terminal
    py -m pip install jupyterlab-quarto==0.1.45

    이 방법은 전통적인 Python 패키징을 활용하고 JupyterLab을 다시 빌드할 필요가 없으므로, JupyterLab Quarto 확장을 설치할 때 권장되는 방식입니다.

  2. JupyterLab UI에서 Extension Manager를 사용해 ’Quarto’를 검색하고 @quarto/jupyterlab-quarto 확장을 설치할 수도 있습니다. 설치를 완료하려면 JupyterLab을 다시 빌드해야 합니다(Quarto 확장을 설치한 뒤 완료하라는 안내가 표시됩니다).

템플릿 리포지토리 클론

이 튜토리얼을 따라 하려면 모든 브랜치가 포함된 템플릿 리포지토리 사본이 필요합니다.

  1. 템플릿에서 새 리포지토리 만들기로 이동합니다.

    Repository Name을 입력하고 Include all branches를 체크하세요. 그런 다음 Create repository from template을 클릭합니다. GitHub에서 템플릿으로 새 리포지토리를 만드는 페이지 스크린샷. Repository name에 manuscript-template이 입력되어 있고 Include all branches 체크박스가 선택되어 있다.

  2. 리포지토리가 만들어지면 로컬 컴퓨터로 클론합니다.

    편한 방식으로 진행하면 됩니다. 예를 들어 터미널에서는 다음과 같이 보일 수 있습니다.

    Terminal
    git clone git@github.com:<username>/<repo-name>.git

    자신의 사용자 이름과 리포지토리 이름을 사용하세요.

  1. 이 튜토리얼 내내 이 디렉터리에서 작업하므로, 진행할 준비가 되면 디렉터리로 이동해 Jupyter Lab을 시작하세요.

    Terminal
    cd manuscript-tutorial
python3 -m jupyter lab

Jupyter Lab 스크린샷. 파일 브라우저에 _extensions, images, notebooks 폴더와 _quarto.yml, index.ipynb, README.md, references.bib 파일이 보인다.

Jupyter Lab에서 열린 템플릿 원고

프로젝트 파일

가장 단순한 Quarto 원고 프로젝트는 두 개의 파일로 구성됩니다.

  • 논문을 작성하는 노트북 파일: index.ipynb. 이 파일에는 다음이 포함됩니다.
    • 논문 프론트매터(저자, 소속 등)와 Quarto 옵션을 포함한 문서 메타데이터
    • 상호 참조와 인용 등을 추가할 수 있는 Quarto 전용 마크다운 문법으로 작성된 논문 본문
    • (선택 사항) 논문에 코드와 출력이 표시되는 방식/표시 여부를 제어하는 코드
  • 프로젝트를 Quarto 원고로 식별하고 원고 구성 방식을 제어하는 설정 파일 _quarto.yml

이 원고 프로젝트에는 다른 파일과 폴더도 포함되어 있으며, 튜토리얼을 진행하면서 이 파일들을 살펴봅니다.

워크플로

Quarto에서 원고를 작성하는 기본 워크플로는 index.ipynb에서 논문 내용을 수정하고, Quarto로 변경 사항을 미리 본 다음, 이를 반복하는 것입니다. 직접 해봅시다.

Jupyter Lab에서 새 터미널을 열고 다음을 실행합니다.

Terminal
quarto preview

터미널에 Quarto 출력이 표시됩니다.

Terminal
$ quarto preview
Preparing to preview
[1/1] index.ipynb

Watching files for changes
Browse at http://localhost:3806/
GET: /

그리고 브라우저 창이 열리면서 원고의 라이브 미리보기가 표시됩니다.

Jupyter Lab와 라이브 미리보기가 나란히 보이도록 창을 이동하고 크기를 조절하면 도움이 됩니다.

브라우저 창 두 개가 나란히 있는 스크린샷. 왼쪽은 터미널에서 quarto preview를 실행한 Jupyter Lab이고, 오른쪽은 localhost로 시작하는 주소와 La Palma Earthquakes 헤더가 보이는 웹페이지다.

논문 콘텐츠는 index.ipynb에서 생성됩니다. Jupyter Lab에서 이 파일을 여세요.

창 두 개가 나란히 있는 스크린샷. 왼쪽은 `index.ipynb` 파일이 열린 Jupyter Lab이며 첫 셀이 La Palma Earthquakes 제목으로 시작한다. 오른쪽은 localhost로 시작하는 주소와 La Palma Earthquakes 헤더가 보이는 웹페이지다.

다음에서 이 파일의 자세한 내용을 살펴보겠지만, 지금은 변경을 하나 해보고 어떻게 되는지 확인해봅시다.

첫 번째 셀(“La Palma Earthquakes”로 시작)은 마크다운 셀입니다. 이 셀을 편집 모드로 전환하고 다음 줄을 찾습니다.

title: La Palma Earthquakes

이 줄을 다음으로 바꾸세요.

title: La Palma Earthquake Mechanisms

노트북을 저장하면 미리보기가 자동으로 업데이트됩니다.

브라우저 창 두 개의 스크린샷. 왼쪽은 index.ipynb 파일이 열린 Jupyter Lab이며 첫 셀은 편집 모드에서 title: La Palma Earthquake Mechanisms가 보인다. 오른쪽은 같은 제목의 논문 웹페이지다.

Tip

실수로 미리보기를 닫았다면 터미널 출력에 있는 URL(예: http://localhost:3806/)로 다시 접근할 수 있습니다. 미리보기를 중지하려면 터미널에서 Ctrl + C를 누르세요. quarto preview를 다시 실행하면 미리보기를 다시 시작할 수 있습니다.

노트북 구조

index.ipynb 파일은 Jupyter Notebook입니다. 다른 Jupyter Notebook과 마찬가지로 raw, markdown, code 셀을 포함할 수 있습니다. 이 노트북에는 Quarto에 특화된 세 가지 요소가 있습니다.

  • 첫 번째 셀에는 문서 메타데이터(학술 프론트매터 포함)를 설정하는 YAML 헤더가 들어 있습니다. 이 셀은 세 개의 대시(---)로 시작하고 끝나야 하며, 그 안의 내용은 YAML로 파싱됩니다. 해당 셀이 마크다운 셀로 설정되어 있는 것을 볼 수 있는데, 이는 Quarto Jupyter Lab 확장이 일부 옵션이 렌더링된 문서에서 어떻게 보일지 시각적으로 에뮬레이션할 수 있게 합니다.

  • 다른 마크다운 셀은 그림, 표, 수식, 상호 참조, 인용 등을 포함하기 위해 Quarto 전용 마크다운 문법을 사용합니다.

  • 코드 셀에는 #|로 시작하는 특별한 Quarto 주석이 맨 위에 있을 수 있습니다. 이 주석은 코드와 출력이 논문에 표시되는 방식을 제어하는 Quarto 옵션을 설정합니다.

이 페이지의 나머지 부분에서는 이 논문의 셀을 위에서 아래로 살펴보며, 학술 논문 작성에 필요한 Quarto 기능을 소개합니다.

프론트매터

YAML 헤더는 key: value 문법으로 설정한 키-값 쌍으로 구성됩니다. 논문에서는 저자와 소속, 초록 같은 학술 프론트매터를 많이 지정해야 하므로 헤더가 길어지는 경우가 많습니다.

title: La Palma Earthquakes
author:
  - name: Steve Purves
    orcid: 0000-0002-0760-5497
    corresponding: true
    email: steve@curvenote.com
    roles:
      - Investigation
      - Project administration
      - Software
      - Visualization
    affiliations:
      - Curvenote
  - name: Rowan Cockett
    orcid: 0000-0002-7859-8394
    corresponding: false
    roles: []
    affiliations:
      - Curvenote
keywords:
  - La Palma
  - Earthquakes
abstract: |
  In September 2021, a significant jump in seismic activity on the island of La Palma (Canary Islands, Spain) signaled the start of a volcanic crisis that still continues at the time of writing. Earthquake data is continually collected and published by the Instituto Geográphico Nacional (IGN). ...
plain-language-summary: |
  Earthquake data for the island of La Palma from the September 2021 eruption is found ...
key-points:
  - A web scraping script was developed to pull data from the Instituto Geogràphico Nacional into a machine-readable form for analysis
  - Earthquake events on La Palma are consistent with the presence of both mantle and crustal reservoirs.
date: last-modified
bibliography: references.bib
citation:
  container-title: Earth and Space Science
number-sections: true

예를 들어 index.ipynb의 최상위 헤더는 title, author, keywords, abstract, plain-language-summary, key-points, date, bibliography, citation, number-sections 키를 설정합니다.

title 키를 수정하면 원고 웹페이지의 논문 제목이 바뀌는 것을 확인했습니다. title 키는 PDF와 Word 포맷에서도 사용되지만, 모든 키가 모든 포맷에서 사용되는 것은 아닙니다.

논문 프론트매터 설정에 대해서는 학술 프론트매터 문서에서 자세히 읽을 수 있습니다.

마크다운

문서의 마크다운 셀은 Quarto 전용 마크다운 문법으로 처리됩니다. Quarto 마크다운 문법은 Pandoc Markdown을 기반으로 하며, 이는 Jupyter Notebook에서 사용하는 것과 같은 John Gruber의 Markdown을 기반으로 합니다.

예를 들어 논문 서론의 제목을 만드는 마크다운은 다음과 같습니다.

## Introduction

1단계 제목은 논문 제목에 사용되므로, 논문 섹션을 구성하려면 2단계 이하 제목을 사용합니다.

마크다운 문법이 익숙하지 않다면 Quarto 마크다운 기본 문서를 읽어보세요.

계산

TipPython 예제

이 섹션은 Python 코드 예제를 사용하지만, Quarto는 R, Julia, Observable도 지원합니다.

따라서 진행하는 데 Python 코드를 다시 실행할 필요는 없지만, 직접 실행하려면 matplotlib와 numpy 패키지가 필요합니다.

논문에는 실행 가능한 코드를 포함할 수 있습니다. 기본적으로 코드는 논문에 표시되지 않지만, 표와 그림을 포함한 출력은 표시됩니다. 논문에 코드를 포함하면 원고 웹페이지의 Notebooks 아래에 “Article Notebook” 링크가 추가됩니다. 이는 코드가 포함된 논문 노트북의 렌더링 버전입니다.

예를 들어 index.ipynb에는 다음이 포함됩니다.

import matplotlib.pyplot as plt
import numpy as np
eruptions = [1492, 1585, 1646, 1677, 1712, 1949, 1971, 2021]

이 코드는 렌더링된 논문에는 나타나지 않지만, “Article Notebook”에는 표시됩니다.

렌더링된 논문 스크린샷. 'Let x denote'로 시작하는 섹션이 보이며 코드는 표시되지 않는다.

Rendered Article

Article Notebook 스크린샷. 'Let x denote'로 시작하는 섹션에서 코드가 두 개의 셀에 표시되며 첫 번째 셀은 'import matplotlib'로 시작한다.

Article Notebook

코드 셀 맨 위에 #| 주석을 추가하고 YAML 문법으로 옵션을 적으면 Quarto 옵션을 지정할 수 있습니다. 예를 들어 echo 옵션을 true로 설정하면 다음과 같습니다.

#| echo: true
import matplotlib.pyplot as plt
import numpy as np
eruptions = [1492, 1585, 1646, 1677, 1712, 1949, 1971, 2021]

echo 옵션은 코드가 렌더링된 논문에 포함되는지 여부를 지정합니다. 이 변경을 적용하고 index.ipynb를 저장하면 논문에 코드가 표시되는 것을 확인할 수 있습니다.

Jupyter 코드 셀 참조 페이지에서 모든 코드 셀 옵션 목록을 확인할 수 있습니다.

다음 코드 셀은 그림을 생성합니다.

#| label: fig-timeline
#| fig-cap: Timeline of recent earthquakes on La Palma
#| fig-alt: An event plot of the years of the last 8 eruptions on La Palma.

plt.figure(figsize=(6, 1))
plt.eventplot(eruptions, lineoffsets=0, linelengths=0.1, color='black')
plt.gca().axes.get_yaxis().set_visible(False)
plt.ylabel('')
plt.show()

label 옵션은 코드 셀과 그 출력에 식별자를 추가하는 데 사용되며, 예를 들어 상호 참조를 가능하게 합니다. 그림 상호 참조에는 fig- 접두사가 필요하며, 접미사(여기서는 timeline)는 원하는 대로 정하면 됩니다. 상호 참조는 아래에서 더 설명합니다.

fig-cap 옵션은 원고에서 그림 아래에 표시되는 캡션 텍스트를 제공하고, fig-alt 옵션은 접근성 준수를 돕는 대체 텍스트를 제공합니다.

계산은 데이터 기반 표를 포함하는 좋은 방법이기도 합니다. 자세한 내용은 Quarto 문서의 계산으로부터 표 만들기를 참고하세요.

논문에 포함하고 싶지 않은 코드 출력이 있다면 output: false를 사용할 수 있습니다. 예를 들어 콘텐츠 작성에 유용한 값이지만 논문에 표시하고 싶지 않을 수 있습니다. 다음 코드 셀은 그 예시입니다.

#| output: false
avg_years_between_eruptions = np.mean(np.diff(eruptions[:-1]))
avg_years_between_eruptions

렌더링된 “Article Notebook”을 보면 이 코드 아래에 avg_years_between_eruptions 값이 표시되지만, 렌더링된 논문에는 나타나지 않습니다.

셀과 출력 모두를 논문과 렌더링된 노트북에서 제외하고 싶다면 include: false를 사용하면 됩니다.

#| include: false
avg_years_between_eruptions = np.mean(np.diff(eruptions[:-1]))
avg_years_between_eruptions

인라인 코드를 사용해 계산된 값을 논문 텍스트에 직접 넣을 수도 있습니다. 자세한 내용은 인라인 코드를 참고하세요.

계산을 논문에 직접 포함하는 대신, 다른 노트북의 출력을 임베드할 수도 있습니다. 자세한 내용은 아래의 노트북 임베드를 참고하세요.

코드는 언제 실행되나요?

기본적으로 Quarto는 .ipynb 노트북의 코드를 실행하지 않습니다. 셀 출력을 업데이트해야 한다면 해당 셀을 실행하고 노트북을 저장하세요.

인용

Tip논문 인용

이 섹션은 논문 본문에 인용을 추가하는 방법을 설명합니다. 논문 웹페이지 하단에 표시되는 논문 자체의 인용은 프론트매터로 제어합니다.

인용을 추가하려면 인용 데이터가 들어 있는 참고문헌 파일 .bib가 필요합니다. 문서 YAML에서 bibliography 옵션으로 이 파일을 지정할 수 있습니다. 예를 들어 index.ipynb의 인용 데이터는 references.bib에 저장되어 있습니다.

bibliography: references.bib

references.bib 파일에는 인용이 하나만 들어 있습니다.

references.bib
@article{marrero2019,
  author = {Marrero, Jos{\' e} and Garc{\' i}a, Alicia and Berrocoso, Manuel and Llinares, {\' A}ngeles and Rodr{\' i}guez-Losada, Antonio and Ortiz, R.},
  journal = {Journal of Applied Volcanology},
  year = {2019},
  month = {7},
  pages = {},
  title = {Strategies for the development of volcanic hazard maps in monogenetic volcanic fields: the example of {La} {Palma} ({Canary} {Islands})},
  volume = {8},
  doi = {10.1186/s13617-019-0085-5},
}

본문에서 참고문헌을 인용하려면 @ 뒤에 인용 식별자(예: marrero2019)를 붙입니다. 예를 들어 논문에는 다음과 같은 인용 문장이 있습니다.

Studies of the magma systems feeding the volcano, such as @marrero2019, have proposed ...

렌더링하면 다음과 같이 보입니다.

Studies of the magma systems feeding the volcano, such as Marrero et al. (2019), have proposed …

인용 텍스트에 마우스를 올리면 전체 참고문헌 정보가 표시됩니다. 인용을 클릭하면 논문 끝의 References 섹션에 있는 해당 참고문헌으로 이동합니다.

렌더링된 논문에서 References 섹션을 보여주는 스크린샷. 제목 아래에 'Marrero, Jose,'로 시작하는 전체 참고문헌이 있다.

위 인용은 저자 이름이 문장 안에 포함된 예입니다. 또 다른 일반적인 스타일은 인용을 괄호 안에 넣는 방식으로, 보통 문장 끝에 둡니다. 이를 위해 인용 문법을 대괄호 [로 감싸면 됩니다. 예를 들어,

A prior study of the magma systems feeding the volcano proposed that there are two main magma reservoirs feeding the Cumbre Vieja volcano [@marrero2019].

렌더링하면 다음과 같이 보입니다.

A prior study of the magma systems feeding the volcano proposed that there are two main magma reservoirs feeding the Cumbre Vieja volcano (Marrero et al. 2019).

페이지 번호, 장 번호를 포함하거나 저자 이름을 제외하는 등 다양한 문법 변형이 있습니다. 자세한 내용은 인용 문서를 참고하세요.

상호 참조

Quarto는 번호와 링크를 자동으로 관리하는 상호 참조를 생성할 수 있습니다. 상호 참조의 일반 문법은 @ 뒤에 레이블을 붙이는 것입니다. 예를 들어 타임라인 그림을 참조하려면 다음처럼 작성합니다.

@fig-timeline

렌더링된 상호 참조에는 “Figure”, “Table”처럼 참조하는 객체의 유형을 나타내는 단어가 포함됩니다. 예를 들어 index.ipynb의 다음 줄은

Eight eruptions have been recorded since the late 1400s (@fig-timeline).

다음 텍스트로 렌더링됩니다.

Eight eruptions have been recorded since the late 1400s (Figure 1).

“Figure 1”은 해당 그림으로 가는 링크이기도 합니다.

요소에 추가하는 레이블은 상호 참조를 위해 적절한 접두사를 가져야 합니다.

요소 레이블 접두사 렌더링된 상호 참조
그림 fig- Figure 1
표 tbl- Table 1
수식 eq- Equation 1
섹션 sec- Section 1

이미 label 코드 청크 옵션으로 코드 출력에 레이블을 추가할 수 있다는 것을 보았습니다. 아래에서 수식, 표, 정적 그림 같은 비코드 요소에 레이블을 추가하는 방법도 살펴봅니다.

섹션을 상호 참조하려면 문서 YAML 헤더에 다음도 포함되어야 합니다.

number-sections: true

섹션 제목 뒤에 중괄호로 레이블을 추가할 수 있습니다. 예:

## Data & Methods {#sec-data-methods}

그 다음 텍스트에서 이 섹션을 다음처럼 참조할 수 있습니다.

Data and methods are discussed in @sec-data-methods.

렌더링하면 다음과 같이 표시됩니다.

Data and methods are discussed in Section 2.

코드 목록, 수학 정리 등 참조할 수 있는 객체 유형과 참조 표시 방식을 제어하는 옵션은 Quarto 상호 참조 문서에서 자세히 확인할 수 있습니다.

수식

Quarto 마크다운에는 LaTeX 표기법으로 작성한 수식을 포함할 수 있습니다. 인라인 수식은 달러 기호 하나($), 디스플레이 수식은 달러 기호 두 개($$)를 사용합니다. 둘 다 index.ipynb의 다음 문단에서 확인할 수 있습니다.

Let $x$ denote the number of eruptions in a year. Then, $x$ can be modeled by a Poisson distribution

$$
p(x) = \frac{e^{-\lambda} \lambda^{x}}{x !}
$$ {#eq-poisson}

where $\lambda$ is the rate of eruptions per year. Using @eq-poisson, the probability of an eruption in the next $t$ years can be calculated.

디스플레이 수식의 닫는 $$ 뒤에 중괄호로 레이블이 추가되어 있는 것을 확인하세요. 이를 통해 본문에서 @eq-poisson으로 참조할 수 있습니다.

렌더링하면 다음과 같이 표시됩니다.

Let \(x\) denote the number of eruptions in a year. Then, \(x\) can be modeled by a Poisson distribution \[ p(x) = \frac{e^{-\lambda} \lambda^{x}}{x !} \tag{1}\] where \(\lambda\) is the rate of eruptions per year. Using Equation 1, the probability of an eruption in the next \(t\) years can be calculated.

표

표는 파이프 문법으로 인라인에 추가할 수 있습니다. 예를 들어 index.ipynb에는 지진 표가 다음과 같이 작성되어 있습니다.

| Name                 | Year   |
| -------------------- | ------ |
| Current              | 2021   |
| Teneguía             | 1971   |
| Nambroque            | 1949   |
| El Charco            | 1712   |
| Volcán San Antonio   | 1677   |
| Volcán San Martin    | 1646   |
| Tajuya near El Paso  | 1585   |
| Montaña Quemada      | 1492   |

: Recent historic eruptions on La Palma {#tbl-history}

열은 파이프(|)로 구분하고, 두 번째 줄의 대시(-)는 헤더 행과 나머지 표를 구분합니다. :로 시작하는 줄을 사용해 캡션을 제공할 수 있습니다. 상호 참조에 사용할 레이블은 캡션 끝에 중괄호로 추가합니다. 그림과 마찬가지로 상호 참조에는 tbl- 접두사가 필요하며, 접미사는 자유롭게 정할 수 있습니다.

Quarto에서 표를 사용하는 방법과 grid table이라는 대체 문법은 Quarto 문서의 표 페이지에서 더 자세히 알아볼 수 있습니다.

정적 그림

파일에서 그림을 포함하려면 마크다운 문법은 다음과 같습니다.

![Caption](file_path_to_image)

예를 들어 프로젝트의 images/ 폴더에 있는 la-palma-map.png 이미지를 “Map of La Palma” 캡션과 함께 포함하려면 다음과 같이 작성합니다.

![Map of La Palma](images/la-palma-map.png)
Tip이미지 파일 위치

이미지를 꼭 images/ 폴더에 둘 필요는 없지만 일반적인 관례입니다. 이미지는 원고 프로젝트 디렉터리 내부의 어디에 두어도 되며, index.ipynb 위치를 기준으로 이미지의 전체 경로를 포함해야 합니다.

index.ipynb의 실제 마크다운에는 이미지 경로 뒤 중괄호 안에 #fig-map 속성을 추가해 상호 참조용 레이블을 제공합니다.

![Map of La Palma](images/la-palma-map.png){#fig-map}

이미지의 대체 텍스트를 제공하는 fig-alt 속성을 추가할 수도 있습니다. 예를 들어:

![Map of La Palma](images/la-palma-map.png){#fig-map fig-alt="카나리아 제도의 지도. 서쪽에서 두 번째 섬인 라 팔마가 강조 표시되어 있다."}

그림 크기 조정과 여러 그림 배치 방법을 포함한 Quarto 문서의 그림 사용법은 그림 페이지에서 더 자세히 확인할 수 있습니다.

외부 임베드

논문 노트북에 계산을 직접 포함하는 대신, 다른 노트북의 출력을 임베드할 수도 있습니다. 이 원고 프로젝트에는 notebooks/ 폴더의 data-screening.ipynb 노트북이 포함되어 있습니다.

노트북 출력을 임베드하려면 embed 숏코드를 사용합니다. Quarto 숏코드는 콘텐츠를 생성하는 특수 마크다운 지시문입니다. embed 숏코드는 주요 논문 파일의 다음 줄에서 사용됩니다.

index.ipynb
{{< embed notebooks/data-screening.ipynb#fig-spatial-plot >}}

이중 중괄호({{)와 꺾쇠 괄호(<)는 숏코드임을 나타냅니다. embed 숏코드는 노트북 셀 경로를 요구합니다. 이 경우 data-screening.ipynb 파일 경로 뒤에 #과 셀 식별자를 붙입니다. 여기서 셀 식별자는 data-screening.ipynb 노트북의 코드 셀에 있는 Quarto 셀 옵션 label로 지정된 셀 레이블입니다.

data-screening.ipynb
#| label: fig-spatial-plot
#| fig-cap: "Locations of earthquakes on La Palma since 2017."
#| fig-alt: "A scatterplot of earthquake locations plotting latitude 
#|   against longitude."
from matplotlib import colormaps
cmap = colormaps['viridis_r']
ax = df.plot.scatter(x="Longitude", y="Latitude", 
                     s=40-df["Depth(km)"], c=df["Magnitude"], 
                     figsize=(12,10), grid="on", cmap=cmap)
colorbar = ax.collections[0].colorbar
colorbar.set_label("Magnitude")

plt.show()

다른 그림과 마찬가지로 fig-로 시작하는 레이블을 사용하면 본문에서 상호 참조할 수 있습니다. 그림 캡션(fig-cap)과 대체 텍스트(fig-alt) 같은 다른 옵션도 소스 노트북에서 설정할 수 있습니다.

이 원고에서는 data-screening.ipynb 노트북을 재현할 수 없습니다. 일부 입력(예: 데이터)이 프로젝트에 포함되어 있지 않아 모든 출력을 다시 생성할 수 없기 때문입니다. 하지만 노트북의 코드 셀을 다시 실행하지 않고도 Quarto 셀 옵션은 변경할 수 있습니다. 캡션을 다음과 같이 수정하면,

#| fig-cap: "Earthquakes on La Palma since 2017."

data-screening.ipynb를 저장하면 미리보기가 업데이트되고 캡션이 논문에 반영되는 것을 볼 수 있습니다.

다음 단계

이제 원고 작성을 위한 Quarto의 주요 기능을 살펴보았습니다. index.ipynb를 편집하고, 그림/노트북/참고문헌 데이터 같은 리소스를 추가했으며, 결과를 미리보기했습니다.

변경 사항이 만족스럽다면 공개 원고 웹페이지를 업데이트해야 합니다.

배포로 이동해 원고를 공개하고 공유하는 방법을 알아보세요.