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.

Naming Conventions

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.

Other Placeholders

Another placeholder is currently available:

%%
  Will be replaced by the string '%'.