2
0
mirror of https://github.com/acepanel/acepanel.github.io.git synced 2026-02-04 12:47:13 +08:00
Files
acepanel.github.io/en/advanced/file.md
2026-01-27 01:26:41 +08:00

207 lines
6.0 KiB
Markdown

# File
The file module provides a powerful graphical file manager. The design philosophy is to restore the Windows Explorer operation experience as much as possible, supporting right-click menus, drag-and-drop upload, keyboard shortcuts, and other features.
## File Manager
![File Manager](/images/file/file-list.png)
## Core Features
### Windows-like Operation Experience
- **Right-click Menu**: Right-click on files or directories to pop up an action menu
- **Drag-and-drop Upload**: Directly drag local files to the browser window to upload
- **Multi-select Operations**: Support Ctrl+click for multi-select, Shift+click for range selection
- **Keyboard Shortcuts**: Common operations have corresponding keyboard shortcuts
### Keyboard Shortcuts
| Shortcut | Function |
|----------|------------|
| `Ctrl+C` | Copy |
| `Ctrl+X` | Cut |
| `Ctrl+V` | Paste |
| `Delete` | Delete |
| `F2` | Rename |
| `Ctrl+A` | Select All |
## Navigation
### Path Navigation
The top displays breadcrumb navigation of the current path. Click to quickly jump to any parent directory.
### Quick Buttons
- **Back**: Return to the previous visited directory
- **Forward**: Go to the next directory
- **Parent Directory**: Return to parent directory
- **Refresh**: Refresh current directory
- **Home Directory**: Return to default directory
## File List
The file list displays the following information:
| Column | Description |
|---------------|---------------------------------------------------------------------------|
| Name | File or directory name |
| Size | File size, directories show "Calculate" which can be clicked to calculate |
| Permissions | File permissions (e.g., 0755) |
| Owner/Group | File owner and group |
| Modified Time | Last modified time |
| Actions | Open, compress, rename, delete, more |
### Select Files
![Select Files](/images/file/file-select.png)
After selecting files, batch operation buttons appear at the top:
- **Copy**: Copy selected files
- **Move**: Move selected files
- **Compress**: Compress selected files
- **Permissions**: Modify permissions
- **Delete**: Delete selected files
### More Actions
Click the **More** button on the file row to display more action options:
![More Actions](/images/file/file-context-menu.png)
- **Copy**: Copy file to another directory
- **Move**: Move file to another directory
- **Permissions**: Modify file permissions and owner
- **Compress**: Compress file
- **Copy Path**: Copy the full path of the file
- **Properties**: View detailed file properties
## Toolbar
### New
Click the **New** button to:
- Create new file
- Create new directory
### Upload
Click the **Upload** button to upload local files to the server.
Supported upload methods:
- Click to select files for upload
- **Drag-and-drop Upload**: Directly drag files to the page to upload
### Remote Download
Click the **Remote Download** button, enter a URL address to download remote files to the current directory.
Use cases:
- Download software installation packages
- Download remote backup files
- Get files from other servers
### Search
Enter keywords in the search box to search for files:
- Default searches current directory
- Check **Include Subdirectories** to search recursively
### Terminal
Click the **Terminal** button to open a terminal in the current directory for convenient command line operations.
### Sort
Click the **Sort** button to sort the file list by different fields.
## File Editor
AcePanel has a built-in powerful code editor based on Monaco Editor (the same editor core as VS Code).
![File Editor](/images/file/file-editor.png)
### Editor Features
- **Syntax Highlighting**: Supports syntax highlighting for various programming languages
- **Code Folding**: Supports code block folding
- **Line Numbers**: Displays line numbers for easy positioning
- **Minimap**: Displays code thumbnail on the right side
- **Word Wrap**: Can toggle word wrap mode
- **Multi-file Editing**: Supports opening multiple files simultaneously with tab switching
### Editor Shortcuts
| Shortcut | Function |
|----------------|-------------------|
| `Ctrl+S` | Save current file |
| `Ctrl+Shift+S` | Save all files |
| `Ctrl+F` | Search |
| `Ctrl+H` | Replace |
| `Ctrl+G` | Go to line |
### Editor Toolbar
- **Save**: Save current file
- **Save All**: Save all modified files
- **Refresh**: Reload file content
- **Search**: Open search panel
- **Replace**: Open replace panel
- **Go to**: Jump to specified line
- **Font Size**: Adjust editor font size
- **Toggle Word Wrap**: Enable/disable word wrap
- **Toggle Minimap**: Show/hide right-side minimap
- **Settings**: Editor settings
### Fullscreen Mode
Click the **Maximize** button for fullscreen editing to get more editing space:
![Fullscreen Editor](/images/file/file-editor-fullscreen.png)
### Sidebar File Tree
The left side of the editor displays the file tree of the current directory, allowing you to:
- Quickly switch to edit other files
- Create new files
- Search files
### Status Bar
The editor bottom status bar displays:
- Full file path
- Line ending type (LF/CRLF)
- Cursor position (line, column)
- Indentation settings (spaces/Tab)
- File language type
## Permission Explanation
Linux file permissions are represented by three groups of numbers:
| Permission | Number | Description |
|------------|--------|-------------|
| r | 4 | Read |
| w | 2 | Write |
| x | 1 | Execute |
For example `0755`:
- Owner: 7 (4+2+1) = read+write+execute
- Group: 5 (4+1) = read+execute
- Others: 5 (4+1) = read+execute
Common permissions:
- `0644`: Regular files
- `0755`: Executable files and directories
- `0600`: Private files (such as keys)