Template:Path: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(Looks like Webdings could probably work for fallback aswell, while used alongside Unicode, tested on Android and Windows 11, without losing quality. Still wonder if this font is available in all OS through.)
No edit summary
 
(34 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{todo|Fall back to generic file icon instead of folder icon if {{param|2}} is present.}}
{{todo|Fall back to generic file icon instead of folder icon if {{param|2}} is present.}}
{{todo|Icons for models, maps, compressed archives, and uncompressed packages. Syntax exists, and just needs to be uncommented when the icons are ready.}}
{{todo|Icons for models, maps, compressed archives, and uncompressed packages. Syntax exists, and just needs to be uncommented when the icons are ready.}}
{{Doc}}
{{todo|Icons for linked libraries (DLL, SO, DYLIB).}}
<includeonly><onlyinclude><!--
{{todo|Separate designation for compressed vs uncompressed archives.}}
{{Documentation}}
<includeonly>
 
<onlyinclude><!--
--><span style="display:inline-flex; align-items:center; line-height:1.35em"><!--
--><span style="display:inline-flex; align-items:center; line-height:1.35em"><!--
--><span style="background-color:{{#if:{{{2|}}}|#984EDDCC|#536FFFCC}}; border-radius:4px 0 0 4px; padding:0 3px 0 4px; user-select:none; pointer-events:none"><!--
--><span style="background-color:{{#ifeq:{{{icon|}}}|reg|rgba(100, 145, 230, 0.1)| {{#ifeq:{{{icon|}}}|regv|rgba(100, 145, 230, 0.1)| {{#if:{{{2|}}}|#984EDD20|rgba(230, 145, 100, 0.1)}} }} }};padding:0 3px 0 4px; user-select:none; pointer-events:none"><!--
--><span style="position:relative; top:1px">[[File:{{#if:{{{icon|}}}|{{#switch:{{{icon}}}
--><span style="position:relative; top:{{#if:{{{icon|}}}{{{2|}}}|1px|3px}}"><!--
|#default=icon-folder open-filled.png
-->[[File:{{#if:{{{icon|}}}
|EXE|exe|EXECUTABLE|executable=Icon-Windows_Executable.png
      | {{#switch: {{lc:{{{icon}}}}}
|msi|MSI|flatpak|FLATPAK|installer|INSTALLER|SETUP|setup=Icon-Windows_Installer.png
 
|REG|reg|REGEDIT|regedit|REGISTRY|registry|REGVALUE|regvalue|REGV|regv=Icon-regedit-2D-PathTemplate.png
<!-- if specified, replaces the icon even if the file extension is specified in {{{2}}} -->
|CUSTOM|custom={{{customico}}}
 
|AUDIO|audio|SOUND|sound|MUSIC|music=Icon-Music-Note.png
| #default = icon-gnome-folder alt.png
|FMV|fmv|VIDEO|video|MOVIE|movie=Icon-Video_File-filled.png
| custom = {{{customico}}}
|IMAGE|image|PICTURE|picture=Icon-Image-filled.png
| app|bat|com|exe|sh|executable = Icon-Windows_Executable.png
|TEXTURE|texture=Icon-Image-filled.png<!-- Texture file currently same icon as image, but the tooltip will remain different.-->
| apk = Icon-Android.png
<!-- |PAK|pak|PACKAGE|package=Icon-Package.png -->
| code|c|h|c++|hpp|cpp= Cpp-16px.png
<!-- |ZIP|zip|ARCHIVE|archive=Icon-Archive.png -->
| java|jar= Icon_java.png
<!-- |MDL|mdl|MODEL|model=Icon-Model.png -->
| msi|flatpak|installer|setup = Icon-Windows_Installer.png
<!-- |MAP|map=Icon-Map.png -->
| reg|regedit|registry|regvalue|regv = Icon-regedit-2D-PathTemplate.png
|GENERIC|generic|FILE|file=Icon-File-filled-cropped.png
| audio|sound|music = Icon-Music-Note.png
}}|{{#switch:{{{2}}}
| fmv|video|movie = Icon-Video_File-filled.png
|#default=icon-folder open-filled.png
| image|picture = Icon-Image-filled.png
|APP|app|BAT|bat|COM|com|EXE|exe|SH|sh=Icon-Windows_Executable.png
| 7z|tar.gz|tgz|zip|zipx|rar|vpk|pak = Folder_zip_icon.png
|msi|MSI|flatpak|FLATPAK=Icon-Windows_Installer.png
| vmf|hammer= Icon-Hammer_4.x.png
|WAV|wav|MP3|mp3|OGG|ogg|OPUS|opus|VSND_C|vsnd_c=Icon-Music-Note.png
| texture = Icon-Image-filled.png<!-- Texture file currently same icon as image, but the tooltip will remain different -->
|AVI|avi|BIK|bik|MKV|mkv|MOV|mov|MP4|mp4|WMV|wmv|WEBM|webm=Icon-Video_File-filled.png
<!-- |pak|package=Icon-Package.png -->
|APNG|apng|BMP|bmp|JPG|jpg|JPEG|jpeg|PCX|pcx|PNG|png|TGA|tga|TIF|tif|TIFF|tiff|WEBP|WebP|webp=Icon-Image-filled.png
<!-- |zip|archive=Icon-Archive.png -->
|DDS|dds|SPR|spr|VTF|vtf|VTEX_c|vtex_c=Icon-Image-filled.png<!--currently same icon as image-->
<!-- |mdl|model=Icon-Model.png -->
<!-- |TAR|tar|PAK|pak|WAD|wad|VPK|vpk=Icon-Package.png -->
<!-- |map=Icon-Map.png -->
<!-- |7Z|7z|BZ2|bz2|PK3|pk3|RAR|rar|ZIP|zip=Icon-Archive.png -->
| generic|file = Icon-File-filled-cropped.png
<!-- |MDL|mdl|MD2|md2|MD3|md3|VMDL|vmdl|VMDL_C|vmdl_c|PHY|phy|VTX|vtx|VVD|vvd=Icon-Model.png -->
}}
<!-- |BSP|bsp|JMF|jmf|MAP|map|RMF|rmf|VMAP|vmap|VMAP_C|vmap_c|VMF|vmf=Icon-Map.png -->
      | {{#switch: {{lc:{{{2}}}}}
}}}}|baseline|alt={{#switch:{{{icon}}}<!-- fallback if icons are not loaded properly -->
 
|#default=🖿
<!-- if the file extension is specified in {{{2}}} and {{{icon}}} was not specified, this will be used -->
|EXE|exe=Windows Executable
 
|MSI|msi=Windows Installer
| #default = icon-gnome-folder alt.png
|flatpak|FLATPAK=Flatpak Installer
| app|bat|com|exe|sh = Icon-Windows_Executable.png
|installer|INSTALLER|SETUP|setup=Installer
| apk = Icon-Android.png
|RED|reg|REGEDIT|regedit|REGISTRY|registry=Registry Path
| java|jar = Icon_java.png
|REGVALUE|regvalue|REGV|regv=Registry Value
| code|c|h|c++|hpp|cpp = Cpp-16px.png
|CUSTOM|custom=Custom Icon
| msi|flatpak|deb = Icon-Windows_Installer.png
|AUDIO|audio|SOUND|sound|MUSIC|music=🎜
| wav|mp3|ogg|opus|flac|wma|xwv|vsnd_c|sound.cache = Icon-Music-Note.png
|FMV|fmv|VIDEO|video|MOVIE|movie=🎬︎
| avi|bik|mkv|mov|mp4|wmv|webm|ogv = Icon-Video_File-filled.png
|IMAGE|image|PICTURE|picture=🖼{{Path/strings|ImageIconFallback}}
| txt|rtf|wpd = Icon-edit-filled.png
|TEXTURE|texture|TEX|tex={{Path/strings|TexturesIconFallback}}
| fxc = Icon-shader.png
<!-- |PAK|pak|PACKAGE|package={{Path/strings|PackageIconFallback}} -->
| py|pyc = Python-16px.png
<!-- |ZIP|zip|ARCHIVE|archive={{Path/strings|ArchiveIconFallback}} -->
| nut|nuc = Sq-highres.png
<!-- |MDL|mdl|MODEL|model={{Path/strings|ModelIconFallback}} -->
| lua = Lua-16px.png
<!-- |MAP|map={{Path/strings|MapIconFallback}} -->
| chm = Icon-help.png
|GENERIC|generic|FILE|file={{Path/strings|File}} <!-- alt parameter will be used for unicode fallback if the icon doesnt load properly.  
| config|cfg=Icon-settings_applications.png
| apng|bmp|jpg|jpeg|pcx|png|tga|tif|tiff|webp|svg|vsvg|vsvg_c = Icon-Image-filled.png
| dds|spr|vtf|vtex_c|wal = Icon-Image-filled.png<!--currently same icon as image-->
| 7z|tar.gz|tgz|zip|zipx|rar|vpk|pak|wad|tar|bz2|pk3 = Folder_zip_icon.png
| vmap = Icon-Hammer_5.x.png
| vmf|vmx|hammer = Icon-Hammer_4.x.png
| rmf|rmx|map = Icon-Hammer_3.x.png
| jmf|jmx = jack_icon.png
<!-- |TAR|tar|PAK|pak|WAD|wad|VPK|vpk = Icon-Package.png -->
<!-- |MDL|mdl|MD2|md2|MD3|md3|VMDL|vmdl|VMDL_C|vmdl_c|PHY|phy|VTX|vtx|VVD|vvd = Icon-Model.png -->
<!-- |BSP|bsp|VMAP_C|vmap_c|VMF|vmf = Icon-Map.png -->
}}
      }}|baseline|alt={{#switch: {{lc:{{{icon}}}}}
 
<!-- fallback if icons are not loaded properly -->
 
| #default = 🖿
| custom = Custom Icon
| app|bat|com|exe = Windows Executable
| apk = Android APK
| code= Code
| c++|cpp= C++ code
| h = C++ Header File
| java|jar = Java Executable
| msi = Windows Installer
| flatpak = Flatpak Installer
| installer|setup = Installer
| reg|regedit|registry = Registry Path
| regvalue|regv = Registry Value
| audio|sound|music = 🎜
| fmv|video|movie = 🎬︎
| txt|rtf|wpd = Text File
| fxc = Shader File
| image|picture = 🖼{{Path/strings|ImageIconFallback}}
| 7z|tar.gz|tgz|zip|zipx|rar|vpk|pak = 🗂️ (Compressed)
| vmf|hammer = VMF <small>(Valve Map Format)</small>
| texture|tex = {{Path/strings|TexturesIconFallback}}
<!-- |PAK|pak|PACKAGE|package={{Path/strings|PackageIconFallback}} -->
<!-- |ZIP|zip|ARCHIVE|archive={{Path/strings|ArchiveIconFallback}} -->
<!-- |MDL|mdl|MODEL|model={{Path/strings|ModelIconFallback}} -->
<!-- |MAP|map={{Path/strings|MapIconFallback}} -->
| generic|file = {{Path/strings|File}}<!-- alt parameter will be used for Unicode fallback if the icon doesn't load properly.  
Emojis are not recommended as older OSes may lack certain emojis.-->
Emojis are not recommended as older OSes may lack certain emojis.-->
}}|15px]]</span><!--
}}|15px|link=]]<!--
--></span><!--
--></span><!--
--></span><!--
--><code style="background-color:rgba({{#if:{{{2|}}}|152,78,221,.25|83,111,255,.25}}); border-radius:0 4px 4px 0; color:#CCC; padding:0 4px; {{#if:{{{select|}}}|user-select:{{{select}}}|}}">{{{1|}}}{{#if:{{{2|}}}|.{{#ifexist: {{{2}}} | [[{{{2}}}]] | {{{2}}} }}|}}</code><!--
 
--></span></onlyinclude></includeonly>
--><code>{{{1|}}}{{#if:{{{2|}}}|.{{#switch: {{lc:{{{2}}}}}
| exe = [[w:.exe|<span style="color:grey">exe</span>]]
| txt = txt
| #default = [[{{lc:{{{2}}}}}|{{{2}}}]]}}
}}</code><!--
 
--></span></onlyinclude>
 
</includeonly>

Latest revision as of 06:16, 9 May 2025

Todo: Fall back to generic file icon instead of folder icon if {{{2}}} is present.
Todo: Icons for models, maps, compressed archives, and uncompressed packages. Syntax exists, and just needs to be uncommented when the icons are ready.
Todo: Icons for linked libraries (DLL, SO, DYLIB).
Todo: Separate designation for compressed vs uncompressed archives.
English (en)Deutsch (de)Esperanto (eo)Español (es)Français (fr)Suomi (fi)Hrvatski (hr)Magyar (hu)Italiano (it)日本語 (ja)한국어 (ko)Nederlands (nl)Polski (pl)Português (pt)Português do Brasil (pt-br)Русский (ru)Slovenčina (sk)Svenska (sv)Türkçe (tr)Українська (uk)Tiếng Việt (vi)中文 (zh)中文（臺灣） (zh-tw)
Curly brackets white.pngTemplate Documentation [view] [edit]
Icon-translate.png Available doc translations
View
Page history
…
Icon-translate.png
This template uses a strings subpage
Please follow the format on this subpage(s) to add translations.

The path to the folder or file. {{file}} aliases here.

Parameters and Examples

Parameter Description Examples Preview
{{{1}}} The path to the folder or file.
{{Path|C:\Program Files\Steam}}
🖿C:\Program Files\Steam
{{{2}}} File extension, if any. Omit the dot.
{{Path|D:\Program Files\Steam\steam|exe}}
{{Path|de_dust2|bsp}}
{{Path|materials\debug\debugempty|vtf}}
🖿D:\Program Files\Steam\steam.exe
🖿de_dust2.bsp
🖿materials\debug\debugempty.vtf
{{{select}}} Text selection mode based on the CSS property user-select.
No effect on some browsers.
Warning.pngWarning:select=none is likely to cause user frustration; use sparingly.
{{Path|select=none|C:\Program Files}}
{{Path|select=all|C:\Program Files}}
🖿C:\Program Files
🖿C:\Program Files
{{{icon}}}
{{{customico}}} 		Changes the icon. The tooltip (which appears if you are hovering the text or the icon itself), will have it's text changed aswell.

If the images is disabled in your browser or when a new icon file is being uploaded, it may fallback to Unicode symbols or simple text.

{{{customico}}} is used to change to any icon if you want. Tooltip will likely be limited with this method, which only refers custom icon as a generic file, and may cause a scaling bug (more noticeable when zooming in). 		Executable:
{{Path|hl2|exe|icon=exe}}
Registry path:
{{Path|Computer\HKEY_CURRENT_USER\SOFTWARE\Valve\Source|icon=reg}}
Registry value:
{{Path|DXLevel_V1|icon=regv}}
Audio/Music:
{{Path|Half-Life01|mp3|icon=audio}}
Videos:
{{Path|valve|bik|icon=video}}
File (generic):
{{Path|example|sound.cache|icon=file}}
Image:
{{Path|d1_trainstation_010000|jpg|icon=image}}
Texture (currently same icon, but this will likely change):
{{Path|alyx_sheet|vtf|icon=texture}}
Custom icon:
{{Path|hl2|exe|icon=custom|customico=HL2-hires.png}}
Windows Executablehl2.exe
Registry PathHKEY_CURRENT_USER\SOFTWARE\Valve\Source
Registry ValueDXLevel_V1
🎜Half-Life01.mp3
🎬︎valve.bik
Fileexample.sound.cache
🖼Imaged1_trainstation_010000.jpg
Texturealyx_sheet.vtf
Custom Iconp3.exe

See also

The above documentation is transcluded from Template:Path/doc. (Edit | Page history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Template:Path&oldid=475904"