|
| 1 | +--- |
| 2 | +title: Customizing the Editor |
| 3 | +draft: true |
| 4 | +--- |
| 5 | + |
| 6 | +> **DRAFT — outline only.** Bullet points below capture what each subsection will cover. Convert to prose + screenshots/videos in a later pass. Remove this banner and the `draft: true` frontmatter when ready to publish. |
| 7 | +
|
| 8 | +This section covers everything that lets you make **Phoenix Code** look and feel the way you want — from full themes down to individual visual toggles. |
| 9 | + |
| 10 | +--- |
| 11 | + |
| 12 | +## Themes |
| 13 | +*(Move existing content from `08-Features/13-themes.md`. Update with new themes shipped this release.)* |
| 14 | + |
| 15 | +- What themes are and how they affect the editor |
| 16 | +- Built-in themes — list with screenshots |
| 17 | + - **Phoenix Dark Neo** (renamed from previous "Phoenix Dark") |
| 18 | + - **Phoenix Light Neo** (renamed from previous "Phoenix Light") |
| 19 | + - **Dark Phoenix** (NEW this release) |
| 20 | + - All other built-in themes — list and short description |
| 21 | +- Switching themes |
| 22 | + - Via Extension Manager → Themes tab → Apply |
| 23 | + - Via `View` menu (if applicable) |
| 24 | +- Installing a new theme from the marketplace |
| 25 | +- Removing an installed theme |
| 26 | +- Creating your own theme — link to Theme Template repo |
| 27 | +- Preference key reference (where applicable) |
| 28 | + |
| 29 | +--- |
| 30 | + |
| 31 | +## Zoom UI and Font Size |
| 32 | +*(Move existing content from `03-editing-text.md` → "Zoom and Font Size Adjustments".)* |
| 33 | + |
| 34 | +- What zoom does vs. font size adjustment (UI scale vs. editor text only) |
| 35 | +- Zoom UI: In / Out / current level shown in menu |
| 36 | +- Font Size: Increase / Decrease / Restore |
| 37 | +- **HUD zoom percentage overlay** (NEW) — appears briefly on zoom in/out |
| 38 | +- Using the menu (`View > Zoom UI and Fonts`) |
| 39 | +- Keyboard shortcuts table |
| 40 | + |
| 41 | +--- |
| 42 | + |
| 43 | +## Line Height |
| 44 | +*(Move existing content from `03-editing-text.md`.)* |
| 45 | + |
| 46 | +- What it does — vertical spacing between lines |
| 47 | +- Adjusting via `View > Themes...` → Line Height slider (1 to 3, default 1.5) |
| 48 | +- Modifying via preferences — `themes.editorLineHeight` |
| 49 | +- Cross-link to new Preferences page |
| 50 | + |
| 51 | +--- |
| 52 | + |
| 53 | +## Indent Guide Lines |
| 54 | +*(Move existing content from `03-editing-text.md`.)* |
| 55 | + |
| 56 | +- What they are — vertical lines showing indentation levels |
| 57 | +- Enabling / disabling via `View > Indent Guide Lines` |
| 58 | +- Preference keys |
| 59 | + - `editor.indentGuides` — on/off |
| 60 | + - `editor.indentHideFirst` — hide the first guide line |
| 61 | +- Cross-link to new Preferences page |
| 62 | + |
| 63 | +--- |
| 64 | + |
| 65 | +## Editor Rulers |
| 66 | +*(Move existing content from `08-Features/03-editor-rulers.md`.)* |
| 67 | + |
| 68 | +- What rulers are — vertical guides at column positions |
| 69 | +- How to configure (preferences / settings) |
| 70 | +- Common use cases (80-col / 120-col line length guidance) |
| 71 | + |
| 72 | +--- |
| 73 | + |
| 74 | +## Sidebar Collapse Toggle (NEW) |
| 75 | +*(NEW feature — titlebar control shipped this release.)* |
| 76 | + |
| 77 | +- What it does — collapses/expands the main sidebar from the titlebar |
| 78 | +- Where the toggle button lives (titlebar, near app menu) |
| 79 | +- Keyboard shortcut (if any) |
| 80 | +- Difference from drag-to-collapse the sidebar resizer |
| 81 | + |
| 82 | +--- |
| 83 | + |
| 84 | +## Tabbed Sidebar (NEW) |
| 85 | +*(NEW feature shipped this release — main sidebar now supports tabs.)* |
| 86 | + |
| 87 | +- What it is — multiple panels accessible as tabs in the main sidebar |
| 88 | +- What tabs ship by default (Files, Git, Extensions, etc.) |
| 89 | +- Switching between tabs |
| 90 | +- Adding / removing / reordering tabs (if user-controllable) |
| 91 | + |
| 92 | +--- |
| 93 | + |
| 94 | +## No-Distractions Mode |
| 95 | +*(Move existing content from `03-editing-text.md`.)* |
| 96 | + |
| 97 | +- What it does — hides non-essential UI for focused editing |
| 98 | +- Toggle via `View > No-Distractions Mode` |
| 99 | +- Keyboard: `Shift + F11` |
| 100 | +- What gets hidden vs. what stays |
| 101 | +- (Note: Design Mode also affects UI visibility — link out to Design Mode docs once they exist) |
| 102 | + |
| 103 | +--- |
| 104 | + |
| 105 | +## Where to next |
| 106 | +- For changing what your code *says*, see [Editing Text](./editing-text) |
| 107 | +- For syntax colors, see [Editing Colors](./editing-colors) |
| 108 | +- For low-level configuration of all settings, see Preferences *(link once page exists)* |
0 commit comments