Inline search feature allows flexible formatting of search result
By default, the format for displaying a search result is fixed, e.g. a table with rows of topic name and topic summary. Use the
format="..." parameter to specify a customized format of the search result. The string of the format parameter is typically a bullet list or table row containing variables (i.e.
%SEARCH{ "food" format="| $topic | $summary |" }%).
Two paramters can be used to specify a customized search result:
1.
header="..." parameter
Use the header paramter to specify the header of a search result. It should correspond to the format of the format parameter. This parameter is optional. I.e.
header="| *Topic:* | *Summary:* |"
2.
format="..." parameter
Use the format paramter to specify the format of one search hit. I.e.
format="| $topic | $summary |"
Variables that can be used in the format string:
| Name: | Expands To: |
|---|
$n | New line |
$web | Name of the web |
$topic | Topic name |
$locked | LOCKED flag (if any) |
$date | Time stamp of last topic update, i.e. 20 Nov 2008 - 21:33 |
$isodate | Time stamp of last topic update, i.e. 2008-11-20T21:33Z |
$rev | Number of last topic revision, i.e. 1.4 |
$wikiusername | Wiki user name of last topic update, i.e. Main.JohnSmith |
$username | User name of last topic update, i.e. JohnSmith |
$summary | Topic summary |
$formfield(name) | The field value of a form field, i.e. $formfield(TopicClassification) would get expanded to PublicFAQ. This applies only to topics that have a TWikiForm |
$pattern(reg-exp) | A regular expression pattern to extract some text from a topic, i.e. $pattern(.*?\*.*?Email\:\s*([^\n\r]+).*) extracts the email address from a bullet of format * Email: .... |
Note: For
$pattern(reg-exp), specify a
RegularExpression that scans from start to end and contains the text you want to keep in parenthesis, i.e.
$pattern(.*?(from here.*?to here).*). You need to make sure that the integrity of a web page is not compromised, i.e. if you include a table make sure to include everything including the table end tag.
Write this:
%SEARCH{ "FAQ" scope="topic" nosearch="on" nototal="on" header=" * *Topic: Summary:*" format=" * [[$topic]]: $summary" }%
To get this:
NOTE: The most recent version of this FAQ is at TWiki:TWiki/TWikiFAQ.
Please ask support questions in the TWiki:Support web. The FAQs are here for frequently asked questions
including answers.
... form elided ...
Other places where you can find answers to your questions:
TWikiDocumentation: All you need to know to install and configure TWiki
TWikiTutorial: Get a jump start on using TWiki
GoodStyle: Things to consider when changing text
WikiSyntax, TextFormattingRules: A quick one-two guide to TWiki shorthand basics
TextFormattingFAQ: Answers to frequently asked questions about text styling in TWiki
If you can't find an answer, ask a question - post it in the TWiki:Support web
Back to: TWikiFAQ
--
TWikiGuest - 20 Nov 2008
The most frequently asked questions about text formatting are answered. Also, TextFormattingRules contains the complete TWiki shorthand system on one quick reference page.
Create a separator - a horizontal rule - by entering three dashes at the beginning of a blank line: =
=
You can create six sizes of headings - h1...h6 in HTML - by typing, from the beginning of a line, three dashes - , from one to six plus signs + , a space, and your heading text. The FAQ questions on this page are created with: =
You can insert a nested table of contents, generated from headings, by placing =
Write this in the Know web:
| *Topic:* | *OperatingSystem:* | *OsVersion:* |
%SEARCH{ "[T]opicClassification.*?value=\"[P]ublicFAQ\"" scope="text" regex="on" nosearch="on" nototal="on" format="| [[$topic]] | $formfield(OperatingSystem) | $formfield(OsVersion) |" }%
To get this:
Write this:
%SEARCH{ "__Back to\:__ TWikiFAQ" scope="text" regex="on" nosearch="on" nototal="on" header="TWiki FAQs:" format=" * $pattern(.*?FAQ\:[\n\r]*([^\n\r]+).*) [[$topic][Answer...]]" }%
To get this:
TWiki FAQs:
- How do I delete or rename a topic? Answer...
- Why does the topic revision not increase when I edit a topic? Answer...
- TWiki has a GPL (GNU General Public License). What is GPL? Answer...
- I've problems with the WebSearch. There is no Search Result on any inquiry. By clicking the Index topic it's the same problem. Answer...
- What happens if two of us try to edit the same topic simultaneously? Answer...
- I would like to install TWiki on my server. Can I get the source? Answer...
- So what is this WikiWiki thing exactly? Answer...
- Everybody can edit any page, this is scary. Doesn't that lead to chaos? Answer...
--
PeterThoeny? - 28 Nov 2001
Books RSS
