Pad

Onofficiële Beta-vertaling

Deze pagina is vertaald door PageTurner AI (beta). Niet officieel goedgekeurd door het project. Een fout gevonden? Probleem melden →

Wat

Toont het huidige pad.

Voorbeeldconfiguratie

json

{
  "type": "path",
  "style": "powerline",
  "powerline_symbol": "",
  "foreground": "#ffffff",
  "background": "#61AFEF",
  "options": {
    "style": "folder",
    "mapped_locations": {
      "C:\\temp": ""
    }
  }
}

yaml

type: path
style: powerline
powerline_symbol: 
foreground: "#ffffff"
background: "#61AFEF"
options:
  style: folder
  mapped_locations:
    C:\temp: 

toml

type = "path"
style = "powerline"
powerline_symbol = ""
foreground = "#ffffff"
background = "#61AFEF"

[options]
style = "folder"

[options.mapped_locations]
"C:\\temp" = ""

Opties

Name	Type	Default	Description
folder_separator_icon	string	/	the symbol to use as a separator between folders
folder_separator_template	string		the template to use as a separator between folders
home_icon	string	~	the icon to display when at $HOME
folder_icon	string	..	the icon to use as a folder indication
windows_registry_icon	string	\uF013	the icon to display when in the Windows registry
style	enum	agnoster	how to display the current path
mixed_threshold	number	4	the maximum length of a path segment that will be displayed when using Mixed
max_depth	number	1	maximum path depth to display before shortening when using agnoster_short
max_width	any	0	maximum path length to display when using powerlevel or agnoster, can leverage templates
hide_root_location	boolean	false	hides the root location if it doesn't fit in the last max_depth folders when using agnoster_short
cycle	[]string		a list of color overrides to cycle through to colorize the individual path folders, e.g. [ "#ffffff,#111111" ]
cycle_folder_separator	boolean	false	colorize the folder_separator_icon as well when using a cycle
folder_format	string	%s	format to use on individual path folders
edge_format	string	%s	format to use on the first and last folder of the path
left_format	string	%s	format to use on the first folder of the path - defaults to edge_format
right_format	string	%s	format to use on the last folder of the path - defaults to edge_format
gitdir_format	string		format to use for a git root directory
display_cygpath	boolean	false	display the Cygwin style path using cygpath -u $PWD
display_root	boolean	false	display the root / on Unix systems
dir_length	number	1	the length of the directory name to display when using fish
full_length_dirs	number	1	indicates how many full length directory names should be displayed when using fish

Gekoppelde Locaties

Hiermee kun je een locatie vervangen door een icoon/string. Het controleert of het huidige pad begint met specifieke elementen en vervangt het bij een match door het icoon/de string. Om problemen met geneste overschrijvingen te voorkomen, sorteert Oh My Posh de lijst met gekoppelde locaties vóór vervanging.

Name	Type	Default	Description
mapped_locations_enabled	boolean	true	replace known locations in the path with the replacements before applying the style
mapped_locations	object		custom glyph/text for specific paths. Works regardless of the mapped_locations_enabled

instelling.

Bijvoorbeeld, om C:\Users\Leet\GitHub te vervangen door een GitHub-icoon, kun je het volgende doen:

json

{
  "mapped_locations": {
    "C:\\Users\\Leet\\GitHub": ""
  }
}

yaml

mapped_locations:
  C:\Users\Leet\GitHub: 

toml

[mapped_locations]
"C:\\Users\\Leet\\GitHub" = ""

Werking

• Gebruik / als padscheidingsteken voor cross-platform werking. Oh My Posh herkent automatisch de effectieve scheidingstekens op basis van het besturingssysteem.

• Gebruik * als wildcard voor alle subdirectories. Bijvoorbeeld: "C:/Users/Bill/*": "$" transformeert C:/Users/Bill/Downloads naar $/Downloads maar laat C:/Users/Bill ongewijzigd.

• Het teken ~ aan het begin van een gekoppelde locatie komt overeen met de thuismap van de gebruiker.

• De matching is hoofdletterongevoelig op Windows en macOS, maar hoofdlettergevoelig op andere systemen. Dit betekent dat voor gebruiker Bill met account Bill op Windows en bill op Linux, ~/Foo kan matchen met C:\Users\Bill\Foo of C:\Users\Bill\foo op Windows, maar alleen met /home/bill/Foo op Linux.

waarschuwing

Om versnipperen van pad-elementen te voorkomen: vermijd chevron-tekens (</>) in de folder_separator_icon eigenschap als je tekststijltags (bijv. <lightGreen>...</>) in vervangingswaarden gebruikt, en vice versa.

Reguliere expressies gebruiken

Voor complexere gevallen kun je het voorvoegsel re: gebruiken met een capture group voor matching. Dit gebruikt Golangs regexp-pakket, dus alle ondersteunde syntax is beschikbaar. De vervangingswaarde is de eerste capture group, verdere groepen worden genegeerd.

Bijvoorbeeld: "re:(C:/[0-9]+/Foo)": "#" matcht C:\123\Foo\Bar en vervangt dit door #\Bar. Het pad gebruikt voor matching gebruikt altijd /, ongeacht het besturingssysteem, voor cross-platform matching.

Net als bij standaardvervangingen is matching hoofdletterongevoelig op Windows en WSL-drives, maar hoofdlettergevoelig op andere besturingssystemen.

Stijl

Stijl bepaalt hoe het pad wordt weergegeven. Er zijn 10 varianten gebaseerd op eerdere ervaringen en populaire thema's.

• agnoster

• agnoster_full

• agnoster_short

• agnoster_left

• full

• folder

• mixed

• letter

• unique

• powerlevel

• fish

Agnoster

Toont elke tussenliggende map als folder_icon gescheiden door folder_separator_icon. De eerste en laatste (huidige) mapnaam worden altijd onbewerkt getoond.

Agnoster Full

Toont elke mapnaam gescheiden door folder_separator_icon.

Agnoster Short

Als er meer dan max_depth niveaus diep is, wordt één folder_icon weergegeven (mits hide_root_location op false staat, wat betekent dat de hoofdmap niet meetelt voor de diepte) gevolgd door de namen van de laatste max_depth mappen, gescheiden door het folder_separator_icon.

Agnoster Left

Geeft elke map weer als het folder_icon, gescheiden door het folder_separator_icon. Alleen de eerste mapnaam en zijn directe onderliggende map worden volledig weergegeven.

Full

Geeft de huidige werkmap weer als een volledig pad waarbij elke map gescheiden wordt door het folder_separator_icon.

Folder

Geeft de naam van de huidige map weer.

Mixed

Werkt zoals agnoster, maar toont tussenliggende mappen onverkort als ze kort genoeg zijn. De maximale lengte voor deze weergave wordt bepaald door de eigenschap mixed_threshold.

Letter

Werkt zoals agnoster_full, maar toont elke mapnaam als eerste letter - behalve wanneer de naam begint met een symbool of pictogram. Specifiek wordt de laatste (huidige) mapnaam altijd volledig getoond.

• folder wordt f

• .config wordt .c

• __pycache__ wordt __p

• ➼ folder wordt ➼ f

Unique

Werkt zoals letter, maar garandeert dat elke mapnaam de kortst mogelijke unieke weergave heeft.

Uniciteit slaat op het weergegeven pad: C:\dev\dev\dev\development wordt C\d\de\dev\development (niet C\d\d\d\development zoals bij Letter). Uniciteit geldt niet tussen mappen op gelijk niveau: C:\projectA\dev en C:\projectB\dev worden beide C\p\dev.

Powerlevel

Werkt zoals unique, maar stopt met verkorten wanneer max_width is bereikt.

Fish

Werkt zoals letter, maar toont de eerste dir_length tekens van elke mapnaam - behalve de laatste mappen (aantal bepaald door full_length_dirs) die volledig worden getoond. Geïnspireerd op Fish shells PWD.

Template (informatie)

standaard sjabloon

 {{ .Path }}

Eigenschappen

Name	Type	Description
.Path	string	the current directory (based on the style property)
.Parent	string	the current directory's parent folder which ends with a path separator (designed for use with style folder, it is empty if .Path contains only one single element)
.RootDir	boolean	true if we're at the root directory (no parent)
.Location	string	the current directory (raw value)
.StackCount	int	the stack count
.Writable	boolean	is the current directory writable by the user or not
.Format	function	format any path based on the segment's settings (e.g. {{ .Format .Segments.Git.RelativeDir }})