mirror of
https://github.com/cheat/cheat.git
synced 2024-11-29 01:06:52 +01:00
e6f12147df
- Update the default config file to use `more` instead of `less` as the default pager, in order to support Windows out-of-the-box. (#655, #665). - Use `terminal` Chroma formatter (rather than `terminal16m`) in order to accommodate less capable terminal emulators like `cmd.exe` by default. Similarly, default to `colorize: false` in configs (changed from `true`) (#665). - Comment out default `style` in order to avoid printing ANSI color codes into terminals without color support (#665) - Attempt to intelligently choose a default editor, rather than rely on a hard-coded `vim` in the configs. This should make it easier to use `cheat` immediately without needing to specify configs. It should also improve `cheat`'s Windows compatibility. (#665)
71 lines
2.8 KiB
YAML
71 lines
2.8 KiB
YAML
---
|
|
# The editor to use with 'cheat -e <sheet>'. Defaults to $EDITOR or $VISUAL.
|
|
# editor: vim
|
|
|
|
# Should 'cheat' always colorize output?
|
|
colorize: false
|
|
|
|
# Which 'chroma' colorscheme should be applied to the output?
|
|
# Options are available here:
|
|
# https://github.com/alecthomas/chroma/tree/master/styles
|
|
# style: monokai
|
|
|
|
# Which 'chroma' "formatter" should be applied?
|
|
# One of: "terminal", "terminal256", "terminal16m"
|
|
formatter: terminal
|
|
|
|
# Through which pager should output be piped? (Unset this key for no pager.)
|
|
pager: more
|
|
# pager: less -FRX # <- recommended where available
|
|
|
|
# The paths at which cheatsheets are available. Tags associated with a cheatpath
|
|
# are automatically attached to all cheatsheets residing on that path.
|
|
#
|
|
# Whenever cheatsheets share the same title (like 'tar'), the most local
|
|
# cheatsheets (those which come later in this file) take precedent over the
|
|
# less local sheets. This allows you to create your own "overides" for
|
|
# "upstream" cheatsheets.
|
|
#
|
|
# But what if you want to view the "upstream" cheatsheets instead of your own?
|
|
# Cheatsheets may be filtered via 'cheat -t <tag>' in combination with other
|
|
# commands. So, if you want to view the 'tar' cheatsheet that is tagged as
|
|
# 'community' rather than your own, you can use: cheat tar -t community
|
|
cheatpaths:
|
|
|
|
# Paths that come earlier are considered to be the most "global", and will
|
|
# thus be overridden by more local cheatsheets. That being the case, you
|
|
# should probably list community cheatsheets first.
|
|
#
|
|
# Note that the paths and tags listed below are placeholders. You may freely
|
|
# change them to suit your needs.
|
|
#
|
|
# Community cheatsheets must be installed separately, though you may have
|
|
# downloaded them automatically when installing 'cheat'. If not, you may
|
|
# download them here:
|
|
#
|
|
# https://github.com/cheat/cheatsheets
|
|
#
|
|
# Once downloaded, ensure that 'path' below points to the location at which
|
|
# you downloaded the community cheatsheets.
|
|
- name: community
|
|
path: COMMUNITY_PATH
|
|
tags: [ community ]
|
|
readonly: true
|
|
|
|
# If you have personalized cheatsheets, list them last. They will take
|
|
# precedence over the more global cheatsheets.
|
|
- name: personal
|
|
path: PERSONAL_PATH
|
|
tags: [ personal ]
|
|
readonly: false
|
|
|
|
# While it requires no configuration here, it's also worth noting that
|
|
# 'cheat' will automatically append directories named '.cheat' within the
|
|
# current working directory to the 'cheatpath'. This can be very useful if
|
|
# you'd like to closely associate cheatsheets with, for example, a directory
|
|
# containing source code.
|
|
#
|
|
# Such "directory-scoped" cheatsheets will be treated as the most "local"
|
|
# cheatsheets, and will override less "local" cheatsheets. Likewise,
|
|
# directory-scoped cheatsheets will always be editable ('readonly: false').
|