Template:Path: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
m (Code cleanup)
Line 3: Line 3:
{{todo|Icons for linked libraries (DLL, SO, DYLIB).}}
{{todo|Icons for linked libraries (DLL, SO, DYLIB).}}
{{todo|Separate designation for compressed vs uncompressed archives.}}
{{todo|Separate designation for compressed vs uncompressed archives.}}
{{Doc}}
{{Documentation}}
<includeonly><onlyinclude><!--
<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:{{#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|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="position:relative; top:{{#if:{{{icon|}}}{{{2|}}}|1px|3px}}">[[File:{{#if:{{{icon|}}}|{{#switch:{{{icon}}}<!-- path to folder -->
--><span style="position:relative; top:{{#if:{{{icon|}}}{{{2|}}}|1px|3px}}"><!--
|#default=icon-gnome-folder alt.png
-->[[File:{{#if:{{{icon|}}}
|APP|app|BAT|bat|COM|com|EXE|exe|SH|sh|EXECUTABLE|executable=Icon-Windows_Executable.png
      | {{#switch:{{{icon}}}
|APK|apk=Icon-Android.png
 
|code|CODE|c|C|h|H|C++|c++|hpp|HPP|cpp|CPP=Cpp-16px.png
<!-- if specified, replaces the icon even if the file extension is specified in {{{2}}} -->
|Java|java|jar|JAR=Icon_java.png
 
|msi|MSI|flatpak|FLATPAK|installer|INSTALLER|SETUP|setup=Icon-Windows_Installer.png
| #default = icon-gnome-folder alt.png
|REG|reg|REGEDIT|regedit|REGISTRY|registry|REGVALUE|regvalue|REGV|regv=Icon-regedit-2D-PathTemplate.png
| CUSTOM|custom = {{{customico}}}
|CUSTOM|custom={{{customico}}}
| APP|app|BAT|bat|COM|com|EXE|exe|SH|sh|EXECUTABLE|executable = Icon-Windows_Executable.png
|AUDIO|audio|SOUND|sound|MUSIC|music=Icon-Music-Note.png
| APK|apk = Icon-Android.png
|FMV|fmv|VIDEO|video|MOVIE|movie=Icon-Video_File-filled.png
| code|CODE|c|C|h|H|C++|c++|hpp|HPP|cpp|CPP = Cpp-16px.png
|IMAGE|image|PICTURE|picture=Icon-Image-filled.png
| Java|java|jar|JAR = Icon_java.png
|7z|7Z|tar.gz|TAR.GZ|tgz|TGZ|zip|ZIP|zipx|ZIPX|rar|RAR|VPK|vpk|PAK|pak=Folder_zip_icon.png
| msi|MSI|flatpak|FLATPAK|installer|INSTALLER|SETUP|setup = Icon-Windows_Installer.png
|VMF|vmf|hammer|HAMMER=Icon-Hammer_4.x.png
| REG|reg|REGEDIT|regedit|REGISTRY|registry|REGVALUE|regvalue|REGV|regv = Icon-regedit-2D-PathTemplate.png
|TEXTURE|texture=Icon-Image-filled.png<!-- Texture file currently same icon as image, but the tooltip will remain different.-->
| AUDIO|audio|SOUND|sound|MUSIC|music = Icon-Music-Note.png
<!-- |PAK|pak|PACKAGE|package=Icon-Package.png -->
| FMV|fmv|VIDEO|video|MOVIE|movie = Icon-Video_File-filled.png
<!-- |ZIP|zip|ARCHIVE|archive=Icon-Archive.png -->
| IMAGE|image|PICTURE|picture = Icon-Image-filled.png
<!-- |MDL|mdl|MODEL|model=Icon-Model.png -->
| 7z|7Z|tar.gz|TAR.GZ|tgz|TGZ|zip|ZIP|zipx|ZIPX|rar|RAR|VPK|vpk|PAK|pak = Folder_zip_icon.png
<!-- |MAP|map=Icon-Map.png -->
| VMF|vmf|hammer|HAMMER = Icon-Hammer_4.x.png
|GENERIC|generic|FILE|file=Icon-File-filled-cropped.png
| TEXTURE|texture = Icon-Image-filled.png<!-- Texture file currently same icon as image, but the tooltip will remain different -->
}}|{{#switch:{{{2}}}<!-- with "{{{2}}}" aka file extensions specified. -->
<!-- |PAK|pak|PACKAGE|package=Icon-Package.png -->
|#default=icon-gnome-folder alt.png
<!-- |ZIP|zip|ARCHIVE|archive=Icon-Archive.png -->
|APP|app|BAT|bat|COM|com|EXE|exe|SH|sh=Icon-Windows_Executable.png
<!-- |MDL|mdl|MODEL|model=Icon-Model.png -->
|APK|apk=Icon-Android.png
<!-- |MAP|map=Icon-Map.png -->
        |JAVA|java|JAR|jar=Icon_java.png
| GENERIC|generic|FILE|file = Icon-File-filled-cropped.png
|code|CODE|c|C|h|H|C++|c++|hpp|HPP|cpp|CPP=Cpp-16px.png
}}
|msi|MSI|flatpak|FLATPAK=Icon-Windows_Installer.png
      | {{#switch:{{{2}}}
|WAV|wav|MP3|mp3|OGG|ogg|OPUS|opus|VSND_C|vsnd_c|SOUND.CACHE|sound.cache=Icon-Music-Note.png
 
|AVI|avi|BIK|bik|MKV|mkv|MOV|mov|MP4|mp4|WMV|wmv|WEBM|webm=Icon-Video_File-filled.png
<!-- if the file extension is specified in {{{2}}} and {{{icon}}} was not specified, this will be used -->
                                                                |TXT|txt|RTF|rtf|WPD|wpd=Icon-edit-filled.png
 
                                                                |FXC|fxc=Icon-shader.png
| #default = icon-gnome-folder alt.png
                                                                |PY|py=Python-16px.png
| APP|app|BAT|bat|COM|com|EXE|exe|SH|sh = Icon-Windows_Executable.png
                                                                |NUT|nut|NUC|nuc=Sq-highres.png
| APK|apk = Icon-Android.png
                                                                |LUA|lua=Lua-16px.png
| JAVA|java|JAR|jar = Icon_java.png
                                                                |CHM|chm=Icon-help.png
| code|CODE|c|C|h|H|C++|c++|hpp|HPP|cpp|CPP = Cpp-16px.png
                                                                |CONFIG|config|CFG|cfg=Icon-settings_applications.png
| msi|MSI|flatpak|FLATPAK = Icon-Windows_Installer.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
| WAV|wav|MP3|mp3|OGG|ogg|OPUS|opus|VSND_C|vsnd_c|SOUND.CACHE|sound.cache = Icon-Music-Note.png
|DDS|dds|SPR|spr|VTF|vtf|VTEX_c|vtex_c=Icon-Image-filled.png<!--currently same icon as image-->
| AVI|avi|BIK|bik|MKV|mkv|MOV|mov|MP4|mp4|WMV|wmv|WEBM|webm = Icon-Video_File-filled.png
|7z|7Z|tar.gz|TAR.GZ|tgz|TGZ|zip|ZIP|zipx|ZIPX|rar|RAR|VPK|vpk|PAK|pak=Folder_zip_icon.png
| TXT|txt|RTF|rtf|WPD|wpd = Icon-edit-filled.png
|VMF|vmf|hammer|HAMMER=Icon-Hammer_4.x.png
| FXC|fxc = Icon-shader.png
                                                                |RMF|rmf=Icon-Hammer_3.x.png
| PY|py = Python-16px.png
<!-- |TAR|tar|PAK|pak|WAD|wad|VPK|vpk=Icon-Package.png -->
| NUT|nut|NUC|nuc = Sq-highres.png
<!-- |7Z|7z|BZ2|bz2|PK3|pk3|RAR|rar|ZIP|zip=Icon-Archive.png -->
| LUA|lua = Lua-16px.png
<!-- |MDL|mdl|MD2|md2|MD3|md3|VMDL|vmdl|VMDL_C|vmdl_c|PHY|phy|VTX|vtx|VVD|vvd=Icon-Model.png -->
| CHM|chm = Icon-help.png
<!-- |BSP|bsp|JMF|jmf|MAP|map|VMAP|vmap|VMAP_C|vmap_c|VMF|vmf=Icon-Map.png -->
| CONFIG|config|CFG|cfg=Icon-settings_applications.png
}}}}|baseline|alt={{#switch:{{{icon}}}<!-- fallback if icons are not loaded properly -->
| 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
|#default=🖿
| DDS|dds|SPR|spr|VTF|vtf|VTEX_c|vtex_c = Icon-Image-filled.png
|APP|app|BAT|bat|COM|com|EXE|exe=Windows Executable
| 7z|7Z|tar.gz|TAR.GZ|tgz|TGZ|zip|ZIP|zipx|ZIPX|rar|RAR|VPK|vpk|PAK|pak = Folder_zip_icon.png
|APK|apk=Android APK
| VMF|vmf|hammer|HAMMER = Icon-Hammer_4.x.png
|code|CODE=Code
| RMF|rmf = Icon-Hammer_3.x.png
|C++|c++|cpp|CPP=C++ code
<!-- |TAR|tar|PAK|pak|WAD|wad|VPK|vpk = Icon-Package.png -->
                                                                |H|h=C++ Header File
<!-- |7Z|7z|BZ2|bz2|PK3|pk3|RAR|rar|ZIP|zip = Icon-Archive.png -->
|Java|java|jar|JAR=Java Executable
<!-- |MDL|mdl|MD2|md2|MD3|md3|VMDL|vmdl|VMDL_C|vmdl_c|PHY|phy|VTX|vtx|VVD|vvd = Icon-Model.png -->
|MSI|msi=Windows Installer
<!-- |BSP|bsp|JMF|jmf|MAP|map|VMAP|vmap|VMAP_C|vmap_c|VMF|vmf = Icon-Map.png -->
|flatpak|FLATPAK=Flatpak Installer
}}
|installer|INSTALLER|SETUP|setup=Installer
      }}|baseline|alt={{#switch:{{{icon}}}
|RED|reg|REGEDIT|regedit|REGISTRY|registry=Registry Path
| #default = 🖿
|REGVALUE|regvalue|REGV|regv=Registry Value
| CUSTOM|custom = Custom Icon
|CUSTOM|custom=Custom Icon
| APP|app|BAT|bat|COM|com|EXE|exe = Windows Executable
|AUDIO|audio|SOUND|sound|MUSIC|music=🎜
| APK|apk = Android APK
|FMV|fmv|VIDEO|video|MOVIE|movie=🎬︎
| code|CODE = Code
                                                                |TXT|txt|RTF|rtf|WPD|wpd=Text File
| C++|c++|cpp|CPP = C++ code
                                                                |FXC|fxc=Shader File
| H|h = C++ Header File
|IMAGE|image|PICTURE|picture=🖼{{Path/strings|ImageIconFallback}}
| Java|java|jar|JAR = Java Executable
|7z|7Z|tar.gz|TAR.GZ|tgz|TGZ|zip|ZIP|zipx|ZIPX|rar|RAR|VPK|vpk|PAK|pak=🗂️(Compressed)
| MSI|msi = Windows Installer
|VMF|vmf|hammer|HAMMER=VMF <small>(Valve Map Format)</small>
| flatpak|FLATPAK = Flatpak Installer
|TEXTURE|texture|TEX|tex={{Path/strings|TexturesIconFallback}}
| installer|INSTALLER|SETUP|setup = Installer
<!-- |PAK|pak|PACKAGE|package={{Path/strings|PackageIconFallback}} -->
| RED|reg|REGEDIT|regedit|REGISTRY|registry = Registry Path
<!-- |ZIP|zip|ARCHIVE|archive={{Path/strings|ArchiveIconFallback}} -->
| REGVALUE|regvalue|REGV|regv = Registry Value
<!-- |MDL|mdl|MODEL|model={{Path/strings|ModelIconFallback}} -->
| AUDIO|audio|SOUND|sound|MUSIC|music = 🎜
<!-- |MAP|map={{Path/strings|MapIconFallback}} -->
| FMV|fmv|VIDEO|video|MOVIE|movie = 🎬︎
|GENERIC|generic|FILE|file={{Path/strings|File}} <!-- alt parameter will be used for Unicode fallback if the icon doesn't load properly.  
| TXT|txt|RTF|rtf|WPD|wpd = Text File
| FXC|fxc = Shader File
| IMAGE|image|PICTURE|picture = 🖼{{Path/strings|ImageIconFallback}}
| 7z|7Z|tar.gz|TAR.GZ|tgz|TGZ|zip|ZIP|zipx|ZIPX|rar|RAR|VPK|vpk|PAK|pak = 🗂️ (Compressed)
| VMF|vmf|hammer|HAMMER = VMF <small>(Valve Map Format)</small>
| TEXTURE|texture|TEX|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|generic|FILE|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: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%}} }} }}); border-radius:0 4px 4px 0; color:#CCC; padding:0 4px; {{#if:{{{select|}}}|user-select:{{{select}}}|}}">{{{1|}}}{{#if:{{{2|}}}|.{{#ifexist: {{{2}}} | [[{{{2}}}]] | {{{2}}} }}|}}</code><!--
--><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%}} }} }}); 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>
 
--></span></onlyinclude>
 
</includeonly>

Revision as of 04:33, 1 August 2024

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=440840"