53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
|
# 03 — Adding and editing files
|
||
|
|
|
||
|
|
🌍 **English** · [Türkçe](../../tr/03-add-and-edit-files/readme.md) · [Deutsch](../../de/03-add-and-edit-files/readme.md) · [Français](../../fr/03-add-and-edit-files/readme.md) · [Русский](../../ru/03-add-and-edit-files/readme.md)
|
||
|
|
|
||
|
|
Everything in this chapter happens in the browser. No tools to install.
|
||
|
|
|
||
|
|
## Add File menu
|
||
|
|
|
||
|
|
Open a repository (or any folder inside it) and press **Add File**:
|
||
|
|
|
||
|
|
| Item | Use it for |
|
||
|
|
|------|-----------|
|
||
|
|
| **New File** | Writing a file by hand — notes, code, `readme.md` |
|
||
|
|
| **New Directory** | Creating an empty folder (chapter 04) |
|
||
|
|
| **Upload File** | Bringing files from your computer — images, PDFs, archives |
|
||
|
|
| **Patch** | Applying a ready-made diff |
|
||
|
|
|
||
|
|
## Writing a new file
|
||
|
|
|
||
|
|
1. **Add File → New File**.
|
||
|
|
2. Type the file name at the top, for example `notes.md`.
|
||
|
|
Typing `docs/notes.md` creates the `docs` folder at the same time.
|
||
|
|
3. Write the content in the editor.
|
||
|
|
4. Fill in the commit box at the bottom:
|
||
|
|
- **Summary** — short, in the imperative: *add setup notes*.
|
||
|
|
- **Description** — optional detail.
|
||
|
|
5. Choose **Commit directly to `main`**, or *create a new branch* if you want a review first (chapter 09).
|
||
|
|
6. Press **Commit Changes**.
|
||
|
|
|
||
|
|
## Uploading files
|
||
|
|
|
||
|
|
1. **Add File → Upload File**.
|
||
|
|
2. Drag files in, or press the box to pick them.
|
||
|
|
3. To place them in a subfolder, type the folder name in the path field at the top.
|
||
|
|
4. Press **Commit Changes**.
|
||
|
|
|
||
|
|
Very large files (video, disk images) belong in file storage, not in a repository — the history keeps every version forever.
|
||
|
|
|
||
|
|
## Editing an existing file
|
||
|
|
|
||
|
|
1. Open the file.
|
||
|
|
2. Press the pencil ✏️ icon at the top right.
|
||
|
|
3. Change the text; the **Preview changes** tab shows what you altered.
|
||
|
|
4. Commit as above.
|
||
|
|
|
||
|
|
## Renaming and moving
|
||
|
|
|
||
|
|
Editing a file lets you change its path: put the cursor in the name field and type a new path, e.g. `docs/notes.md`. On commit, the file is moved — history is preserved.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
⬅ [Previous: 02 — Creating a repository](../02-create-repository/readme.md) · 📚 [Contents](../README.md) · [Next: 04 — Creating directories](../04-create-directory/readme.md) ➡
|