Rechercher une page de manuel
canto
Langue: en
Version: 264469 (debian - 07/07/09)
Section: 1 (Commandes utilisateur)
Sommaire
NAME
Canto - An ncurses RSS readerDESCRIPTION
Canto is an RSS reader built to be flexible and highly customizable on top of python.GETTING STARTED
Canto is the client, separate from the fetcher Canto-fetch. In order to update you must invoke canto-fetch on a regular basis. Usually the way to do that is to add a line into your crontab like this:* * * * * canto-fetch
If you're not a fan of cron, then you can add `canto-fetch -b` to your startup scripts to have canto-fetch run as a daemon on its own.
After you have your configuration file generated, just run `canto` and it will update for you, if canto-fetch hasn't been run already.
COMMAND LINE USAGE
- -h/--help
- Simple help
- -v/--version
- Print version
- -u/--update
- Update feeds before launching client.
- -l/--list
- List all configured feeds
- -a/--checkall
- Print number of new items.
- -n/--checknew [feed]
- Print number of new items in feed.
- -o/--opml
- Print feeds to stdout as OPML file.
- -i/--import [path]
- Import feeds from OPML file to your configuration.
- -r/--url [URL]
- Add feed at URL to your configuration.
- -t/--tag [tag]
- Set tag for feed added with -r
- -D/--dir [path]
- Set the configuration directory (default: ~/.canto/)
- -C/--conf [path]
- Set the configuration file (default: ~/.canto/conf)
- -L/--log [path]
- Set the log file (default: ~/.canto/log)
- -F/--fdir [path]
- Set the feed directory (default: ~/.canto/feeds)
- -S /--sdir [PATH]
- Set the path to execurl scripts (default ~/.canto/scripts/)
INTERNAL USAGE
Within the program you can use the following (default) keys. These can be changed in your configuration file by using the "key" configuration option.- UP / DOWN or k / j
- Select previous or next item. (next_item) (prev_item)
- PGUP / PGDOWN or o / l
- Goto previous or next tag. (next_tag) (prev_tag)
- RIGHT / LEFT
- Set item unread or read (just_unread) (just_read)
- [ / ]
- Cycle through defined filters (prev_filter) (next_filter)
- { / }
- Cycle through defined tag filters (prev_feed_filter) (next_feed_filter)
- - / =
- Cycle through defined tag sorts (prev_tag_sort) (next_tag_sort)
- < / >
- Cycle through defined tag sets (prev_tagset) (next_tagset)
- :
- Goto a specific tag (order of the config) (goto_tag)
- ;
- Goto a specific visible tag (goto_reltag)
- TAB
- Switch focus between list and reader (only useful with dedicated reader space)
(switch) - h
- Display this man page. (help)
- Space
- Read a story (reader)
- g
- Use the defined browser to goto the item's URL (goto)
- C / V
- Collapse/Uncollapse all tags (set_collapse_all) (unset_collapse_all)
- c
- Collapse/Uncollapse current tag (toggle_collapse_tag)
- f
- Inline search (inline_search)
- n / p
- Goto next/previous marked item (next_mark) (prev_mark)
- , / .
- Goto next/previous unread item (next_unread) (prev_unread)
- r / u
- Mark tag read/unread (tag_read) (tag_unread)
- R / U
- Mark all read/unread (all_read) (all_unread)
- Ctrl+R
- Refresh feeds (force_update)
- Ctrl+L
- Redraw screen (refresh)
- q
- Quit Canto (quit)
READER USAGE
Inside the reader, there are a number of different keys. These can be changed with the "reader_key" configuration option.- UP / DOWN or k / j
- Scroll up/down if content off screen (scroll_up) (scroll_down)
- n / p
- goto next/previous item without closing reader
- l
- Enumerate links (toggle_show_links)
- g
- Choose a link to goto (goto)
CONFIGURATION
The ~/.canto/conf file is where all of the configuration is. You can start by using the example config below.EXAMPLE CONFIG
from canto.extra import * import os if os.getenv("TERM") == "linux": link_handler("elinks else: link_handler("iceweasel # A dedicated image handler, that requires content # to be fetched for it. image_handler("xli # A dedicated PDF handler (great for LtU) link_handler("evince # If we're in X, update xterm title # (Should work with most graphical terms) select_hook = set_xterm_title end_hook = clear_xterm_title def my_resize_hook(cfg): cfg.columns = cfg.width / 70 resize_hook = my_resize_hook # Global filters, switch with '[' and ']' filters=[None, show_unread] # You can also setup keybinds to set the global filter keys['a'] = set_filter(show_unread) # Similarly you can set tag filters and keybinds # switch with '{' and '}' default_tag_filters([None, show_unread]) keys['b'] = set_tag_filter(show_unread) # Tag sorts can also be set with a keybind keys['s'] = set_tag_sort(by_alpha) keys['d'] = set_tag_sort(reverse_sort(by_len)) # Keys can be single or lists of actions # These keys kill the current reader, go to the next # or prev unread item and start another reader reader_keys["."] = ["destroy","next_unread","reader"] reader_keys[","] = ["destroy","prev_unread","reader"] # This sets the current item as read and automatically # continues to the next item. keys['x'] = ["just_read","next_item"] # Searches can be bound to keybinds as well keys['1'] = search(".*[Ll]inux.*", regex=True) keys['2'] = search("Obama") # And, of course keys can be unset. keys['Q'] = None # This makes the reader show links by default, rather # than the default, toggling with 'l' keys[' '] = ["reader","toggle_show_links"] # A whole mess of feeds with tags, and without. # A 'None' tag will be replaced with the feeds title # The first tag is what is show at the top of each feed by default add("http://rss.slashdot.org/slashdot/Slashdot", tags=[None, "news"]) add("http://osnews.com/files/recent.xml", tags=[None, "news"]) add("http://www.damninteresting.com/?feed=rss2") add("http://reddit.com/.rss", tags=["Reddit","news"]) add("http://programming.reddit.com/.rss", tags=["Proggit", "news"]) # Username / Passwords are supported for feeds protected by # Basic or Digest passwords add("http://feedparser.org/docs/examples/digest_auth.xml", username="test", password="digest") # Tags can work without configuration, or can be customized. # This makes the "news" tag default to showing only unread stories # and sorting by date. add_tag("news", filters=[show_unread], sorts=[[by_date]]) # Finally, you can set the tags shown with the tags list, # and rotate with '<' and '>' by default. tags = [ None, ["news"], ["Reddit", "Proggit"]] # None will be interpreted as the default set of tags, i.e. one # per feed.
FILES
- ~/.canto/conf
- Main configuration file. For advanced usage, see the online configuration documentation: http://codezen.org/canto/config
- ~/.canto/log
- Everyday log file.
- ~/.canto/fetchlog
- Canto-fetch log file.
- ~/.canto/feeds/
- This is the directory where the stories are recorded.
BUGS
None known, but it's not outside of the realm of possibility =P.HOMEPAGE
http://codezen.org/cantoAUTHOR
Jack Miller <jack@codezen.org>Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre