维基百科:AutoWikiBrowser/查找和替换
![]() | 这是自动维基浏览器说明书的搜寻和取代章节。
|
章节: | 核心 · 数据库扫描器 · 搜寻和取代 · 规律表达式 · 常规修正(General fixes) |
---|
一般用法
搜寻和取代(Find and replace):
- Ignore external/Interwiki links, images, nowiki, math, <!-- -->(忽略外部链接/跨维基链接、图像、nowiki、数学符号、<!-- -->) 如果选取此项,AWB将不会搜寻和取代这些项目。呼叫
HideText.Hide()
。参见Hide documentation. - Ignore templates, refs, link targets, and headings(忽略模板、引用、链接目标和标题):如果选取此项,AWB将不会搜寻和取代上一项与此项的项目。呼叫
HideText.HideMore()
– see HideMore documentation. - Add replacements to edit summary(将取代添加到编辑摘要)– 如果选中,则AWB会将所做的取代添加到编辑摘要中,其长度限制为255 bytes。使用Wiki语法字符时要格外小心,这会使编辑摘要无效。
- Search:(搜寻):在搜寻框输入搜寻条件。
- Go(开始):搜寻在搜寻框输入的内容。
- Clear(清除):清除所有规则。
- OK:接受列出的规则并关闭窗口。
- Cancel(取消):取消任何规则更改并关闭窗口。
![](http://images.weserv.nl/?url=//upload.wikimedia.org/wikipedia/commons/6/66/AWBFARBar.png)
- Find:要找的文字,亦可用以下关键字。
- Replace with:要取代的文字,特殊fields include:
$1
、$2
等:如搜寻框的文字是规律表达式(regex)且已选取regex就会用搜寻框的值- 规律表达式每对括号对应一串字串,如搜寻
(123)4(56)78
,$1
对应123;$2
对应56
- AWB关键字会以其值取代,如以下例子。这些关键字可用于进阶。
关键字 value for
Albert Einsteinvalue for
Wikipedia:AutoWikiBrowser/Find and replace%%key%%
(human name sort key)Einstein, Albert Replace, Autowikibrowser/Find And %%title%% Albert Einstein Wikipedia:AutoWikiBrowser/Find and replace %%fullpagename%% Albert Einstein Wikipedia:AutoWikiBrowser/Find and replace %%pagename%% Albert Einstein AutoWikiBrowser/Find and replace %%subpagename%% Albert Einstein Find and replace %%basepagename%% Albert Einstein AutoWikiBrowser %%namespace%% Wikipedia %%server%% http://en.wikipedia.org http://en.wikipedia.org %%servername%% en.wikipedia.org en.wikipedia.org %%scriptpath%% /w /w
- 用
\n
搜寻新行。自AWB Template:Awbsvn起可用于普通及规律表达式搜寻。截至March 2014年[update], unless you have compiled AWB yourself \n matches newlines only when using regexes.
- 用
- Case Sensitive:如选取,就分大小写。
- Regex:如选取,表示搜寻和取代的是规律表达式。
- Multiline:如选取,表示regex字元“^”和“$”分别符合行首和行尾,而非只是页首和页尾。在某些programming contexts这等同视页面为多行字串。
- Singleline:如选取,表示regex字元“.”符合全部字元,包括“\n”。在某些programming contexts这等同视页面为单行字串。“多行”和“单行”选项分别影响不同特殊字元的解读方式且不互斥。
- Minor:如选取,AWB会视此规则为minor. By using "Skip if: only minor replacement made" AWB will skip the article if the only F&R rules which made a replacement were minor ones. By "replacement made" it means that the rule matched. It does not mean that a change was made. The replacement may be with exactly the same text as was matched. In such case a replacement was made, but the replacement was exactly the same text as was already present in the article. Currently, F&R rules marked as minor are not acted upon when the command to re-parse the page is made (F5 in the edit box, or from the edit box context menu).
- After fixes:如选取,AWB will apply this rules after all other rules (general fixes, typos etc.). Otherwise It will apply this rule before all other rules.
- Enabled:如选取表示启用此规则;如无选取则停用。
进阶用法
该章节将告诉您如何为AWB设置特殊的搜寻和取代条件,可用普通文本或规律表达式来搜寻。
- Main Menus:主选单
- New:允许您选择规则(Rules)或子规则(Subrules)。请参阅下面的规则类型。
- Rule:各种编辑命令,包括撤消(Undo)、重做(Redo)、剪下(Cut)、复制(Copy)、贴上(Paste)、删除(Delete)和刷新颜色
- Types of rules
- Rule each one of these can be nested so that if the upper most rule is satisfied then AWB will process the next rule below.
- Find and replace
- In template call
- Template parameter:Regular rules, AWB will be process these rules (if enabled) against the text of a page.
- In Template Call Rule:These rules will only be processed if within a template.
- Template Parameter Rule:These rules allow you to change template parameter names.
- Subrule
- Rule:Same as a regular rule, but only acted upon if the regular rule is acted upon.
- In Template Call Rule:Same as a regular in template call rule, but only acted upon if the regular in template call rule is acted upon.
- Template Parameter Rule:Same as a regular template parameter rule, but only acted upon if the regular template parameter rule is acted upon.
- Name:This allows you to name your rule so that you can recognize it.
- Enabled:If checked the rule is enabled. If unchecked this rule will be ignored by AWB. Unchecked rules will be highlighted in red in the list of rules.
- Type
- Entire text:lets you search with the entire text string.
- Inside template calls {{..}}:specifies only search within a template. Each template call within the article text will be processed; if there are nested templates, all levels of nested templates will be processed, so for example with {{a|1={{b|2={{c|3=text}}}}}} rules will be processed against {{a|1={{b|2={{c|3=text}}}}}} and {{b|2={{c|3=text}}}} and {{c|3=text}} in turn.
- Find:In this section you enter your search criteria. If you check the Regular expression box on the bottom of the page, the criteria you enter here will be acted on as it is a regular expression. Otherwise it will be searched as it were regular text case insensitive.
- Replace with::The criteria you place in this box will be replaced with what was found in the Find section.
- Regular expression:If checked indicates to AWB that the find criteria is a regular expression.
- Case sensitive:If checked indicates to AWB that the find criteria is case sensitive.
- Multiline:If checked, this indicates to AWB that the regex characters "^" and "$" so that they match at the beginning and the end of lines respectively, not just the beginning and end of a whole string.
- Single line:If checked, this indicates to AWB that the regex character "." matches every character. Instead of every character except "\n".
- Apply # times:Used for unusual circumstances when it is useful to instruct AWB to iteratively apply the transformation more than once to the same line.
- If
- Contains:The page would be checked for the inserted text. If it contains it, AWB would apply the find and replace rule which is defined in the other "Find" tab.
- Not Contains: The page would be checked for the inserted text. If it doesn't contain it, AWB would apply the find and replace rule which is defined in the other "Find" tab.
- Regular expression:If checked indicates to AWB that the find criteria is a regular expression.
- Case sensitive:If checked indicates to AWB that the find criteria is case sensitive.
- Multiline:If checked, this indicates to AWB that the regex characters "^" and "$" so that they match at the beginning and the end of lines respectively, not just the beginning and end of a whole string.
- Single line:If checked, this indicates to AWB that the regex character "." matches every character. Instead of every character except "\n".
Template substitution
When you are editing an article, and you add "subst:" to the beginning of a template name (like this: {{subst:XYZ}}), the template's wikicode is pasted into the wikicode of the article (when you save), rather than merely displayed (transcluded) onto the screen. That is, the template name (and curly brackets) are replaced (substituted) by the contents of the template. This is called substitution.
If you don't know what a template is, see Help:Template. For a more detailed description of substitution, see Wikipedia:Substitution.
The nice thing is, with the "template substitution" feature, AWB will add the "subst:" for you, so you don't have to do it by hand. Just list the names of the templates you want "substituted" in the box.
- Templates to substitute:One per line, specify the name of each template you wish to be "substituted". They can be the name of any existing template. Curly brackets and the namespace are optional. For example:
- ABC1 (but {{ABC1}}, or Template:ABC1 will also work)
- ABC2
- ABC3
- XYZ
- Abracadabra
- Alakazam
- Turn this rabbit into a ham
- (etc.)
- When you press "start", AWB will look for each template name (in articles it will be surrounded with curly brackets) and will replace it (and the curlies) with the entire contents of the template (its wikitext). If parameters are included in a template instance it finds, such as {{Alakazam|scooby|doo}}, AWB will run the template and place the resulting output in the article.
- Note that if you look in "diff" at the changes, the template will be substituted in there.
- Ignore external/interwiki links, images, nowiki, math and <!-- -->:If checked AWB will mask these items so that find & replace entries are not applied to them. Calls
HideText.Hide()
– see Hide documentation. - Expand recursively:If template is a redirect, get the subst'd of its target and replaces with that
- Include comment with template:Includes a comment with the template name - <!-- Template:Test -->
- Clear:Clears the contents of the "Templates to substitute box"
- Reset:Sets the Template list back to whatever was entered when ok was last pressed
- OK:Commits the lines to be used for reset. Closes the window
- Cancel:Cancel and close the window
- It is unnecessary to use this feature to substitute the templates listed here, which will be automatically substituted if "General fixes" is turned on.
Order of procedures
AWB performs these actions in the following order:
- Normal Find and Replace (in order listed)
- Advanced Find and Replace (per rules specified)
- Template Substitution
- General Fixes & Typos
- Normal Find and Replace rules marked as to occur after General Fixes
保存并恢复搜寻取代格式(Saving and restoring find-and-replace specifications)
The values you specify in the Find and replace entries are saved when you use the "Save settings" command under the "File" menu (along with other settings). The current entries are erased and the saved ones are restored when you use the "Open settings..." or "Recent settings..." commands.
There is no way to import new Find and replace entries other than directly editing a "settings" file of the kind generated by the "Save settings" command (and then opening it as a settings file). This file is in XML format and so appears as editable text if opened in a text editor.
A list of user contributed settings is available.