Template:Path: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
No edit summary
 
(3 intermediate revisions by one other user not shown)
Line 8: Line 8:
<onlyinclude><!--
<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:{{#ifeq:{{{icon|}}}|reg|rgb(100 145 230 / 35%)| {{#ifeq:{{{icon|}}}|regv|rgb(100 145 230 / 35%)| {{#if:{{{2|}}}|#984EDDCC|rgba(230 145 100 / 30%)}} }} }}; 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:{{#if:{{{icon|}}}{{{2|}}}|1px|3px}}"><!--
--><span style="position:relative; top:{{#if:{{{icon|}}}{{{2|}}}|1px|3px}}"><!--
-->[[File:{{#if:{{{icon|}}}
-->[[File:{{#if:{{{icon|}}}
      | {{#switch:{{{icon}}}
      | {{#switch: {{lc:{{{icon}}}}}


<!-- if specified, replaces the icon even if the file extension is specified in {{{2}}} -->
<!-- if specified, replaces the icon even if the file extension is specified in {{{2}}} -->


| #default = icon-gnome-folder alt.png
| #default = icon-gnome-folder alt.png
| CUSTOM|custom = {{{customico}}}
| custom = {{{customico}}}
| APP|app|BAT|bat|COM|com|EXE|exe|SH|sh|EXECUTABLE|executable = Icon-Windows_Executable.png
| app|bat|com|exe|sh|executable = Icon-Windows_Executable.png
| APK|apk = Icon-Android.png
| apk = Icon-Android.png
| code|CODE|c|C|h|H|C++|c++|hpp|HPP|cpp|CPP = Cpp-16px.png
| code|c|h|c++|hpp|cpp= Cpp-16px.png
| Java|java|jar|JAR = Icon_java.png
| java|jar= Icon_java.png
| msi|MSI|flatpak|FLATPAK|installer|INSTALLER|SETUP|setup = Icon-Windows_Installer.png
| msi|flatpak|installer|setup = Icon-Windows_Installer.png
| REG|reg|REGEDIT|regedit|REGISTRY|registry|REGVALUE|regvalue|REGV|regv = Icon-regedit-2D-PathTemplate.png
| reg|regedit|registry|regvalue|regv = Icon-regedit-2D-PathTemplate.png
| AUDIO|audio|SOUND|sound|MUSIC|music = Icon-Music-Note.png
| audio|sound|music = Icon-Music-Note.png
| FMV|fmv|VIDEO|video|MOVIE|movie = Icon-Video_File-filled.png
| fmv|video|movie = Icon-Video_File-filled.png
| IMAGE|image|PICTURE|picture = Icon-Image-filled.png
| image|picture = Icon-Image-filled.png
| 7z|7Z|tar.gz|TAR.GZ|tgz|TGZ|zip|ZIP|zipx|ZIPX|rar|RAR|VPK|vpk|PAK|pak = Folder_zip_icon.png
| 7z|tar.gz|tgz|zip|zipx|rar|vpk|pak = Folder_zip_icon.png
| VMF|vmf|hammer|HAMMER = Icon-Hammer_4.x.png
| vmf|hammer= Icon-Hammer_4.x.png
| TEXTURE|texture = Icon-Image-filled.png<!-- Texture file currently same icon as image, but the tooltip will remain different -->
| texture = Icon-Image-filled.png<!-- Texture file currently same icon as image, but the tooltip will remain different -->
<!-- |PAK|pak|PACKAGE|package=Icon-Package.png -->
<!-- |pak|package=Icon-Package.png -->
<!-- |ZIP|zip|ARCHIVE|archive=Icon-Archive.png -->
<!-- |zip|archive=Icon-Archive.png -->
<!-- |MDL|mdl|MODEL|model=Icon-Model.png -->
<!-- |mdl|model=Icon-Model.png -->
<!-- |MAP|map=Icon-Map.png -->
<!-- |map=Icon-Map.png -->
| GENERIC|generic|FILE|file = Icon-File-filled-cropped.png
| generic|file = Icon-File-filled-cropped.png
}}
}}
      | {{#switch:{{{2}}}
      | {{#switch: {{lc:{{{2}}}}}


<!-- if the file extension is specified in {{{2}}} and {{{icon}}} was not specified, this will be used -->
<!-- if the file extension is specified in {{{2}}} and {{{icon}}} was not specified, this will be used -->


| #default = icon-gnome-folder alt.png
| #default = icon-gnome-folder alt.png
| APP|app|BAT|bat|COM|com|EXE|exe|SH|sh = Icon-Windows_Executable.png
| app|bat|com|exe|sh = Icon-Windows_Executable.png
| APK|apk = Icon-Android.png
| apk = Icon-Android.png
| JAVA|java|JAR|jar = Icon_java.png
| java|jar = Icon_java.png
| code|CODE|c|C|h|H|C++|c++|hpp|HPP|cpp|CPP = Cpp-16px.png
| code|c|h|c++|hpp|cpp = Cpp-16px.png
| msi|MSI|flatpak|FLATPAK|DEB|deb = Icon-Windows_Installer.png
| msi|flatpak|deb = Icon-Windows_Installer.png
| WAV|wav|MP3|mp3|OGG|ogg|OPUS|opus|FLAC|flac|WMA|wma|XWV|xwv|VSND_C|vsnd_c|SOUND.CACHE|sound.cache = Icon-Music-Note.png
| wav|mp3|ogg|opus|flac|wma|xwv|vsnd_c|sound.cache = Icon-Music-Note.png
| AVI|avi|BIK|bik|MKV|mkv|MOV|mov|MP4|mp4|WMV|wmv|WEBM|webm|OGV|ogv = Icon-Video_File-filled.png
| avi|bik|mkv|mov|mp4|wmv|webm|ogv = Icon-Video_File-filled.png
| TXT|txt|RTF|rtf|WPD|wpd = Icon-edit-filled.png
| txt|rtf|wpd = Icon-edit-filled.png
| FXC|fxc = Icon-shader.png
| fxc = Icon-shader.png
| PY|py|PYC|pyc = Python-16px.png
| py|pyc = Python-16px.png
| NUT|nut|NUC|nuc = Sq-highres.png
| nut|nuc = Sq-highres.png
| LUA|lua = Lua-16px.png
| lua = Lua-16px.png
| CHM|chm = Icon-help.png
| chm = Icon-help.png
| CONFIG|config|CFG|cfg=Icon-settings_applications.png
| config|cfg=Icon-settings_applications.png
| APNG|apng|BMP|bmp|JPG|jpg|JPEG|jpeg|PCX|pcx|PNG|png|TGA|tga|TIF|tif|TIFF|tiff|WEBP|WebP|webp|SVG|svg|VSVG|vsvg|VSVG_C|vsvg_c = Icon-Image-filled.png
| apng|bmp|jpg|jpeg|pcx|png|tga|tif|tiff|webp|svg|vsvg|vsvg_c = Icon-Image-filled.png
| DDS|dds|SPR|spr|VTF|vtf|VTEX_c|vtex_c|WAL|wal = Icon-Image-filled.png<!--currently same icon as image-->
| dds|spr|vtf|vtex_c|wal = Icon-Image-filled.png<!--currently same icon as image-->
| 7z|7Z|tar.gz|TAR.GZ|tgz|TGZ|zip|ZIP|zipx|ZIPX|rar|RAR|VPK|vpk|PAK|pak|WAD|wad|TAR|tar|BZ2|bz2|PK3|pk3 = Folder_zip_icon.png
| 7z|tar.gz|tgz|zip|zipx|rar|vpk|pak|wad|tar|bz2|pk3 = Folder_zip_icon.png
| VMAP|vmap = Icon-Hammer_5.x.png
| vmap = Icon-Hammer_5.x.png
| VMF|vmf|VMX|vmx|HAMMER|hammer = Icon-Hammer_4.x.png
| vmf|vmx|hammer = Icon-Hammer_4.x.png
| RMF|rmf|RMX|rmx|MAP|map = Icon-Hammer_3.x.png
| rmf|rmx|map = Icon-Hammer_3.x.png
| JMF|jmf|JMX|jmx = jack_icon.png
| jmf|jmx = jack_icon.png
<!-- |TAR|tar|PAK|pak|WAD|wad|VPK|vpk = Icon-Package.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 -->
<!-- |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 -->
<!-- |BSP|bsp|VMAP_C|vmap_c|VMF|vmf = Icon-Map.png -->
}}
}}
      }}|baseline|alt={{#switch:{{{icon}}}
      }}|baseline|alt={{#switch: {{lc:{{{icon}}}}}


<!-- fallback if icons are not loaded properly -->
<!-- fallback if icons are not loaded properly -->


| #default = 🖿
| #default = 🖿
| CUSTOM|custom = Custom Icon
| custom = Custom Icon
| APP|app|BAT|bat|COM|com|EXE|exe = Windows Executable
| app|bat|com|exe = Windows Executable
| APK|apk = Android APK
| apk = Android APK
| code|CODE = Code
| code= Code
| C++|c++|cpp|CPP = C++ code
| c++|cpp= C++ code
| H|h = C++ Header File
| h = C++ Header File
| Java|java|jar|JAR = Java Executable
| java|jar = Java Executable
| MSI|msi = Windows Installer
| msi = Windows Installer
| flatpak|FLATPAK = Flatpak Installer
| flatpak = Flatpak Installer
| installer|INSTALLER|SETUP|setup = Installer
| installer|setup = Installer
| RED|reg|REGEDIT|regedit|REGISTRY|registry = Registry Path
| reg|regedit|registry = Registry Path
| REGVALUE|regvalue|REGV|regv = Registry Value
| regvalue|regv = Registry Value
| AUDIO|audio|SOUND|sound|MUSIC|music = 🎜
| audio|sound|music = 🎜
| FMV|fmv|VIDEO|video|MOVIE|movie = 🎬︎
| fmv|video|movie = 🎬︎
| TXT|txt|RTF|rtf|WPD|wpd = Text File
| txt|rtf|wpd = Text File
| FXC|fxc = Shader File
| fxc = Shader File
| IMAGE|image|PICTURE|picture = 🖼{{Path/strings|ImageIconFallback}}
| image|picture = 🖼{{Path/strings|ImageIconFallback}}
| 7z|7Z|tar.gz|TAR.GZ|tgz|TGZ|zip|ZIP|zipx|ZIPX|rar|RAR|VPK|vpk|PAK|pak = 🗂️ (Compressed)
| 7z|tar.gz|tgz|zip|zipx|rar|vpk|pak = 🗂️ (Compressed)
| VMF|vmf|hammer|HAMMER = VMF <small>(Valve Map Format)</small>
| vmf|hammer = VMF <small>(Valve Map Format)</small>
| TEXTURE|texture|TEX|tex = {{Path/strings|TexturesIconFallback}}
| texture|tex = {{Path/strings|TexturesIconFallback}}
<!-- |PAK|pak|PACKAGE|package={{Path/strings|PackageIconFallback}} -->
<!-- |PAK|pak|PACKAGE|package={{Path/strings|PackageIconFallback}} -->
<!-- |ZIP|zip|ARCHIVE|archive={{Path/strings|ArchiveIconFallback}} -->
<!-- |ZIP|zip|ARCHIVE|archive={{Path/strings|ArchiveIconFallback}} -->
<!-- |MDL|mdl|MODEL|model={{Path/strings|ModelIconFallback}} -->
<!-- |MDL|mdl|MODEL|model={{Path/strings|ModelIconFallback}} -->
<!-- |MAP|map={{Path/strings|MapIconFallback}} -->
<!-- |MAP|map={{Path/strings|MapIconFallback}} -->
| GENERIC|generic|FILE|file = {{Path/strings|File}}<!-- alt parameter will be used for Unicode fallback if the icon doesn't load properly.  
| 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|link=]]<!--
}}|15px|link=]]<!--
Line 100: Line 100:
--></span><!--
--></span><!--


--><code style="background-color:rgb({{#ifeq:{{{icon|}}}|reg|100 145 230 / 15%| {{#ifeq:{{{icon|}}}|regv|100 145 230 / 15%| {{#if:{{{2|}}}|152 78 221 / 25%|230 145 100 / 15%}} }} }}) !important; border-radius:0 4px 4px 0 !important; color:#CCC !important; padding:0 4px !important; {{#if:{{{select|}}}|user-select:{{{select}}}|}}">{{{1|}}}{{#if:{{{2|}}}|.{{#ifexist: {{{2}}} | [[{{{2}}}]] | {{{2}}} }}|}}</code><!--
--><code>{{{1|}}}{{#if:{{{2|}}}|.{{#switch: {{lc:{{{2}}}}}
| exe = [[w:.exe|<span style="color:grey">exe</span>]]
| txt = txt
| svg = [[w:SVG|svg]]
| vsvg = [[w:SVG|vsvg]]
| vsvg_c = [[w:SVG|vsvg_c]]
| #default = [[{{lc:{{{2}}}}}|{{{2}}}]]}}
}}</code><!--


--></span></onlyinclude>
--></span></onlyinclude>


</includeonly>
</includeonly>

Latest revision as of 13:50, 25 October 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
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=491359"