public override void Help(HelpDetails details)
{
details.Comments = "This command makes use of Revolver expressions. See the extended help topic 'expressions' for more detail (help expressions)";
details.AddExample("($var$ > 15 as number) (echo is it larger)");
details.AddExample("(@title ? company) (sf title (the new title))");
}
public override void Help(HelpDetails details)
{
details.AddExample("(this is input) (^is$) (id)");
details.AddExample("(this is input) (^(is)$) ($1id)");
details.AddExample("(this is input) \\s -");
details.AddExample("(This Is Input) is in -c");
}
public override void Help(HelpDetails details)
{
details.Comments = "One of language or -d must be used";
details.AddExample("en");
details.AddExample("zg-CH");
details.AddExample("-d");
details.AddExample("-f kk");
}
public static HelpDetails UseEnvironmentVariable()
{
HelpDetails details = new HelpDetails();
details.Description = "Allows substitution of environment variables into commands";
details.Usage = "$name$";
details.AddParameter("name", "The name of the environment variable");
details.AddExample("$prevpath$");
details.AddExample("$myvar$");
details.AddExample("echo $prevpath$");
return details;
}
public static HelpDetails SubCommand()
{
HelpDetails details = new HelpDetails();
details.Description = "Allows the evaluation of a command to be used as a parameter of another command";
details.Usage = "< command";
details.AddParameter("command", "The command to evaluate");
details.AddExample("sf title < (gf -f title ../..)");
details.AddExample("find echo < (ga -a key) < (ga -a id)");
details.AddExample("cd < (ga -a templateid)");
return details;
}
public static HelpDetails Prompt()
{
HelpDetails details = new HelpDetails();
details.Description = "The prompt is set through the environment variable 'prompt'";
//details.Usage = "[Any characters] [%path%] [%itemname%] [%ver%] [%db%] [%lang%] [%date%] [%time%] >";
details.Usage = "[Any characters] [%path%] [%itemname%] [%ver%] [%db%] [%lang%] [%langcode%] [%date%] [%time%]";
details.AddParameter("%path%", "Provides the full path of the current item");
details.AddParameter("%itemname%", "Provides the name of the current item");
details.AddParameter("%ver%", "Provides the version number of the current item");
details.AddParameter("%db%", "Provides the name of the current database");
details.AddParameter("%lang%", "Provides the title of the current language");
details.AddParameter("%langcode", "Provides the code of the current language");
details.AddParameter("%date%", "Provides the current date");
details.AddParameter("%time%", "Provides the current time");
//details.Comments = "The prompt must end with a right angle bracket '>'";
details.AddExample("%db%:%path% >");
details.AddExample("%date% %lang%|%itemname% >");
return details;
}
public HelpDetails GetScriptHelp(string name)
{
var scriptsItems = FindScriptItems(name);
if (scriptsItems == null)
return null;
if (scriptsItems.Length == 1)
{
var scriptItem = scriptsItems[0];
HelpDetails details = new HelpDetails();
if (scriptItem[Constants.Fields.Description] != string.Empty)
details.Description = scriptItem[Constants.Fields.Description];
if (scriptItem[Constants.Fields.Usage] != string.Empty)
details.Usage = scriptItem[Constants.Fields.Usage];
if (scriptItem[Constants.Fields.Comments] != string.Empty)
details.Comments = scriptItem[Constants.Fields.Comments];
Item[] parameters = scriptItem.Axes.SelectItems("*[@@templatekey='script help parameter']");
if (parameters != null)
{
for (int i = 0; i < parameters.Length; i++)
{
details.AddParameter(parameters[i][Constants.Fields.Name], parameters[i][Constants.Fields.Description]);
}
}
Item[] examples = scriptItem.Axes.SelectItems("*[@@templatekey='script help example']");
if (examples != null)
{
for (int i = 0; i < examples.Length; i++)
{
details.AddExample(examples[i][Constants.Fields.Example]);
}
}
return details;
}
if (scriptsItems.Length > 1)
{
var scriptPaths = from script in scriptsItems
select script.Paths.FullPath;
throw new MultipleScriptsFoundException(scriptPaths);
}
return null;
}
public override void Help(HelpDetails details)
{
details.Comments = "If using a path, zero based indexes can be used for instances of items having the same name. Indexes can also be used without names to select children by index. Brackets are not required to escape paths with spaces in item names";
details.AddExample("item1");
details.AddExample("item1/item2");
details.AddExample("../item1");
details.AddExample("{4763CBB5-54A2-4D50-BF41-64AA4DA881A5}");
details.AddExample("samename[2]");
details.AddExample("[3]");
details.AddExample("/path/to my/ item");
}
public HelpDetails GetScriptHelp(string name)
{
var scriptSource = GetScript(name);
// Check if the script exists. If not, return null
if (scriptSource == null)
return null;
var helpData = ExtractHelpData(scriptSource);
var details = new HelpDetails();
foreach (var entry in helpData)
{
switch (entry.Key.ToLower())
{
case "comments":
details.Comments += entry.Value;
break;
case "description":
details.Description += entry.Value;
break;
case "example":
details.AddExample(entry.Value);
break;
case "parameter":
var idx = entry.Value.IndexOf(HelpCommentDelimiter);
if (entry.Value.Length > idx)
{
var key = entry.Value.Substring(0, idx);
var desc = entry.Value.Substring(idx + 1);
details.AddParameter(key, desc);
}
break;
case "usage":
details.Usage = entry.Value;
break;
}
}
return details;
}
public static HelpDetails Expressions()
{
HelpDetails details = new HelpDetails();
details.Description = "Allows logical testing against fields and attributes";
details.Usage = "[@field | @@attribute] operator [@field | @@attribute] [as cast] [with flag] [and | or expression]";
details.AddParameter("operator", "How to compare the 2 arguments. Must be one of = (equals), < (less than), > (greater than), != (not equal), <= (less or equal), >= (greater or equal), [ (starts with), ] (ends with), ? (contains), !? (doesn't contain).");
details.AddParameter("cast", "Treat the argument as a specific data type. Must be one of string, number, date.");
details.AddParameter("flag", "Treat the argument in a specific way. Must be one of ignorecase, ignoredecimal, round, ceiling, floor.");
details.AddParameter("expression", "Another expression. The operator (and, or) is used to determine the overall result");
details.Comments = "Expressions are used as arguments to other commands such as find.";
details.AddExample("@title != hello");
details.AddExample("(@__created by) = admin with ignorecase");
details.AddExample("@price >= 70 as number with round and @title = bananas with ignorecase");
details.AddExample("@@key = a or @@key = b or @@key = c");
details.AddExample("@__created = 12/01/2007 as date");
details.AddExample("@@name [ a");
return details;
}
public override void Help(HelpDetails details)
{
details.Comments = "If 'command' is not provided the available commands will be listed";
details.AddExample("submit");
}
public override void Help(HelpDetails details)
{
details.AddExample("-n < (echo -i -f file.txt) (echo $current$)");
details.AddExample("-s , 1,2,3,4 (touch -t document $current$)");
details.AddExample("-s | < (gf -f multilist) (ga -a name $current$)");
}
public override void Help(HelpDetails details)
{
details.AddExample("(title:home) pwd");
details.AddExample("web (title:home AND text:lorem) (ga -a id)");
details.AddExample("(_created:[20120903 TO 20120917]) pwd");
details.AddExample("-v -l text:someterm pwd");
details.AddExample("-so core name:sitecore");
}
public override void Help(HelpDetails details)
{
details.Comments += "Extended paths can be used to specify a specific version.";
details.AddExample("-ao");
details.AddExample("item1/item2");
details.AddExample("-al");
details.AddExample("::4");
}
public override void Help(HelpDetails details)
{
details.AddExample("(my item) < ls");
details.AddExample("publishing < ps");
}
public override void Help(HelpDetails details)
{
details.AddExample("");
details.AddExample("core[items]");
details.AddExample("core[items] somekey");
details.AddExample("core[items] somekey -c");
details.AddExample("core[items] -c");
}
public override void Help(HelpDetails details)
{
details.AddExample("");
details.AddExample("(missing parameter)");
}
public override void Help(HelpDetails details)
{
var comments = new StringBuilder();
Formatter.PrintLine("If echoing to a file and the filename given is not absolute the file will be written to the temp folder.", comments);
comments.Append("-a and -i cannot be used together");
details.Comments = comments.ToString();
details.AddExample("this is input");
details.AddExample("hello");
details.AddExample("$prevpath$");
details.AddExample("-f c:\\temp\\output.txt This is some output");
details.AddExample("-f temp.xml < gi");
details.AddExample("-a -f temp.txt < gf");
details.AddExample("-i -f c:\\temp\\item.xml");
}
public override void Help(HelpDetails details)
{
details.Comments = "One of -a or -r must be specified";
details.AddExample("-a a-b-c - d");
details.AddExample("-r {945F96B9-5A7D-459C-8240-3A61362A0D32}|{F77216B8-5740-4680-A93A-227D0F897455} | {945F96B9-5A7D-459C-8240-3A61362A0D32}");
}
public override void Help(HelpDetails details)
{
details.AddExample("jp");
details.AddExample("-o da");
details.AddExample("en-US ../path1");
details.AddExample("-f title da");
}
public override void Help(HelpDetails details)
{
details.AddExample("(<a id=\"myid\"></a>) (//@id)");
details.AddExample("-h (<div><h1>title</h1><br><div class=top>the top</div></div>) //div[@class='top']");
details.AddExample("-v (<a>val<b>subval</b></a>) ./a");
}
public override void Help(HelpDetails details)
{
details.AddExample("name (new name)");
details.AddExample("name (new $prev) ../../a");
details.AddExample("template {76036F5E-CBCE-46D1-AF0A-4143F9B557AA}");
}
public override void Help(HelpDetails details)
{
var comments = new StringBuilder();
Formatter.PrintLine("If 'targets' or 'languages' is not supplied the item will be published to all.", comments);
comments.Append("Only one of -i, -s, -f or -r may be used.");
details.Comments = comments.ToString();
details.AddExample("-t web");
details.AddExample("-t web|live");
details.AddExample("-l en|de");
details.AddExample("-t (target 1|target 2) -l en");
details.AddExample("-f -w");
}
public override void Help(HelpDetails details)
{
details.AddExample(string.Empty);
details.AddExample("myclone");
details.AddExample("/sitecore/content/home/myclone");
details.AddExample("-s myclone");
details.AddExample("myclone ../a");
details.AddExample("-u");
details.AddExample("-u /sitecore/content/home/myclone");
details.AddExample("-a");
details.AddExample("-r /sitecore/content/home/myclone");
}
public override void Help(HelpDetails details)
{
details.AddExample("-i {493B3A83-0FA7-4484-8FC9-4680991CF743} pwd");
details.AddExample("-i {493B3A83-0FA7-4484-8FC9-4680991CF743}|{543B3A83-0FA7-4484-8FC9-4680991CF797} pwd");
details.AddExample("-t {493B3A83-0FA7-4484-8FC9-4680991CF743} (sf title hi)");
details.AddExample("-t Document (sf title hi)");
details.AddExample("-b MyBranch (sf title hi)");
details.AddExample("-f title (a page for .*) (sf title hi)");
details.AddExample("-f * sitecore pwd");
details.AddExample("-f title (a page for .*) -fc (sf title hi)");
details.AddExample("-r -f title (a page for .*) (sf title hi) /sitecore/content/home");
details.AddExample("-t {493B3A83-0FA7-4484-8FC9-4680991CF743} -f title hi (sf title welcome)");
details.AddExample("-ns -e (@__created > 3/1/2007 as date) pwd");
details.AddExample("-so -e (@__created > 3/1/2007 as date)");
}
public override void Help(HelpDetails details)
{
var comments = new StringBuilder();
Formatter.PrintLine("If only a single parameter is supplied it is treated as the targetitem parameter. The first example below has the effect of copying the layout from the current item to the item given as the parameter.", comments);
comments.Append("Both source and target device parameters must be used if either is used.");
details.Comments = comments.ToString();
details.AddExample("item2");
details.AddExample("item1 ../item2");
details.AddExample("-sd default -td printer");
details.AddExample("-sd default -td printer item2");
}
public override void Help(HelpDetails details) {
details.AddExample("/sitecore/content/home/a");
}
public override void Help(HelpDetails details)
{
details.AddExample("-r");
details.AddExample("../a/bb");
}
public override void Help(HelpDetails details)
{
details.AddExample("10 2");
details.AddExample("36 6");
}
public override void Help(HelpDetails details)
{
details.Comments = "Either one of 'template', 'branch', 'xml' or -v argument must be provided. Name must be provided for template or branch.";
details.AddExample("-t {493B3A83-0FA7-4484-8FC9-4680991CF743} newitem1");
details.AddExample("-t Document newitem1");
details.AddExample("-b Article newitem1");
details.AddExample("-b Article newitem1 /item1");
details.AddExample("-x <item xml data>");
details.AddExample("-id -x <item xml data>");
details.AddExample("-v");
}
