# 도움말, 진단, 업데이트

앱 버전을 확인하고, 문제를 재현하고, 알맞은 지원 자료를 엽니다.

**설정 → 도움말 및 정보**를 여세요. 이 페이지에는 버전 정보, 프로젝트 링크, 지원, 학습 자료가 모여 있습니다.

![설정 → 도움말 및 정보. 업데이트와 정보 복사는 위쪽에, 둘러보기, 문서, 충돌 보고는 아래쪽에 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-help-dark-window-v2.png#view=519,89,883,902)

## 앱 버전

Oleafly 옆에 표시된 버전을 읽어 보세요. 다른 사람이 같은 빌드를 테스트할 수 있도록 문제를 신고할 때 버전을 포함하세요. **업데이트 확인**은 버전 아래에 있으며, 그다음에 일어나는 일은 [앱 업데이트](/docs/updates/)에서 설명합니다.

## 정보 복사

**정보 복사**를 선택하면 앱 버전, 그리고 가능한 경우 플랫폼, 아키텍처, OS 버전이 복사됩니다. 문제를 재현하는 단계와 함께 이슈에 붙여 넣으세요.

## 새로운 기능

정보 복사 옆이나 자료 목록에 있는 **새로운 기능**을 선택하면 Oleafly 안에서 릴리스 노트를 읽을 수 있습니다. 머리글에는 현재 사용 중인 버전과 업데이트 가능 여부가 표시됩니다.

가장 최신 릴리스는 열린 채로 시작하며, 현재 버전보다 새로운 릴리스도 마찬가지입니다. 이전 릴리스는 닫힌 채로 시작하니, 클릭해서 노트를 읽으세요. 가장 최신 릴리스에서는 긴 섹션도 접혀서 "변경 사항 18개"처럼 개수가 표시됩니다. 열면 모두 읽을 수 있습니다.

[제품 하이라이트](/docs/changelog/)는 기능을 해당 가이드로 연결합니다.

## 커뮤니티

**Discord**를 선택하면 Oleafly 커뮤니티 서버에 참여할 수 있습니다. 질문, 버그 신고, 기능 아이디어, 일상적인 대화가 모두 여기서 이루어지며, 다른 연구자들과 앱을 만드는 사람들이 함께합니다. 무료이며 Discord 계정만 있으면 됩니다.

Discord 행에는 접속 중인 멤버 수가 표시됩니다. Oleafly는 도움말 및 정보나 정보 창이 열려 있는 동안에만 Discord에 이 숫자를 요청합니다. 이 요청에는 계정, 프로젝트, 사용 정보가 담기지 않으며 오프라인 모드에서는 요청하지 않습니다.

릴리스와 개발 소식을 팔로우하려면 X 로고가 있는 행인 **Oleafly**를 선택하세요.

## 프로젝트 후원

**GitHub에서 스타 주고 둘러보기**는 프로젝트 저장소를 열고 스타와 포크 수를 보여 줍니다. GitHub 스타는 다른 연구자들이 앱을 발견하는 데 도움이 됩니다.

## 둘러보기 시작

**둘러보기 시작**을 선택하면 설정이 닫히고 해당하는 안내가 시작됩니다. 라이브러리에서는 홈 둘러보기, 프로젝트에서는 작업 공간 둘러보기입니다.

## 문서

**문서**를 선택하면 이 제품 가이드가 열립니다. 사용 중인 컨트롤이나 워크플로의 가이드부터 시작하세요.

## 학습

**학습**을 선택하면 LaTeX 레슨이 열립니다. 레슨은 문서 언어를 설명하고, 제품 문서는 Oleafly에서 그 도구를 어디서 찾는지 설명합니다.

## 충돌 신고

**충돌 신고(로그 첨부)** 항목을 선택하면 충돌 보고서를 시작합니다. 제출하기 전에 보고서와 첨부 파일을 검토하세요. 무엇을 클릭했는지, 무슨 일이 일어났는지, 무엇을 기대했는지, 빈 프로젝트에서도 문제가 반복되는지를 포함하세요.

## 라이선스

**라이선스**를 선택하면 데스크톱 애플리케이션의 약관을 읽을 수 있습니다.

## 논문에서 Oleafly 인용하기

**논문에서 Oleafly 인용하기** 카드는 페이지의 맨 마지막에 있습니다. 사용 중인 버전에 대한 BibTeX 항목이 바로 복사할 수 있게 들어 있습니다. **BibTeX 복사**를 선택하고, 프로젝트의 참고문헌에 붙여 넣은 다음, 키 `oleafly`를 인용하세요.

프로젝트를 연 상태에서는 명령 팔레트나 참고문헌 패널 맨 아래에서 **이 논문에서 Oleafly 인용하기**를 실행할 수도 있습니다. Oleafly는 문서가 선언한 참고문헌에 항목을 추가하고 어떤 인용 구문을 쓸지 알려 줍니다. 참고문헌이 Hayagriva `.yml` 파일인 Typst 프로젝트에서는 항목이 Hayagriva 형식으로 기록됩니다. 참고문헌이 없으면 Oleafly는 프로젝트 파일을 바꾸지 않고 항목만 보여 줍니다. [인용과 참고문헌](/docs/citations/#cite-oleafly)을 참고하세요.

제출하기 전에 해당 학회나 저널의 인용 안내를 확인하세요. 카드 아래의 링크는 GitHub의 저장소를 열며, 거기서 **Cite this repository**를 쓰면 같은 참고문헌을 APA 형식으로 얻을 수 있습니다.

## 사이드바 맨 아래의 버튼

설정 사이드바 맨 아래에는 어느 섹션을 열어 두었든 아이콘 버튼 다섯 개가 있습니다. 이름을 보려면 버튼 위에 마우스를 올리세요.

| 아이콘 | 이름 | 여는 대상 |
| --- | --- | --- |
| Discord 로고 | **Discord 커뮤니티 참여하기** | Oleafly Discord 서버 |
| X 로고 | **X에서 팔로우하기** | X의 Oleafly |
| GitHub 로고 | **소스 코드 보기** | GitHub의 소스 코드 |
| 물음표 | **문서** | 이 문서 |
| 두루마리 | **릴리스 노트 보기** | Oleafly 안의 새로운 기능 |

## 쓸모 있는 보고서 작성하기

1. 앱 정보를 복사합니다.
2. 문제를 보여 주는 가장 작은 문서로 문제를 재현합니다. 컴파일 문제에는 스크린샷만 있는 것보다 작은 예제 파일이 더 유용합니다. 공유하기 전에 관련 없는 원고 내용을 제거하세요.
3. 엔진과 배치를 포함해 동작을 순서대로 나열합니다.
4. 처음 나타나는 관련 컴파일 오류나 실패한 컨트롤의 스크린샷을 포함합니다.
5. 앱을 다시 시작하면 결과가 달라지는지 적습니다.

빌드 실패는 [컴파일과 로그](/docs/compiling/)부터 시작하세요. AI 도구가 보이지 않는다면 [모델 제공자](/docs/ai-setup/)에서 모델의 연결과 기능 상태를 확인하세요.