Placeholders for single files |
Placeholders referring to single files are used in such cases, where
arguments for command line tools (like LaTeX) and DDE-commands need to be
defined.
Placeholders for single files have to begin with a percent sign
('%') followed by up to three characters. The last character
specifies which files the placeholder references to:
- m
- The current project's main file.
- c
- The current file - The file opened in the editor that has
the input focus.
The character before the last character describes how to reference
the specified file:
- p
- The file's fully qualified path.
- w
- The file's relative path starting in project directory
(= working directory).
- d
- The file's directory.
- n
- The file's name (name and extension).
- t
- The file's title (name without extension).
- e
- The file's extension.
- b
- The file's base (fully qualified path without the file
extension).
- r
- The file's drive letter (followed by colon ':').
Instead of 'p', 'w', 'd' and
'm' use the uppercase variants of these characters to get slashes
('/') instead of backslashes ('\') as path separators.
The percent sign ('%') can be followed by an
's'. In this case, the placeholders will be replaced with
paths matching the old 8.3 path convention.
To get a percent sign in the resulting string you have to use the
placeholder '%%' which will always be replaced by
'%'.
Placeholders referring the project's main file |
The following placeholders are used as a reference to a project's main file.
If the 'Build|Current File|...' command is used, these
placeholders will be replaced with the equivalents for the current file.
The examples in brackets show how the placeholder will be replaced, if
the current project's main file is "C:\My Documents\TxcTest\JustATest.tex".
- %pm
- Will be replaced by the full path of the current project's
main file.
["C:\My Documents\TxcTest\JustATest.tex"]
- %wm
- Will be replaced by the relative path of the current project's main file.
["JustATest.tex"]
- %dm
- Will be replaced by the directory of the current project's main file.
["C:\My Documents\TxcTest"]
- %nm
- Will be replaced by the name of the current project's main file. The
name includes the file extension.
["JustATest.tex"]
- %tm
- Will be replaced by the title of the current project's main file. The
title does not include the file extension.
["JustATest"]
- %em
- Will be replaced by the extension of the current project's main file.
["tex"]
- %bm
- Will be replaced by the base of the current project's main file. The
base includes the directory followed by the file's title without the file
extension.
["C:\My Documents\TxcTest\JustATest"]
Placeholders with Slashes instead of Backslashes |
- %Pm
- Same as '%pm' but using slashes instead of backslashes.
["C:/My Documents/TxcTest/JustATest.tex"]
- %Dm
- Same as '%dm' but using slashes instead of backslashes.
["C:/My Documents/TxcTest"]
- %Bm
- Same as '%bm' but using slashes instead of backslashes.
["C:/My Documents/TxcTest/JustATest"]
Placeholders for 8.3 path notation |
- %spm
- Same as '%pm', but using the 8.3 path notation.
["C:\MyDocu~1\TxcTest\JustAT~1.tex"]
- %sdm
- Same as '%dm', but using the 8.3 path notation.
["C:\MyDocu~1\TxcTest"]
- %snm
- Same as '%nm', but using the 8.3 path notation.
["JustAT~1.tex"]
- %stm
- Same as '%tm', but using the 8.3 path notation.
["JustAT~1"]
- %sem
- Same as '%em', but using the 8.3 path notation.
["tex"]
- %sbm
- Same as '%sbm', but using the 8.3 path notation.
["C:\MyDocu~1\TxcTest\JustAT~1"]
Placeholders for 8.3 path notation with Slashes instead of
Backslashes |
- %sPm
- Same as '%spm', but using slashes instead of backslashes.
["C:/MyDocu~1/TxcTest/JustAT~1.tex"]
- %sDm
- Same as '%sdm', but using slashes instead of backslashes.
["C:/MyDocu~1/TxcTest"]
- %sBm
- Same as '%sbm', but using slashes instead of backslashes.
["C:/MyDocu~1/TxcTest/JustAT~1"]
Placeholders referring the current file |
The following placeholders are used to reference the current file. The
current file is the file opened in the editor, i.e it has the input focus.
If no file is open in the editor the placeholders will not be replaced.
The examples in brackets show, how the placeholder will be replaced,
if the current file is "C:\My Documents\TxcTest\SubDir\AnotherTest.tex"
and the current project's main file is "C:\My Documents\TxcTest\JustATest.tex".
- %pc
- Will be replaced by the full path of the current file.
["C:\My Documents\TxcTest\SubDir\AnotherTest.tex"]
- %wc
- Will be replaced by the relative path of the current file.
["SubDir\AnotherTest.tex"]
- %dc
- Will be replaced by the directory of the current file.
["C:\My Documents\TxcTest\SubDir"]
- %nc
- Will be replaced by the name of the current file. The name includes
the file extension.
["AnotherTest.tex"]
- %tc
- Will be replaced by the title of the current file. The title does
not include the file extension.
["AnotherTest"]
- %ec
- Will be replaced by the extension of the current file.
["tex"]
- %bc
- Will be replaced by the base of the current file. The base includes
the directory followed by the file's title without the file extension.
["C:\My Documents\TxcTest\SubDir\AnotherTest"]
Placeholders with Slashes instead of Backslashes |
- %Pc
- Same as '%pm', but using slashes instead of backslashes.
["C:/My Documents/TxcTest/SubDir/AnotherTest.tex"]
- %Dc
- Same as '%dm', but using slashes instead of backslashes.
["C:/My Documents/TxcTest/SubDir"]
- %Bc
- Same as '%bm', but using slashes instead of backslashes.
["C:/My Documents/TxcTest/SubDir/AnotherTest"]
Placeholders for 8.3 path notation |
- %spc
- Same as '%pm', but using the 8.3 path notation.
["C:\MyDocu~1\TxcTest\SubDir\Anothe~1.tex"]
- %sdc
- Same as '%dm', but using the 8.3 path notation.
["C:\MyDocu~1\TxcTest\SubDir"]
- %snc
- Same as '%nm', but using the 8.3 path notation.
["Anothe~1.tex"]
- %stc
- Same as '%tm', but using the 8.3 path notation.
["Anothe~1"]
- %sec
- Same as '%em', but using the 8.3 path notation.
["tex"]
- %sbc
- Same as '%sbm', but using the 8.3 path notation.
["C:\MyDocu~1\TxcTest\SubDir\Anothe~1"]
Placeholders for 8.3 path notation with Slashes instead of
Backslashes |
- %sPc
- Same as '%spm', but using slashes instead of backslashes.
["C:/MyDocu~1/TxcTest/SubDir/Anothe~1.tex"]
- %sDc
- Same as '%sdm', but using slashes instead of backslashes.
["C:/MyDocu~1/TxcTest/SubDir"]
- %sBc
- Same as '%sbm', but using slashes instead of backslashes.
["C:/MyDocu~1/TxcTest/SubDir/Anothe~1"]
Placeholders referrening to a selection in the current file |
- %l
- Will be replaced with the line number, the cursor is placed in this
line in the current file.
The first line has the number 1.
- %s
- Will be replaced with the current selection in the current file.
If nothing has been selected this placeholder will be replaced by the
word the cursor is currently placed on.
Another placeholder is currently available:
- %%
- Will be replaced by the string '%'.