콘텐츠로 이동
Oleaflyv0.4.12

출처를 찾고, 메타데이터를 확인하고, 알맞은 참고문헌에 추가하고, 커서 위치에서 인용하고, Typst 인용 스타일을 고르고, 원본을 잃지 않고 라이브러리를 정리합니다.

인용은 하나의 사슬입니다. 주장은 키를 가리키고, 키는 참고문헌 항목을 가리키며, 항목은 실제 출처를 가리킵니다. Oleafly는 이 사슬이 눈에 보이게 유지하므로 빠르게 조회한 결과가 나중에 출처를 알 수 없는 참고문헌이 되지 않습니다.

인용의 연결 고리본문의 인용 명령, 예를 들어 백슬래시 cite vaswani2017은 키를 가리킵니다. 키는 references.bib의 항목을 가리키고, 그 항목은 DOI나 arXiv ID로 실제 자료를 가리킵니다. 새 항목은 Zotero 라이브러리에서, DOI, arXiv ID, ISBN으로 찾아서 추가하기에서, 또는 참고문헌 라이브러리 가져오기에서 .bib으로 들어옵니다.본문에서\cite{vaswani2017}references.bib에서@article{vaswani2017실제 자료DOI 또는 arXiv IDZotero@로 인용찾아서 추가하기DOI, arXiv ID, ISBN가져오기라이브러리 전체키DOI인용의 연결 고리본문의 인용 명령, 예를 들어 백슬래시 cite vaswani2017은 키를 가리킵니다. 키는 references.bib의 항목을 가리키고, 그 항목은 DOI나 arXiv ID로 실제 자료를 가리킵니다. 새 항목은 Zotero 라이브러리에서, DOI, arXiv ID, ISBN으로 찾아서 추가하기에서, 또는 참고문헌 라이브러리 가져오기에서 .bib으로 들어옵니다.본문에서\cite{vaswani2017}references.bib에서@article{vaswani2017실제 자료DOI 또는 arXiv ID새 항목Zotero, 찾아서 추가하기,참고문헌 라이브러리 가져오기키DOI
본문의 키는 .bib의 항목을 가리키고, 그 항목은 실제 자료를 가리킵니다. 새 항목은 Zotero, 찾아서 추가하기, 가져오기에서 들어옵니다.
Oleafly의 참고문헌 패널. 참조, 인용, 심볼 사이를 전환하고, 검색 필드로 현재 보기를 필터링합니다.
Oleafly의 참고문헌 패널. 참조, 인용, 심볼 사이를 전환하고, 검색 필드로 현재 보기를 필터링합니다. 전체 스크린샷 열기
프로젝트에서 인용은 참고문헌 선택기를 엽니다. 키, 저자, 제목으로 검색하고, 새 인용을 찾아서 추가는 온라인 조회를 엽니다.
프로젝트에서 인용은 참고문헌 선택기를 엽니다. 키, 저자, 제목으로 검색하고, 새 인용을 찾아서 추가는 온라인 조회를 엽니다. 전체 스크린샷 열기

LaTeX 또는 Typst 툴바에서 프로젝트에서 인용(@ 아이콘)을 선택하세요. 현재 참고문헌을 키, 저자, 제목으로 검색하고 항목을 선택합니다.

⌘K 또는 Ctrl+K 명령 팔레트에서 인용 추가를 실행할 수도 있습니다. Oleafly는 현재 프로젝트에 맞는 구문을 삽입합니다.

  • LaTeX에서는 \cite{key}를 삽입합니다.
  • Typst에서는 @key를 삽입하며, 주 문서에 #bibliography(...) 줄이 없으면 문서 끝에 추가합니다.
  • Markdown에서는 [@key]를 삽입하며, 필요하면 프런트 매터에 bibliography: 줄을 추가합니다.

Zotero를 연결해 두면 인용 추가가 Zotero 라이브러리에서 찾은 항목을 먼저 나열합니다.

Zotero를 연결한 뒤에는 @와 함께 저자 이름의 일부, 제목의 단어, 연도, 키를 입력하세요. 프로젝트 자체의 참고문헌 옆에 Zotero 라이브러리 전체가 나타납니다. 논문을 고르면 Oleafly가 문서가 이미 인용하는 방식대로 인용을 삽입합니다. LaTeX에서는 문서에서 가장 많이 쓰는 \citep나 \parencite 같은 명령이, Typst에서는 @key가, Markdown에서는 [@key]가 들어갑니다. 이미 있는 \cite{...} 안에서 @를 입력하면 그 안에 키가 하나 더 추가됩니다.

그 항목 하나만 프로젝트의 .bib 파일 끝에 추가되며, 파일의 나머지는 그대로 유지됩니다. 키나 DOI로 이미 .bib에 있는 논문은 두 번 추가되지 않습니다. 항목에는 내 컴퓨터에 있는 PDF의 경로가 절대 포함되지 않습니다. 프로젝트에 참고문헌 줄이 아직 없으면 Oleafly가 추가합니다. LaTeX에서는 \bibliography 또는 \addbibresource, Typst에서는 #bibliography, Markdown에서는 프런트 매터의 bibliography:입니다. .bib 파일이 여러 개이면 새 참고문헌을 넣을 파일을 Oleafly가 한 번 묻고 그 답을 기억합니다.

thebibliography 환경에서 참고문헌을 직접 나열한 LaTeX 논문에서 처음 Zotero로 인용하면, Oleafly가 그 목록을 .bib로 옮기자고 제안합니다. 그러면 모든 참고문헌이 하나의 번호 목록을 함께 씁니다.

인용된 키가 .bib에는 없지만 Zotero에 있으면 Zotero에서 추가가 표시됩니다. ⌘K 팔레트에서 Zotero에서 누락된 인용 추가를 실행하면 인용된 모든 키를 한 번에 확인합니다. Zotero에 있는 항목은 추가하고, 없는 항목은 나열하며, 이미 내 참고문헌에 있는 논문을 인용하는 키는 알려 줍니다.

Zotero에서 논문이 바뀌면 그 .bib 항목에 Zotero에서 업데이트가 표시됩니다. 팔레트의 Zotero에서 .bib 항목 업데이트는 바뀐 모든 항목을 검토합니다. 직접 편집한 항목은 확인한 뒤에만 교체됩니다. Zotero 라이브러리 동기화는 라이브러리를 다시 읽습니다. Oleafly는 .bib에서 스스로 아무것도 제거하지 않습니다.

논문 제목의 일부를 붙여 넣으면 해당 BibTeX 항목이 refs.bib에 저장됩니다.
논문 제목의 일부를 붙여 넣으면 해당 BibTeX 항목이 refs.bib에 저장됩니다. 전체 스크린샷 열기

선택기에서 새 인용을 찾아서 추가를 선택하세요. 다음 중 무엇으로든 시작할 수 있습니다.

  • 10.1145/3592979 같은 DOI
  • 1706.03762 같은 arXiv ID
  • ISBN-10 또는 ISBN-13
  • PubMed ID(PMID)
  • 위 식별자 중 하나가 들어 있는 URL
  • 논문 제목

DOI, arXiv, ISBN, PubMed 조회는 각각의 공개 카탈로그를 사용합니다. 제목 검색은 저자, 연도, 게재처와 함께 가능한 일치 항목을 보여 주므로, 추측을 그대로 받아들이지 않고 직접 고를 수 있습니다.

반환된 BibTeX를 검토한 다음 .bib에 추가하고 인용을 선택하세요. Oleafly는 다음을 수행합니다.

  1. 현재 참고문헌에 다른 키와 충돌하지 않는 키를 추가합니다.
  2. DOI가 이미 있으면 기존 항목을 재사용합니다.
  3. 현재 커서 위치에 인용을 삽입합니다.
  4. 파일 트리와 참고문헌 패널을 즉시 새로 고칩니다.

메타데이터는 편집할 수 있습니다. 원고의 일부가 되기 전에 기록을 바로잡으세요.

문서에 참고문헌이 여러 개 선언되어 있으면 대화 상자에 참고문헌 메뉴가 표시됩니다. 항목은 고른 파일에 들어가고, Oleafly는 그 선택을 해당 프로젝트에 기억합니다.

Oleafly가 참고문헌을 고르는 방법

섹션 제목: “Oleafly가 참고문헌을 고르는 방법”

LaTeX 프로젝트는 실제로 적용되는 주 문서의 선언을 따릅니다.

  • biblatex에는 \addbibresource{references.bib}
  • BibTeX 워크플로에는 \bibliography{references}

경로는 TeX 툴체인이 기대하는 것과 같은 확장자 및 상대 경로 규칙으로 해석됩니다. 없는 파일을 가리키는 선언은 조용히 다른 곳에 쓰는 대신 해당 소스 줄에서 오류로 보고됩니다.

Typst 프로젝트는 파일 하나를 지정하든 목록을 지정하든, 파일이 BibTeX .bib 파일인지 Hayagriva .yml, .yaml 파일인지와 상관없이 #bibliography(...) 호출을 따릅니다. 새 인용은 문서가 선언한 파일에 들어갑니다. 그 파일이 Hayagriva이면 Oleafly가 BibTeX 항목을 변환한 뒤 씁니다. 호출에 파일이 여러 개 지정되어 있으면 대화 상자의 참고문헌 메뉴에서 대상을 고르세요.

Markdown 프로젝트는 프런트 매터의 bibliography: 필드를 따릅니다.

참고문헌이 선언되어 있지 않으면 Oleafly는 프로젝트의 첫 번째 .bib 파일을 사용합니다. 하나도 없으면 references.bib를 만들어 파일 트리와 인용 선택기에서 쓸 수 있게 합니다.

라이브러리가 여러 개인 프로젝트에서는 항목을 추가하기 전에 선택된 대상을 확인하세요.

Typst 문서에 #bibliography(...) 호출이 있으면, 참고문헌 패널의 인용 보기 하단에 인용 스타일 메뉴가 표시됩니다. 프로젝트의 Typst 버전에서 제공하는 Typst 기본 스타일과 프로젝트의 .csl 파일이 나열됩니다. 스타일을 고르면 그 호출의 style: 인수에 기록됩니다. 스타일이 없으면 Typst는 ieee를 사용합니다.

LaTeX에서는 소스에서 스타일을 지정하세요. \bibliographystyle{는 일반적인 BibTeX 스타일을 자동 완성하고, biblatex에서는 style= 옵션을 사용합니다.

참고문헌 라이브러리 전체 가져오기

섹션 제목: “참고문헌 라이브러리 전체 가져오기”

참고문헌 패널에서 참고문헌 라이브러리 가져오기를 선택하세요. 파일이나 Zotero 라이브러리를 가져올 수 있습니다.

파일에서 가져오려면 내보낸 라이브러리를 선택하세요.

원본 형식파일
BibTeX.bib
RIS.ris
EndNote XML.xml
Zotero RDF.rdf

Zotero에서 가져오려면 설정 → 연동 → Zotero에서 zotero.org 계정을 한 번 연결한 다음 Zotero 카드에서 Zotero 라이브러리 가져오기를 선택하세요. Oleafly는 최대 5,000개 항목을 가져옵니다. 설정 방법은 연구 자료 출처 연결하기에서 안내합니다.

Oleafly는 기록을 BibTeX로 변환하고, DOI가 이미 대상 라이브러리에 있거나 같은 묶음의 앞쪽에 있는 참고문헌은 건너뜁니다. 서로 충돌하지 않는 키를 만들고 결과를 한 번에 덧붙입니다. 메시지에는 추가된 참고문헌 수와 이미 있던 수가 표시됩니다. 라이브러리 가져오기는 커서 위치에 인용을 삽입하지 않습니다.

가져온 뒤에는 인용 선택기에서 새 항목을 검색하고, 일부를 원본 카탈로그와 대조해 확인하세요.

참고문헌 패널은 파일을 바꾸기 전에 정리 결과를 미리 보여 줄 수 있습니다.

  1. 프로젝트를 열고 참고문헌 패널에서 참고문헌 라이브러리 정리를 선택합니다.
  2. 프로젝트에 .bib 파일이 여러 개이면 정리할 파일을 선택합니다.
  3. 작업 목록과 변경 전후의 diff를 읽습니다.
  4. 제안된 키 이름 변경, 제거되는 DOI 중복, 권고 사항을 모두 확인합니다.
  5. 미리보기가 의도와 일치할 때만 적용합니다.

정리 도구는 키 이름을 일관된 저자-연도-제목 패턴으로 바꾸고 프로젝트 소스 파일 전체의 인용을 업데이트합니다. 남기는 항목이 제거되는 항목의 모든 필드를 보존할 때만 DOI 중복을 제거합니다. DOI가 충돌하는 기록과 제목이 비슷한 기록은 짐작으로 병합하지 않고 검토 대상으로 표시합니다.

주석과 BibTeX 문자열 정의는 보존됩니다. 적용할 때는 라이브러리가 여전히 미리보기와 일치하는지 확인하고, 파일을 바꾸기 전에 백업을 씁니다. diff가 크면 미리보기에는 처음 500줄만 표시되지만, 변경 사항을 적용할 때는 파일 전체가 사용됩니다.

\cite{}, \citep{}, \citet{}, \parencite{}, \textcite{} 같은 LaTeX 인용 명령 안에서는 자동 완성이 프로젝트의 모든 .bib 파일을 검색합니다. Typst에서는 @가 .bib 파일과 Hayagriva 파일 모두에서 키를 자동 완성합니다. Zotero를 연결해 두면 목록에 Zotero 라이브러리도 포함됩니다.

그 파일이 열려 있지 않은 동안, 예를 들어 어시스턴트나 Zotero에 의해 .bib에 추가된 항목에 대한 인용은 바로 해석됩니다. 먼저 문서에 입력할 필요가 없습니다.

  • F12를 누르거나 수정 키를 누른 채 클릭하면 인용 키에서 해당 항목으로 이동합니다.
  • ⇧F12는 출처가 쓰인 모든 위치를 나열합니다.
  • F2는 소스 파일과 참고문헌 파일 전체에서 키 이름을 바꿉니다.
  • 마우스를 올리면 대상이 표시되며, 해석되지 않거나 모호한 키는 컴파일하기 전에 표시됩니다.

탐색 방식 전체는 코드 인텔리전스에서 설명합니다.

Oleafly가 논문 작성에 도움이 되었다면 명령 팔레트나 참고문헌 패널의 인용 보기 하단에서 이 논문에서 Oleafly 인용하기를 실행하세요. Oleafly는 문서가 선언한 참고문헌에 키가 oleafly인 항목을 BibTeX로, Hayagriva 파일이면 Hayagriva로 추가합니다. 메시지에는 파일 이름과 \cite{oleafly}나 @oleafly 같은 사용할 구문이 표시되며, 옆에 실행 취소가 있습니다. 항목이 이미 있으면 대신 키를 알려 줍니다.

참고문헌 파일이 없는 프로젝트는 그대로 두며, 대화 상자에 복사할 수 있는 항목이 표시됩니다. 같은 항목은 항상 설정 → 도움말 및 정보에 있습니다.

biblatex에서는 컴파일러가 사용할 수 있는 .bbl을 만들지 못했을 때 Oleafly가 짝이 되는 Biber 단계를 다시 실행합니다. 없는 .bib 경로를 포함한 Biber 메시지는 컴파일 로그와 편집기 진단에 표시됩니다.

Biber 자체가 실패하면 컴파일 로그에 이유가 나옵니다. 없는 시스템 라이브러리를 알려 주고, Biber 없이 빌드하는 방법으로 \usepackage[backend=bibtex]{biblatex}를 제안합니다. Fedora에서는 Oleafly의 .rpm이 Biber에 필요한 라이브러리 두 개를 권장 패키지로 포함합니다.

참고문헌이 계속 정의되지 않은 상태라면 다음을 시도하세요.

  1. 참고문헌 선언과 경로를 확인합니다.
  2. 로그를 열어 처음 나오는 Biber 또는 참고문헌 메시지를 찾습니다.
  3. 인용 키가 정확히 한 번만 존재하는지 확인합니다.
  4. .bib 파일을 저장한 뒤 다시 컴파일합니다.

엔진별 복구 방법은 컴파일과 로그와 LaTeX 엔진과 패키지를 참고하세요.

프로젝트를 열지 않고도 참고문헌을 준비할 수 있습니다.

직접 편집과 인용 서식 지정은 내 컴퓨터 안에서 처리됩니다. 식별자와 제목 조회에는 연결이 필요합니다. 오프라인 모드는 이런 조회를 막지만, 기존 참고문헌의 자동 완성과 탐색은 계속 작동합니다.

인용 찾기는 학술 색인을 검색하거나 열려 있는 초안에서 뒷받침이 필요할 수 있는 구절을 찾아냅니다. 논문을 인용하기 전에 읽어 보고, 각 주장이 방법과 결과로 입증되는 범위를 넘지 않게 하세요.

이미지 미리보기

AI 답변을 불러오지 못했습니다

다시 시도하거나 문서를 검색하세요.