Chapter 3 — Projects
Chapter 3 — Projects
wxeditor organizes work around “projects”: a project is simply a directory (local or remote). Once bound, the file tree is rooted at that directory, and history, search, and the version panel all operate on it.
3.1 Opening a Project
Three ways:
- Welcome screen: click the “Open Project” card and pick a directory in the system folder picker.
- File menu: “File (F) → Open Project”.
- Command line:
wxeditor -file /path/to/file.py— the file’s directory is bound as the project automatically.
3.2 Creating a Project
On the welcome screen, click the “New Project” card and, in the dialog:
- Enter a project name (path separators are not allowed).
- Enter or browse to the parent directory.
- Click “Create” — if the target already exists, the dialog offers “Open Directly” instead of overwriting.
3.3 Recent Projects
Every successfully opened project is recorded in
~/.wxeditor/history.json (up to 20 entries). Recent projects appear in
two places:
- The welcome screen “Recent Projects” popover (see Chapter 1).
- The “File (F) → Recent Projects” submenu.
Entries show the project name, relative time (just now / N minutes ago / N hours ago / yesterday), and the path. Entries whose directory is gone are dimmed and removed from history when clicked.
3.4 File Tree
The panel header reads “Project Resources”; below it is a row of tool buttons (open directory, refresh, new file/folder, show hidden files, etc.). In the tree:
- Directories (with expand arrows): single-click expands/collapses; double-click enters.
- Files: double-click opens in the editor; single-click selects.
- Files show type-specific colored icons.
- The context menu offers: Copy Path, Copy Relative Path, Copy, Cut, Paste, Rename, Delete, Properties, and more.
Drag the splitter between the tree and the editor to resize the panel; “View (V) → Show File Tree” (Ctrl+B) or clicking the mode bar’s Local button again collapses it.
3.5 Tabs
Each opened file gets a tab:
- Unsaved tabs show a dot/asterisk marker; closing prompts for confirmation (Save / Don’t Save / Cancel).
- The tab context menu: Close, Close Others, Close to the Right, Close Saved, Close All, Copy Path, Copy Relative Path.
