
## 📺 PR Description
<!-- summary of the change + which issue is fixed if applicable. -->
Currently the links on the docs homepage are broken, because when we run
the website locally it uses [just a slash as the `prefix`/`baseUrl`, but
when run as a production build it uses `/television` as the
`baseUrl`](1d6b996c83/website/docusaurus.config.ts (L21)
).
So I added a hook that will take the `baseUrl` and append it to the link
you provide. This hook should be used for any relative link that we add
to the app in React (`.tsx`) files.
## Checklist
<!-- a quick pass through the following items to make sure you haven't
forgotten anything -->
- [x] my commits **and PR title** follow the [conventional
commits](https://www.conventionalcommits.org/en/v1.0.0/#summary) format
- [ ] if this is a new feature, I have added tests to consolidate the
feature and prevent regressions
- [ ] if this is a bug fix, I have added a test that reproduces the bug
(if applicable)
- [ ] I have added a reasonable amount of documentation to the code
where appropriate
About
Television
is a cross-platform, fast and extensible fuzzy finder for the terminal.
It integrates with your shell and lets you quickly search through any kind of data source (files, git repositories, environment variables, docker images, you name it) using a fuzzy matching algorithm and is designed to be extensible.
It is inspired by the neovim telescope plugin and leverages tokio and the nucleo matcher used by the helix editor to ensure optimal performance.
Installation
See installation docs.
TL;DR
Create a channel: ~/.config/television/cable/files.toml
[metadata]
name = "files"
description = "A channel to select files and directories"
requirements = ["fd", "bat"]
[source]
command = "fd -t f"
[preview]
command = "bat -n --color=always '{}'"
env = { BAT_THEME = "Catppuccin Mocha" }
[ui]
preview_panel = { "size" = 70, "scrollbar" = true }
[keybindings]
shortcut = "f1"
Start searching:
tv files
Switch channels using the remote control and pick from a list of community-maintained channels which
you can install with tv update-channels
:
See the channels docs for more info on how to set these up.
Usage
tv # default channel
tv [channel] # e.g. `tv files`, `tv env`, `tv git-repos`, etc.
# pipe the output of your program into tv
my_program | tv
fd -t f . | tv --preview 'bat -n --color=always {}'
# or build your own channel on the fly
tv --source-command 'fd -t f .' --preview-command 'bat -n --color=always {}' --preview-size 70
Tip
🐚 Television has builtin shell integration. More info here.
Credits
This project was inspired by the awesome work done by the telescope neovim plugin.
It also leverages the great helix editor's nucleo fuzzy matching library, the tokio async runtime as well as the formidable ratatui library.