davsclaus opened a new pull request, #27665:
URL: https://github.com/apache/camel/pull/27665

   The **F2 → Tape Recording Guide** in the actions menu repeated the recording 
docs in its own words, and it had already drifted: it still described the tape 
as replayed by TamboUI. It now keeps only the three steps and links to the 
online page with the tape commands, so there is one place to keep up to date.
   
   - `DocViewerPopup.tapeInstructions()`: the steps are record (F2), play with 
`camel tui <name> --record=<file>.tape`, and convert with `agg`. Then it links 
to https://camel.apache.org/manual/camel-jbang-tui-recording.html with the 
address in plain sight, for terminals that don't open links.
   - The commands are fenced code blocks outside the numbered list. Indented 
code inside a list item doesn't render in the markdown viewer, which the new 
test caught.
   
   Depends on #27664, which adds the `camel-jbang-tui-recording.adoc` page the 
link points to.
   
   ## How it looks
   
   Screenshot taken with the tape player itself (`Action "Tape Recording 
Guide"` + `Screenshot`, `--theme=nord`), plain-text export:
   
   ```
   ╭ Tape Recording Guide 
──────────────────────────────────────────────────────────────────────────────────────╮
   │Tape Recording Guide                                                        
                                │
   
│═══════════════════════════════════════════════════════════════════════════════════════════════════════════
 │
   │                                                                            
                                │
   │Record a session as a .tape file and turn it into an animated GIF.          
                                │
   │                                                                            
                                │
   │1. Use F2 → Start Tape Recording, show what you want, then F2 → Stop Tape 
Recording. The tape is saved in   │
   │the current directory as camel-tui-tape-<timestamp>.tape.                   
                                │
   │                                                                            
                                │
   │2. Play the tape in the TUI and record it to an Asciinema .cast file next 
to the tape:                      │
   │                                                                            
                                │
   
│╭─────────────────────────────────────────────────────────────────────────────────────────────────────────╮
 │
   ││camel tui <name> --record=<file>.tape --record-size=120x32                 
                              │ │
   
│╰─────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 │
   │                                                                            
                                │
   │3. Convert the recording to a GIF with agg 
(https://github.com/asciinema/agg):                              │
   │                                                                            
                                │
   
│╭─────────────────────────────────────────────────────────────────────────────────────────────────────────╮
 │
   ││agg <file>.cast demo.gif                                                   
                              │ │
   
│╰─────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 │
   │                                                                            
                                │
   │A tape can also be written by hand or by an AI agent, with commands for 
captions, highlights, tabs and      │
   │themes. The tape commands, an example tape and tips are in the Camel 
documentation, Screenshots and Demo    │
   │Recordings:                                                                 
                                │
   │                                                                            
                                │
   │https://camel.apache.org/manual/camel-jbang-tui-recording.html              
                                │
   │                                                                            
                                │
   │                                                                            
                                │
   │                                                                            
                                │
   ```
   
   ## Testing
   
   - New `DocViewerPopupTapeInstructionsTest` renders the guide with 
`MarkdownView` and checks that the commands and the docs address show on screen 
and that the address is a link.
   - The whole `camel-jbang-plugin-tui` module passes (1901 tests).
   
   _Claude Code on behalf of davsclaus_
   
   🤖 Generated with [Claude Code](https://claude.com/claude-code)
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to