# Bắt đầu một dự án mới

Chọn một không gian làm việc nghiên cứu, nhập một bản thảo sẵn có, hoặc bắt đầu với một mẫu.

Nhấp **New project** trong thanh dock không gian làm việc. Chọn cách bạn muốn bắt đầu: tổ chức một nghiên cứu, đưa vào công việc sẵn có, hoặc khởi đầu từ một bố cục đã chuẩn bị.

![Hộp thoại New project với Research project, Import a project và Use a template.](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

| Điểm khởi đầu | Chọn khi | Điều gì xảy ra tiếp theo |
|---|---|---|
| **Research project** | Bạn muốn một bản thảo có chỗ cho nguồn tài liệu, phân tích và ghi chú đánh giá | Chọn ngôn ngữ và study starter, rồi kiểm tra các tệp được đề xuất |
| **Import a project** | Bạn đã có một bản lưu trữ, bản nháp hoặc kho chứa | Chọn nguồn nhập và tạo một dự án cục bộ |
| **Use a template** | Bạn đã biết bố cục tài liệu mình cần | Duyệt và xem trước một mẫu, hoặc tạo mẫu bằng AI |

## Research project

Luồng này tạo một thư mục nghiên cứu làm việc quanh bản thảo của bạn. Nó cung cấp nơi để bạn giữ các bằng chứng và công việc đánh giá thuộc về bài báo.

### Project name

Nhập một tên mô tả. Phần xem trước cập nhật khi bạn gõ để bạn thấy tiêu đề và các tệp được đề xuất trước khi tạo bất cứ thứ gì.

### Document engine

Chọn **LaTeX**, **Typst** hoặc **Markdown**. Lựa chọn này quyết định tệp mã nguồn chính và các công cụ soạn thảo. Đọc [Chọn công cụ tài liệu](/docs/engines/) nếu bạn bắt đầu với một định dạng mới.

### Study starter

Chọn starter phù hợp với công việc. Một **Article** khởi đầu với cấu trúc của một bài nghiên cứu, gồm tóm tắt và các phần cho dẫn nhập, phương pháp, kết quả, thảo luận và kết luận. Hãy xem mô tả của starter và phần xem trước tệp trước khi tiếp tục.

### First research task

Đọc nhiệm vụ hiển thị bên dưới starter. Với một Article, nhiệm vụ này đóng khung câu hỏi nghiên cứu và dàn ý bài viết. Nhiệm vụ cung cấp điểm khởi đầu cho công việc của bạn; việc tạo dự án không tự tạo ra kết quả nghiên cứu giúp bạn.

### Project preview

Chọn các tệp trong cây xem trước để kiểm tra nội dung của chúng. Một Article gồm bản thảo và các thư mục cho phân tích, hình, ghi chú nghiên cứu, nguồn tài liệu và ghi chú đánh giá. Nhãn **Main document** chỉ ra tệp dùng để biên dịch bài báo.

![Thiết lập Research project hiển thị một starter LaTeX Article và các tệp nó sẽ tạo.](https://cdn.oleafly.com/images/screenshots/desktop/docs/research-project-dark-window-v2.png)

### Create and open project

Khi phần xem trước đã ưng ý, chọn **Create and open project**. Dự án mới của bạn mở trong không gian làm việc soạn thảo. Hãy bắt đầu với [hướng dẫn không gian làm việc nghiên cứu](/docs/research-workspace/) để kết nối nguồn tài liệu và tổ chức các nhiệm vụ.

### Cancel

Đóng hộp thoại hoặc chọn **Cancel** để rời đi mà không tạo dự án.

## Import a project

Chọn luồng này để tiếp tục công việc bạn đã có. Hộp thoại cung cấp tệp ZIP dự án, tài liệu Word, tài liệu Markdown, trang HTML, tài liệu Typst, bài báo arXiv hoặc kho GitHub. Oleafly tạo một dự án cục bộ từ nguồn đã chọn.

Dùng ZIP cho một dự án sẵn có với nhiều tệp mã nguồn và hình. Việc nhập Word, Markdown, HTML và Typst chuyển đổi tài liệu sang định dạng khác, vì vậy hãy kiểm tra bản thảo sau chuyển đổi và biên dịch nó trước khi tiếp tục. Để viết Markdown nguyên bản, hãy tạo một dự án Markdown và đưa mã nguồn cùng tài sản của bạn vào đó.

[Làm theo các bước nhập cho từng định dạng →](/docs/import-project/)

## Use a template

Mở bộ sưu tập, tìm kiếm hoặc lọc theo loại tài liệu bạn cần, rồi kiểm tra phần xem trước. Mẫu có thể cung cấp bố cục cho bài báo, luận văn, báo cáo, CV, thư, poster, bài thuyết trình hoặc một hình đơn lẻ, bằng LaTeX, Typst hoặc Markdown. Một điểm khởi đầu trắng hữu ích khi bạn đã có mã nguồn để dán vào.

Bước thứ hai hỏi tên dự án và màu bìa. Nếu bạn không chọn màu, Oleafly chọn ngẫu nhiên một màu từ bảng màu, nhờ đó các dự án mới dễ phân biệt hơn trên kệ.

Một số mẫu tải xuống một gói hoặc phông chữ khi dùng lần đầu. Hãy chuẩn bị các bản tải xuống đó khi đang trực tuyến nếu bạn định làm việc ngoại tuyến.

[Duyệt, xem trước và tạo từ mẫu →](/docs/templates/)

### Tạo mẫu bằng AI

Chọn **Generate a template** trong bộ sưu tập khi bạn muốn mô tả bố cục khởi đầu của riêng mình. Cung cấp cho trợ lý loại tài liệu, các phần cần thiết, khổ giấy và tùy chọn định dạng. Xem trước kết quả, tinh chỉnh nó và lưu mẫu để dùng lại.

[Tạo và dùng lại mẫu AI →](/docs/templates/ai-templates/)

## Lần commit Git đầu tiên

Một dự án mà Oleafly tạo hoặc nhập khởi đầu với một Git commit gồm các tệp của nó, gọi là **Create project**. Khi đó phần quản lý mã nguồn hiển thị khác biệt thực từ lần chỉnh sửa đầu tiên của bạn, và [nhiệm vụ nghiên cứu](/docs/research-tasks/) có một phiên bản để so sánh. Git hook và ký commit không bao giờ chạy cho commit này, nên một thiết lập Git toàn cục không thể chặn hoặc gián đoạn việc tạo dự án. Sau đó, Oleafly chỉ commit khi bạn yêu cầu.

Oleafly vẫn tạo kho chứa nhưng bỏ qua commit này khi:

- các tệp của dự án cộng lại vượt 100 MB, để một tập dữ liệu nhập vào không tự mình bị chép vào lịch sử Git;
- dự án chứa các tệp thường giữ mật khẩu hoặc khóa, chẳng hạn `.env`, `*.pem`, khóa riêng SSH hoặc `credentials.json`. Một khi đã commit, bí mật sẽ ở lại trong lịch sử ngay cả sau khi bạn xóa tệp.

Các mẫu như `.env.example`, khóa công khai kết thúc bằng `.pub` và bài thuyết trình Keynote `.key` không bị coi là bí mật. Khi commit bị bỏ qua, lý do được ghi vào nhật ký ứng dụng, và bạn có thể tự thực hiện commit đầu tiên từ [Git và quản lý mã nguồn](/docs/git-history/).

Không có kho chứa nào được tạo khi Git chưa được cài, khi dự án đã có sẵn một kho, hoặc khi **Initialise Git for every project** đang tắt trong **Settings → Integrations → GitHub**.