webgui/lib/WebGUI/i18n/English/Macros.pm
2009-08-10 15:17:21 +00:00

84 lines
3 KiB
Perl

package WebGUI::i18n::English::Macros;
use strict;
our $I18N = {
'macro name' => {
message => q|Macro Name|,
lastUpdated => 1112591288
},
'macro shortcut' => {
message => q|Macro Shortcut|,
lastUpdated => 1112591289,
},
'macro enabled header' => {
message => q|Macro Enabled?|,
lastUpdated => 1112591289,
context => q|Table heading in List of Macros help page. Short for "Is this Macro enabled?"|,
},
'macros list title' => {
message => q|Macros, List of Available|,
lastUpdated => 1112395935,
},
'macros list body' => {
message => q|<p>Making a macro available for use on your site is a two step process.</p>
<div>
<ol>
<li>The macro code should be in a macro folder in the WebGUI sourcecode or in a custom folder that ends with lib/WebGUI/Macro/ (e.g. /data/custom/lib/WebGUI/Macro). When such a custom folder is used, make sure there is a file preload.custom which indicates the presence of this custom code. With the given example a line like this should exist: /data/custom/lib</li>
<li>The macro must be enabled in your WebGUI.conf file, in the "macros" section. In that section, you can assign a shortcut that is different from the macro's name.</li>
</ol>
</div>
<p>The table below shows which macros are installed on your site and which have been configured in your WebGUI.conf file.</p>
|,
context => 'Content for dynamically generated macro list',
lastUpdated => 1249918049,
},
'macro enabled' => {
message => q|This macro is enabled in the WebGUI configuration file and can be used on this site.|,
lastUpdated => 1046656837,
},
'macro disabled' => {
message => q|This macro is not enabled in the WebGUI configuration file and cannot be used on this site.|,
lastUpdated => 1046656837,
},
'macros using title' => {
message => q|Macros, Using|,
lastUpdated => 1046656837
},
'macros using body' => {
message => q|<p>WebGUI macros are used to create dynamic content within otherwise static content. For instance, you may wish to show which user is logged in on every page, or you may wish to have a dynamically built menu or crumb trail.
</p>
<p>Macros always begin with a caret (&#94;) and follow with at least one other character and end with a semicolon (;). Some macros can be extended/configured by taking the format of <b>&#94;x</b>("<i>config text</i>");. When providing multiple arguments to a macro, they should be separated by only commas:<br />
<b>&#94;x</b>(<i>"First argument",2</i>);
</p>
<p>You may nest Macros, but only if they do not contains commas or quotes. You should follow the following guidelines:
<ul>
<li>Macros which contain HTML or javascript cannot be nested.</li>
<li>Macros which return user input that may contain quotes or commas may be nested, but it's dangerous.</li>
<li>If your user input must contain quotes and/or commas, it is recommended that the HTML encodings for comma and quote be used.</li>
</ul>
</p>
|,
lastUpdated => 1168556567,
},
'topicName' => {
message => q|Macros|,
lastUpdated => 1128920014,
},
};
1;