프런트 매터

개요

학술 논문은 제목과 작성자만으로는 충분하지 않은(훨씬 더 많은) 프런트 매터 정보를 요구합니다. Quarto는 이러한 요구 사항을 표현할 수 있도록 다양한 YAML 메타데이터 키를 제공합니다. 이 페이지에서는 작성자와 소속, 초록과 키워드 같은 요약 정보, 저작권·라이선스·연구비 정보를 입력하는 방법을 알아봅니다.

아래 YAML 헤더에는 이 문서에서 설명하는 최상위 키가 모두 포함되어 있습니다.

document.qmd

---
title: "Toward a Unified Theory of High-Energy Metaphysics: Silly String Theory"
date: 2008-02-29
author:
  - name: Josiah Carberry
    id: jc
    orcid: 0000-0002-1825-0097
    email: josiah@psychoceramics.org
    affiliation: 
      - name: Brown University
        city: Providence
        state: RI
        url: www.brown.edu
abstract: > 
  The characteristic theme of the works of Stone is 
  the bridge between culture and society. ...
keywords:
  - Metaphysics
  - String Theory
license: "CC BY"
copyright: 
  holder: Josiah Carberry
  year: 2008
citation: 
  container-title: Journal of Psychoceramics
  volume: 1
  issue: 1
  doi: 10.5555/12345678
funding: "The author received no specific funding for this work."
---

위 메타데이터로 생성된 HTML, JATS 문서는 아래와 같습니다.

위 메타데이터로 생성된 JATS 미리 보기

위 메타데이터로 생성된 HTML 미리 보기

모든 형식에서 모든 키를 사용하는 것은 아닙니다. 그래도 이 페이지에서 설명하는 태그는 대부분 학술지 형식에서 지원됩니다. 현재 가장 많은 메타데이터 태그를 사용하는 형식은 JATS이므로, 렌더링 결과를 확인하려면 format: jats로 미리 보기하는 것을 권장합니다.

작성자 및 소속

가장 간단한 작성자 표기법은 author 키에 문자열을 직접 전달하는 것입니다.

---
author: Norah Jones
---

하지만 학술 논문에는 더 많은 정보가 필요하므로 author에는 다양한 하위 키가 있습니다. 예를 들어 affiliation 키로 작성자의 소속을 지정할 수 있습니다. 가장 단순하게는 name, affiliation에 각각 문자열을 전달합니다.

---
author:
  name: Norah Jones
  affiliation: Carnegie Mellon University
---

author, affiliation에 제공할 수 있는 다른 키는 각각 Author, Affiliation 섹션에서 소개합니다.

author, affiliation 둘 다 여러 값을 받아 복수 작성자 또는 복수 소속을 표현할 수 있습니다. 아래는 첫 번째 작성자가 두 개의 소속을 가진 예시입니다.

---
author:
  - name: Norah Jones
    affiliation: 
      - Carnegie Mellon University
      - University of Chicago
  - name: Josiah Carberry
    affiliation: Brown University
---

각 항목 앞에 -가 붙고 적절히 들여쓰기된 점에 주목하세요. 여러 작성자가 같은 소속을 공유할 때 반복을 줄이는 방법은 아래 여러 작성자 섹션에서 설명합니다.

단수형 / 복수형

author, affiliation은 단수형( author, affiliation)과 복수형(authors, affiliations) 모두 사용할 수 있습니다.

Author

name, affiliation 외에도 author에는 다음 키를 지정할 수 있습니다.

`author`에서 사용할 수 있는 키
`email` `phone` `fax` `url`	string	작성자 연락처. 여러 형식에서 하이퍼링크로 변환됩니다. \|
`degrees`	string(s)	이름 뒤에 표시할 학위나 전문 자격. \|
`orcid`	string	작성자의 ORCID. `0000-0000-0000-0000` 형식을 사용하며, 많은 형식에서 ORCID 링크가 생성됩니다. \|
`note` `acknowledgements`	string	작성자에 대한 메모(예: 기여 내용). \| 작성자의 감사 문구.
`roles`	string(s)	작성자 역할. 아래 작성자 역할 참조.
`corresponding` `equal-contributor` `deceased`	`true`/`false`	교신 저자로 표시합니다. \| 다른 기여자와 동일한 기여도를 가졌음을 표시합니다. \| 고인임을 표시합니다. \|
`id`	string	다른 필드에서 이 작성자를 참조할 때 사용할 식별자. 예시는 연구비 참조. \|

author에 affiliations-url 키를 제공하면 affiliation의 url로 전달됩니다.

보다 자세한 작성자 정보는 다음과 같이 입력할 수 있습니다.

---
author:
  - name: Josiah Carberry
    orcid: 0000-0002-1825-0097
    url: https://en.wikipedia.org/wiki/Josiah_S._Carberry
    email: josiah@psychoceramics.org
    corresponding: true
---

이름 구성 요소

Quarto는 name 값을 자동으로 구성 요소별로 분석합니다. 자동 분석이 올바르지 않다면 given, family, dropping-particle, non-dropping-particle을 직접 지정할 수 있습니다.

---
author: 
  - name: 
      given: Charles
      family: Gaulle
      non-dropping-particle: de
  - name: 
      given: Ludwig
      family: Beethoven
      dropping-particle: van
---

학위

degrees 필드를 사용하면 작성자의 학위/칭호를 표기할 수 있습니다.

author:
  - name: Josiah Carberry
    degrees: 
      - B.S.
      - PhD

작성자 역할

roles를 사용해 작성자의 기여를 설명합니다. 문자열로 자유롭게 작성해도 됩니다.

author:
  - name: Josiah Carberry
    roles: "Conceived and designed the study, analysed the results and wrote the manuscript."

또는 CRediT(Contributor Roles Taxonomy)의 14가지 역할 중 하나를 사용할 수 있습니다.

author:
  - name: Josiah Carberry
    roles: conceptualization

여러 역할을 배열로 지정할 수도 있습니다.

author:
  - name: Josiah Carberry
    roles: [investigation, data curation]

역할과 기여 정도를 함께 지정할 수도 있습니다.

author:
  - name: Josiah Carberry
    roles: 
      - investigation: lead 
      - data curation: supporting

14가지 CRediT 역할 보기

`roles`에 사용할 수 있는 CRediT 역할 값
값	별칭
conceptualization
data curation
formal analysis	analysis
funding acquisition	funding
investigation
methodology
project administration
resources
software
supervision
validation
visualization
writing – review & editing	editing
writing – original draft	writing

Affiliation

affiliation도 문자열을 직접 전달할 수 있습니다.

---
author:
  name: Norah Jones
  affiliation: Carnegie Mellon University
---

또는 name 키로 명시할 수도 있습니다.

---
author:
  name: Norah Jones
  affiliation: 
    name: Carnegie Mellon University
---

affiliation에는 다음 키를 추가로 지정할 수 있습니다.

`affiliation`에서 사용할 수 있는 키
`department`	String
`group`	String	소속 내부의 팀/연구 그룹.
`address` `city` `region` or `state` `country` `postal-code`	String	소속 위치. `region` 또는 `state` 중 하나, 그리고 나머지 키에서 필요한 조합을 제공합니다. \|
`url`	String	소속 웹사이트. 여러 형식에서 링크로 변환됩니다. \|
`isni` `ringgold` `ror`	Numeric Numeric String	소속 ID: 16자리 ISNI; 4~6자리 Ringgold ID; `https://ror.org/`로 시작하는 ROR ID + 9자리 영숫자 식별자.

보다 완전한 소속 정보는 다음과 같이 입력할 수 있습니다.

---
author:
  name: Josiah Carberry
  orcid: 0000-0002-1825-0097
  url: https://en.wikipedia.org/wiki/Josiah_S._Carberry
  email: josiah@psychoceramics.org
  corresponding: true
  affiliation: 
    - name: Brown University
      department: Psychoceramics
      city: Providence
      state: RI
      country: US
      url: www.brown.edu
      ringgold: 6752
      isni: 0000000419369094
---

여러 작성자

공동 저자가 여러 명이면 소속을 공유하는 경우가 많습니다. 소속 정보를 반복하지 않으려면 소속을 한 번만 정의하고 ID를 부여한 뒤 다른 필드에서 참조할 수 있습니다.

한 가지 방법은 작성자 정의 안에서 각 소속에 id를 부여하는 것입니다.

---
author:
  - name: Norah Jones
    affiliation:
      - id: cmu
        name: Carnegie Mellon University
      - id: chicago
        name: University of Chicago
---

그다음 다른 작성자를 추가할 때 ref:로 소속을 참조할 수 있습니다.

---
author:
  - name: Norah Jones
    affiliation:
      - id: cmu
        name: Carnegie Mellon University
      - id: chicago
        name: University of Chicago
  - name: John Hamm
    affiliation:
      - ref: cmu
---

또 다른 방법은 소속을 최상위에서 정의하는 것입니다.

---
author:
  - name: Norah Jones
    affiliation:
      - ref: cmu
      - ref: chicago
  - name: John Hamm
    affiliation:
      - ref: cmu
affiliations:
  - id: cmu
    name: Carnegie Mellon University
  - id: chicago
    name: University of Chicago
---

이 방식은 author 외의 필드(예: funding)에서도 소속을 참조해야 할 때 특히 편리합니다.

초록

abstract 키로 초록을 추가할 수 있습니다. 초록은 여러 줄이고 마크다운을 포함할 수 있으므로, YAML 리터럴 블록(|)을 사용해야 합니다.

---
abstract: |
  This article evaluates novel approaches to do
  some really important things.
---

키워드

keywords로 키워드를 추가합니다.

---
keywords: 
  - open-source 
  - scientific publishing
  - reproducible research
---

저작권

---
copyright: "Copyright Acme, Inc. 2021. All Rights Reserved"
---

동일한 문자열을 statement 하위 키에 전달합니다.

---
copyright: 
  statement: "Copyright Acme, Inc. 2021. All Rights Reserved"
---

또는 holder, year를 지정합니다.

---
copyright: 
  holder: Acme, Inc
  year: 2021
---

year에는 범위(year: 2021 - 2023)나 배열(year: [2021, 2022, 2023])도 사용할 수 있습니다.

라이선스

license에 문자열을 직접 전달하거나,

---
license: "This work is dedicated to the Public Domain"
---

text 하위 키에 지정할 수 있습니다.

---
license:
  text: "This work is dedicated to the Public Domain"
---

type, url 등을 추가할 수도 있습니다.

---
license:
  text: > 
    Permission is granted to copy, distribute and/or 
    modify this document under the terms of the GNU Free 
    Documentation License, Version 1.3 or any later version 
    published by the Free Software Foundation; with no 
    Invariant Sections, no Front-Cover Texts, and no 
    Back-Cover Texts. A copy of the license is included in 
    the section entitled "GNU Free Documentation License
  type: open-access
  url: https://www.gnu.org/licenses/fdl-1.3-standalone.html
---

크리에이티브 커먼즈 라이선스를 선택한다면 약어만 전달해도 됩니다.

---
license: "CC BY"
---

사용 가능한 약어는 아래 크리에이티브 커먼즈 섹션에서 확인하세요.

크리에이티브 커먼즈

라이선스	이름	설명
`CC BY`	Attribution	원저작자를 명시하기만 하면 다른 사람이 저작물을 배포·리믹스·수정·2차 창작(상업적 이용 포함)할 수 있습니다. 가장 허용 범위가 넓은 라이선스입니다.
`CC BY-SA`	Attribution-ShareAlike	원저작자를 명시하고 동일한 조건으로 라이선스를 부여한다면 상업적 이용을 포함한 2차 창작이 가능합니다. “카피레프트” FOSS 라이선스와 유사하며, 파생 작품도 동일 라이선스를 사용해야 합니다.
`CC BY-ND`	Attribution-NoDerivs	상업적/비상업적 재배포가 가능하지만 변경 없이 전체를 그대로 공유해야 하며, 원저작자를 명시해야 합니다.
`CC BY-NC`	Attribution-NonCommercial	비상업적 용도로만 리믹스·수정·2차 창작이 가능하며, 2차 저작물도 비상업적이어야 하고 원저작자를 명시해야 합니다. 다만 동일 라이선스를 사용할 필요는 없습니다.
`CC BY-NC-SA`	Attribution-NonCommercial-ShareAlike	비상업적 용도로만 2차 창작이 가능하며, 원저작자를 명시하고 동일 조건으로 라이선스를 부여해야 합니다.
`CC BY-NC-ND`	Attribution-NonCommercial-NoDerivs	가장 제한적인 라이선스로, 원저작자를 명시한 상태에서 작품을 다운로드하고 다른 사람과 공유할 수는 있지만 어떤 방식으로도 수정하거나 상업적으로 사용할 수 없습니다.
`CC0`		CC0(일명 CC Zero)는 저작자가 저작권을 포기하고 전 세계 퍼블릭 도메인에 저작물을 공개하도록 해 줍니다. CC0를 사용하면 어떤 매체나 형식에서도 조건 없이 배포·리믹스·수정·2차 창작이 가능합니다.

크리에이티브 커먼즈 라이선스를 지정하면 Quarto가 자동으로 해당 라이선스에 대한 링크를 삽입합니다.

인용 정보

citation 키에는 문서 인용을 생성할 때 사용하는 추가 메타데이터를 입력합니다. 자세한 내용은 인용 가능한 문서 만들기를 참고하세요.

연구비

funding 키에 문자열을 직접 입력하거나,

---
funding: "The author(s) received no specific funding for this work."
---

statement 하위 키에 지정할 수 있습니다.

---
funding: 
  statement: "The author(s) received no specific funding for this work."
---

funding에는 source, recipient, investigator 하위 키도 사용할 수 있습니다. recipient, investigator에는 문자열 또는 ref:를 사용한 작성자/소속 참조를 지정할 수 있습니다. 예를 들어 아래 프런트 매터는 작성자 ID를 참조하는 연구비 정보를 추가합니다.

---
author:
  - name: Norah Jones
    id: nj
funding:
  - source: "NIH (Grant #: 1-R01-MH99999-01A1)"
    investigator: 
      - ref: nj
---