m1ngsama/TUT
1
0
Fork 0
mirror of https://github.com/m1ngsama/TUT.git synced 2026-02-08 00:54:05 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
TUT/KEYBOARD.md
m1ngsama 03422136dd feat: Add complete persistent bookmark system 
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! 📚✅
2026-01-01 14:08:42 +08:00

3.3 KiB
Raw Blame History

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

./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

./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

# 1. Press 'o' to open address bar
# 2. Type new URL
# 3. Press 'Enter' to navigate
# 4. Press 'Esc' to cancel

In-Page Search

# 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