mirror of
https://github.com/m1ngsama/TUT.git
synced 2026-02-08 09:04:04 +00:00
m1ngsama
03422136dd
Completed Phase 1 high priority task - comprehensive bookmark management:
BookmarkManager (New):
- JSON persistence to ~/.config/tut/bookmarks.json
- Add, remove, contains, getAll operations
- Automatic sorting by timestamp (newest first)
- Each bookmark stores: title, URL, timestamp
- Handles special characters with JSON escaping
- Auto-creates config directory if needed
UI Integration:
- Bookmark panel in bottom-left of UI
- Shows up to 5 most recent bookmarks
- Displays "[1] Title" format with yellow highlighting
- Shows "+N more..." indicator if >5 bookmarks
- Real-time update when bookmarks change
Keyboard Shortcuts:
- Ctrl+D: Toggle bookmark for current page
* Adds if not bookmarked
* Removes if already bookmarked
* Shows status message confirmation
- F2: Toggle bookmark panel visibility
* Refreshes bookmark list when opened
Features:
- Persistent storage across browser sessions
- Duplicate detection (one bookmark per URL)
- Toggle behavior (add/remove with same key)
- Real-time panel updates
- Empty state handling ("(empty)" message)
- Sorted display (newest first)
Technical Implementation:
- BookmarkManager class with Pimpl idiom
- Simple JSON format for easy manual editing
- Event-driven architecture (WindowEvent::AddBookmark)
- Lambda callback for bookmark updates
- Integrated with main browser engine
Storage Format:
[
{"title": "Page Title", "url": "https://...", "timestamp": 1234567890},
...
]
Documentation:
- Updated KEYBOARD.md with bookmark shortcuts
- Updated STATUS.md to reflect completion
- Added bookmark feature to interactive features list
Next Step: History system! 📚✅
133 lines
3.3 KiB
Markdown
133 lines
3.3 KiB
Markdown
# TUT Browser - Keyboard Shortcuts
|
|
|
|
## 🎯 Quick Reference
|
|
|
|
### Navigation
|
|
| Key | Action |
|
|
|-----|--------|
|
|
| `o` | Open address bar (type URL and press Enter) |
|
|
| `Backspace` | Go back |
|
|
| `f` | Go forward |
|
|
| `r` or `F5` | Refresh current page |
|
|
| `q` or `Esc` or `F10` | Quit browser |
|
|
|
|
### Scrolling
|
|
| Key | Action |
|
|
|-----|--------|
|
|
| `j` or `↓` | Scroll down one line |
|
|
| `k` or `↑` | Scroll up one line |
|
|
| `Space` or `PageDown` | Page down |
|
|
| `b` or `PageUp` | Page up |
|
|
| `g` | Go to top |
|
|
| `G` | Go to bottom |
|
|
|
|
### Links
|
|
| Key | Action |
|
|
|-----|--------|
|
|
| `Tab` | Select next link |
|
|
| `Shift+Tab` | Select previous link |
|
|
| `1-9` | Jump to link by number |
|
|
| `Enter` | Follow selected link |
|
|
|
|
## 📝 Usage Examples
|
|
|
|
### Basic Browsing
|
|
```bash
|
|
./build_ftxui/tut https://example.com
|
|
|
|
# 1. Press 'j' or 'k' to scroll
|
|
# 2. Press 'Tab' to cycle through links
|
|
# 3. Press 'Enter' to follow the selected link
|
|
# 4. Press 'Backspace' to go back
|
|
# 5. Press 'q' to quit
|
|
```
|
|
|
|
### Direct Link Navigation
|
|
```bash
|
|
./build_ftxui/tut https://tldp.org/HOWTO/HOWTO-INDEX/howtos.html
|
|
|
|
# See numbered links like [1], [2], [3]...
|
|
# Press '1' to jump to first link
|
|
# Press '2' to jump to second link
|
|
# Press 'Enter' to follow the selected link
|
|
```
|
|
|
|
### Address Bar
|
|
```bash
|
|
# 1. Press 'o' to open address bar
|
|
# 2. Type new URL
|
|
# 3. Press 'Enter' to navigate
|
|
# 4. Press 'Esc' to cancel
|
|
```
|
|
|
|
### In-Page Search
|
|
```bash
|
|
# Search for text on current page
|
|
# 1. Press '/' to open search bar
|
|
# 2. Type your search query (case-insensitive)
|
|
# 3. Press 'Enter' to find all matches
|
|
# 4. Press 'n' to go to next match
|
|
# 5. Press 'N' to go to previous match
|
|
# 6. Matches are highlighted (yellow = current, blue = other matches)
|
|
# 7. Status bar shows "Match X/Y" count
|
|
```
|
|
|
|
## 🎨 UI Elements
|
|
|
|
### Top Bar
|
|
- `[◀]` - Back button (dimmed when can't go back)
|
|
- `[▶]` - Forward button (dimmed when can't go forward)
|
|
- `[⟳]` - Refresh
|
|
- Address bar - Shows current URL
|
|
- `[⚙]` - Settings (not yet implemented)
|
|
- `[?]` - Help (not yet implemented)
|
|
|
|
### Content Area
|
|
- Shows rendered HTML content
|
|
- Displays page title at top
|
|
- Shows scroll position at bottom
|
|
|
|
### Bottom Panels
|
|
- **Bookmarks Panel** - Shows bookmarks (not yet implemented)
|
|
- **Status Panel** - Shows:
|
|
- Load stats (KB downloaded, time, link count)
|
|
- Currently selected link URL
|
|
|
|
### Status Bar
|
|
- Shows function key shortcuts
|
|
- Shows current status message
|
|
|
|
## ⚡ Pro Tips
|
|
|
|
1. **Fast Navigation**: Use number keys (1-9) to instantly jump to links
|
|
2. **Quick Scrolling**: Use `Space` and `b` for fast page scrolling
|
|
3. **Link Preview**: Watch the status bar to see link URLs before following
|
|
4. **Efficient Browsing**: Use `g` to jump to top, `G` to jump to bottom
|
|
5. **Address Bar**: Type `o` quickly to enter a new URL
|
|
|
|
### Search
|
|
| Key | Action |
|
|
|-----|--------|
|
|
| `/` | Start search (type query and press Enter) |
|
|
| `n` | Next search result |
|
|
| `N` | Previous search result |
|
|
| `Esc` | Cancel search |
|
|
|
|
### Bookmarks
|
|
| Key | Action |
|
|
|-----|--------|
|
|
| `Ctrl+D` | Add/remove current page as bookmark |
|
|
| `F2` | Toggle bookmark panel |
|
|
|
|
## 🐛 Known Limitations
|
|
|
|
- Ctrl+L not yet working for address bar (use 'o' instead)
|
|
- No history panel yet (F3)
|
|
- Cannot navigate to bookmarks from panel yet (coming soon)
|
|
|
|
## 🚀 Coming Soon
|
|
|
|
- [ ] Navigate to bookmarks from panel (click/select)
|
|
- [ ] History (view and navigate)
|
|
- [ ] Better link highlighting
|
|
- [ ] Form support
|