From 3530710ef41a384313727bdf697d89615ac99df6 Mon Sep 17 00:00:00 2001 From: PeterThoeny Date: Sun, 18 Jan 2004 10:49:03 +0000 Subject: [PATCH] none --- Main/WebSearchAdvanced.mdwn | 1 + TWiki/SearchHelp.mdwn | 63 ++++++++++++++++++++++++++++++++++++++++ TWiki/WebHome.mdwn | 9 +++++- TWiki/WebSearch.mdwn | 69 +++++++++++--------------------------------- TWiki/WebSearchAdvanced.mdwn | 53 ++++++++++++++++++++++++++++++++++ 5 files changed, 142 insertions(+), 53 deletions(-) create mode 100644 Main/WebSearchAdvanced.mdwn create mode 100644 TWiki/SearchHelp.mdwn create mode 100644 TWiki/WebSearchAdvanced.mdwn diff --git a/Main/WebSearchAdvanced.mdwn b/Main/WebSearchAdvanced.mdwn new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/Main/WebSearchAdvanced.mdwn @@ -0,0 +1 @@ + diff --git a/TWiki/SearchHelp.mdwn b/TWiki/SearchHelp.mdwn new file mode 100644 index 0000000..4a2f138 --- /dev/null +++ b/TWiki/SearchHelp.mdwn @@ -0,0 +1,63 @@ +# Search Help + +
+ +
+ +## Basic Search Form + +The [[WebSearch]] form offers basic search features: + +- Search field: Enter one or more keywords +- All webs flag: Check the flag if you want to search all public webs, not just the current web +- Scope: Select if you want to search the topic title, text body or both + +The search is keyword based like in a typical search engine: + +- Specify word(s) you want to find +- Multiple words form an **AND** search, `intranet web service` returns all pages that have the three words anywhere in the page +- Optionally specify plus signs for **AND** search, like `intranet +web +service` +- Enclose words in double quotes to form a **literal search**, like `"web service"` +- Specify a minus sign to **exclude** a word, like `soap -shampoo` +- Use double quotes if you want to search for a leading minus sign, like `"-nowarn"` +- **Stop words** are excluded from a keyword search: + - Stop words are common words and characters such as `"how"` and `"where"`, defined in the SEARCHSTOPWORDS setting in the [[TWikiPreferences]] + - If you want to search for a word in the stop word list, prefix the word with a plus sign +- **Example:** To search for all topics that contain `"SOAP"`, `"WSDL"`, a literal `"web service"`, but not `"shampoo"`,%BR% enter this: `soap +wsdl "web service" -shampoo` + +## Advanced Search Form + +The [[WebSearchAdvanced]] form offers more control over search. + +TWiki supports three types of searches: + +- `keyword`: The basic search type +- `literal`: Simple search where text is searched literally +- `regex`: A [[RegularExpression]] search for power users + +TWiki's regex search is a set of regular expression patterns: + +- Patterns are delimited by a semicolon +- An AND search is performed for the list of patterns +- An exclamation point preceeding a pattern indicates an AND NOT search; use it to exclude a pattern, like `!web service` +- If you want to search for a semicolon or an exclamation point, escape them with a leading backslash, like `\!shampoo` +- **Example:** To search for all topics that contain `"SOAP"`, `"WSDL"`, a literal `"web service"`, but not `"shampoo"`,%BR% enter this: `soap;wsdl;web service;!shampoo` + +## Formatted Searches + +You can embed a nicely [[formatted search|Main/FormattedSearch]] in a topic by using the `%SEARCH{}%` variable described in [[TWikiVariables]]. + +## Search Preferences + +The [[TWikiPreferences]] has these settings: + +- `SEARCHDEFAULTTTYPE`: Default search type for search forms which calls the `search` script +- `SEARCHVARDEFAULTTYPE`: Default search type for `%SEARCH{}` variable +- `SEARCHSTOPWORDS`: List of stop words + +-- TWiki:Main.PeterThoeny - 18 Jan 2004 diff --git a/TWiki/WebHome.mdwn b/TWiki/WebHome.mdwn index 8da1d34..4437158 100644 --- a/TWiki/WebHome.mdwn +++ b/TWiki/WebHome.mdwn @@ -6,7 +6,13 @@ Powered by TWiki
The official TWikiTM
site is http://twiki.org/ - +
+ +

TWiki User's Guide

@@ -27,6 +33,7 @@
  • [[Main/TWikiTutorial]]: A compact, 20-minute TWiki primer
  • [[Main/TWikiSite]]: Instant overview - first, there was Wiki
  • [[Main/TWikiTopics]]: Customize, rename, move, or delete TWiki topics
    • +
  • [[Main/SearchHelp]]: Tips and help on search
  • [[Main/GoodStyle]]: Working tips for an open collaboration environment
  • [[Main/TWikiShorthand]]: All of the TWiki shorthand basics
  • [[Main/TextFormattingRules]]: Scan all TWiki text formatting rules on one page
    • diff --git a/TWiki/WebSearch.mdwn b/TWiki/WebSearch.mdwn index 8c19ba4..b42759a 100644 --- a/TWiki/WebSearch.mdwn +++ b/TWiki/WebSearch.mdwn @@ -1,66 +1,31 @@ -
    -
      -
    • Simple search: - - - - - - - - -
      Topic text (body)     All webs (not only %INCLUDINGWEB% web)
      Topic name [[TWiki/BookView]]

      %T% Note: %WIKITOOLNAME% search is literal, e.g. if you search for sushi bar
      it will search literally for "sushi bar".
      • -
    -
    - -
    -
      -
    • Advanced search: - - - - - -
      Topic text (body)     Search
      -
      • -
    -

    web(s)

    - - - - - - -
    Topic name Sort by in reversed order

    - + +
    - - - + + - - - - - - - - +
    Make search: Case sensitive [[TWiki/RegularExpression]] search (semicolon ';' for and) %BR% All public webs +
      +
    • [[Main/SearchHelp]]
      • +
    • [[INCLUDINGWEB/WebSearchAdvanced]]
      • +
    +
    Don't show: search string summaries     total matches
    Do show: [[TWiki/BookView]] locked topic   topics (result count) Text body   Topic title   Both
    +# TWiki Installation Error + +Incorrect format of search template (missing sections? There should be 4 %SPLIT% tags) + - **[Topic index](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=\.*)**: List of %INCLUDINGWEB% topics in alphabetical order.
    **|[All](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=\.*)|[A](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ea)|[B](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eb)|[C](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ec)|[D](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ed)|[E](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ee)|[F](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ef)|[G](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eg)|[H](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eh)|[I](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ei)|[J](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ej)|[K](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ek)|[L](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5El)|[M](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Em)|[N](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5En)|[O](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eo)|[P](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ep)|[Q](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eq)|[R](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Er)|[S](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Es)|[T](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Et)|[U](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eu)|[V](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ev)|[W](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ew)|[X](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ex)|[Y](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ey)|[Z](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ez)|
    | [All](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&bookview=on&search=\.*)** topics in [[BookView]] **|** -- **Jump to topic**: If you already know the name of the topic, enter the name of the topic at the second line of this page. +- **Jump to topic**: If you already know the name of the topic, enter the name of the topic into the [[GoBox]] at the top -- ** [[WebChanges]]**: Find out what topics in %INCLUDINGWEB% have changed recently. +- ** [[WebChanges]]**: Find out what topics in %INCLUDINGWEB% have changed recently - **[[How to edit text|TWiki/GoodStyle]]**: - Make changes to topics in [[GoodStyle]], - Learn the [[TextFormattingRules]], and - - Have a look at the [[TextFormattingFAQ]]. + - Have a look at the [[TextFormattingFAQ]] diff --git a/TWiki/WebSearchAdvanced.mdwn b/TWiki/WebSearchAdvanced.mdwn new file mode 100644 index 0000000..a9882d5 --- /dev/null +++ b/TWiki/WebSearchAdvanced.mdwn @@ -0,0 +1,53 @@ +
    +
      +
    • Advanced search: + + + + + +
      Topic text (body)     Search
      +
      • +
    +

    web(s)

    + + + + + + +
    Topic name Sort by in reversed order

    + + + + + + + + + + + + + + + + +
    Make search: Case sensitive [[TWiki/RegularExpression]] search (semicolon ';' for and)
    Don't show: search string summaries     total matches
    Do show: [[TWiki/BookView]] locked topic   topics (result count)
    +
    + +- **[Topic index](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=\.*)**: List of %INCLUDINGWEB% topics in alphabetical order.
    **|[All](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=\.*)|[A](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ea)|[B](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eb)|[C](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ec)|[D](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ed)|[E](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ee)|[F](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ef)|[G](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eg)|[H](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eh)|[I](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ei)|[J](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ej)|[K](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ek)|[L](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5El)|[M](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Em)|[N](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5En)|[O](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eo)|[P](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ep)|[Q](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eq)|[R](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Er)|[S](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Es)|[T](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Et)|[U](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Eu)|[V](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ev)|[W](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ew)|[X](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ex)|[Y](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ey)|[Z](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&search=%5Ez)|
    | [All](http://www.dementia.org/twiki//search/%INCLUDINGWEB%/?scope=topic®ex=on&bookview=on&search=\.*)** topics in [[BookView]] **|** + +- **Jump to topic**: If you already know the name of the topic, enter the name of the topic into the [[GoBox]] at the top + +- ** [[WebChanges]]**: Find out what topics in %INCLUDINGWEB% have changed recently + +- **[[How to edit text|TWiki/GoodStyle]]**: + - Make changes to topics in [[GoodStyle]], + - Learn the [[TextFormattingRules]], and + - Have a look at the [[TextFormattingFAQ]] + +-- TWiki:Main.PeterThoeny - 18 Jan 2004 -- 1.9.4