Recent Changes - Search:

Contents

Site

Help

« may 2014 · sep 2014 »

    add a calendar item

    Help / Search

    Help.Search History

    Hide minor edits - Show changes to output

    2013-03-01 20:17 [UTC-7] by Blue Hell -
    Changed lines 15-18 from:
    *Find [[Help.Search?action=search&q=%22-Talk%22 | all '-Talk' pages]]
    *Find [[Help.Search?action=search&q=%2f | all pages]]
    *Find [[Site.AllRecentChanges | {+all+} recent changes]]
    *See all page view [[Site.PageViews | counters]]
    to:
    (:include Site.SpecialPages:)
    2013-03-01 20:10 [UTC-7] by Blue Hell -
    Added line 18:
    *See all page view [[Site.PageViews | counters]]
    2013-02-26 17:42 [UTC-7] by Blue Hell -
    Changed line 17 from:
    *Find [[Site.AllRecentChanges | all recent changes]]
    to:
    *Find [[Site.AllRecentChanges | {+all+} recent changes]]
    2013-02-25 17:34 [UTC-7] by Blue Hell -
    Changed line 15 from:
    *Find all [[Help.Search?action=search&q=%22-Talk%22 | -Talk pages]]
    to:
    *Find [[Help.Search?action=search&q=%22-Talk%22 | all '-Talk' pages]]
    Changed line 17 from:
    *Find all [[Site.AllRecentChanges | recent changes]]
    to:
    *Find [[Site.AllRecentChanges | all recent changes]]
    2013-02-25 17:33 [UTC-7] by Blue Hell -
    Added line 17:
    *Find all [[Site.AllRecentChanges | recent changes]]
    2013-02-25 17:31 [UTC-7] by Blue Hell -
    Changed lines 15-16 from:
    Find all [[Help.Search?action=search&q=%22-Talk%22 | -Talk pages]]
    Find [[Help.Search?action=search&q=%2f | all pages]]
    to:
    *Find all [[Help.Search?action=search&q=%22-Talk%22 | -Talk pages]]
    *Find [[Help.Search?action=search&q=%2f | all pages]]
    2013-02-25 17:31 [UTC-7] by Blue Hell -
    Added line 16:
    Find [[Help.Search?action=search&q=%2f | all pages]]
    2013-02-25 17:30 [UTC-7] by Blue Hell -
    Changed line 15 from:
    Find all [[action=search&q=%22-Talk%22 | -Talk pages]]
    to:
    Find all [[Help.Search?action=search&q=%22-Talk%22 | -Talk pages]]
    2013-02-25 17:29 [UTC-7] by Blue Hell -
    Added lines 14-15:

    Find all [[action=search&q=%22-Talk%22 | -Talk pages]]
    2013-02-02 09:35 [UTC-7] by Blue Hell -
    Changed line 2 from:
    (:searchbox:)
    to:
    (:searchbox size=120:)
    2013-02-02 09:34 [UTC-7] by Blue Hell -
    Changed lines 1-76 from:
    (:description A page for advanced and customized search options:)
    (:Summary:Targeting and customising search results:)
    (:if !equal {$Action} "search":)
    [[#example]]
    !!!!Try it: this page generates custom searches
    Any search that is run from this page will automatically generate pre-defined sets of search results that: '''''target''''' different clusters of pages (documentation, cookbook and PITS, if available); use '''''customized''''' formats, content and ordering; and '''''reveal''''' the specific parameters used to generate each search result.  Whether you use the search box below, or the regular search box that appears at the top of this page, any search that you run from this page will provide the customized results. 

    (:searchbox size=120:)


    PmWiki provides a basic search function.  While it is not powered by a "search engine", it can be tweaked to produce results that are ''targeted'' and ''customized.''

    !!!! Targeted searches
    Searches can be targeted to restrict the search to certain pages.  For example, a search can be restricted based on groups, where, for instance, "group=PmWiki" searches only the PmWiki group, and "group=-PmWiki" searches only pages that are not in the PmWiki group.  In addition to groups, searches can be restricted based on page names ("name="), [[PmWiki/wiki trails]] ("trail="), backlinks ("link=") and other criteria (e.g. "list=normal") and capped at a maximum number ("count=").  For documentation about each of these parameters, see [[PmWiki/page lists]]. 

    !!!! Customized display
    The display of search results can be customized to control the format, content and order of the returned results. 
    :fmt=: select format and content by specifying a pagelist template that determines layout, such as list styles, and page elements, such as title and description. 
    :order=: allows results to be sorted according to different criteria, such as name and title.  For documentation about each of these parameters, see [[PmWiki/page lists]]. 
    For examples of pagelist template formats see [[Site.Page List Templates]], (:if2 exists Site.LocalTemplates:)[[Site.Local Templates]],(:if2end:) and [[Cookbook:Pagelist Template Samples]].

    The [@(:pagelist request=1 req=1:)@] directives can be used instead of [@(:searchresults:)@] to remove the "Results of search for" message.
    Neither of these directives work for the [@(:searchresults:)@] or [@(:searchbox:)@] directives.
    :req=1: disables the pagelist until search results are returned.
    :request=1: see [[PmWiki/PageLists#pagelistrequest|pagelists]]
    This can be used in many more cases than the default pmwiki search.
    Data from pages with PTVs, etc can be searched, filtered, and reordered.
    Note that the default ordering is of text strings, ie. 1, 10, 2, 3 and not the numeric value 1, 2, 3, 10, but a custom pagelist sort function (see the [[cookbook/]]) can return any order required.

    !!!! Anyone, anywhere
    '''Readers''' can create targeted and customized search results simply by typing the relevant parameters , e.g. "group=PmWiki", into search boxes together with their search string.  '''Authors''' can predefine such targeted and customized searches by incorporating the parameters into pages using the [@(:searchbox:)@] and [@(:searchresults:)@] directives (documented at [[PmWiki/PageLists]]).

    [@(:searchresults:)@] can be customized by editing page [@Site.Search@].

    See also
    * $PageSearchForm
    * $SearchBoxOpt
    * $SearchPatterns


    (:ifend:)
    (:if equal {$Action} "search":)
    [[{$Name}|back]]\

    (:table border=0 width=100%:)\

    (:cell width=30%:)\

    !!!! [[Site/AllRecentChanges?q=PmWiki/+order%3Dname&action=search|All Documentation]]
    (:searchresults group=PmWiki fmt=#onegroupdesc order=name:)
    (:if expr exists Cookbook.Cookbook and equal {$Action} "search":)
    (:cell width=35%:)\

    !!!! [[Cookbook.Cookbook|All Cookbook Recipes]]
    (:searchresults group=Cookbook fmt=#summary order=name:)
    (:if expr exists PITS.PITS and equal {$Action} "search":)
    (:cell width=35%:)\

    !!!! [[PITS.PITS|PITS (Issue Tracking)]]
    (:searchresults group=PITS fmt=#summary name=0* order=-name:)
    (:if equal {$Action} "search":)
    (:tableend:)

    Note: The strings that were used to target and format each search result are shown above in ''italics'' and can be entered directly into a regular search box.

    (:title Search:)
    (:if false:)

    [[#onegroupdesc]]
    [[{=$Group}/{=$Name}]] %font-size=smaller font-style=italic%{=$Description}%%\\
    [[#onegroupdescend]]

    [[#summary]]
    [[{=$Group}/{=$Name}]] %font-size=smaller font-style=italic%{=$:Summary}%%\\
    [[#summaryend]]
    (:ifend:)
    to:
    (:Summary:Search wiki:)
    (:searchbox:)

    (:searchresults:)

    [[#searchinfostart]]
    A search for more than one word will find pages that contain all of the words.
    Use quotation marks to search for a phrase. 
    Also use quotes for text with punctuation or special characters.
    Searches are case insensitive.

    To limit your search to a single group, enter the group name followed by a slash at the beginning of the search string (e.g., "[=PmWiki/=]" or "{$SiteGroup}/"). 
    To list all pages, enter a slash for the search. 

    !![-Search examples-]
     
    ||border='0' cellspacing='0' width='100%' cellpadding='0'
    ||!Enter            ||!To find pages containing ||
    ||apple pie        ||both 'apple' and 'pie' ||
    ||"apple pie"      ||the phrase 'apple pie' ||
    ||pmwiki/apple      ||'apple' in the [=PmWiki=] group of pages ||
    ||"pmwiki/apple"    ||the phrase 'pmwiki/apple' in all groups of pages ||
    ||apple -pie        ||'apple', omitting those containing 'pie' ||
    ||food -"apple pie" ||'food', omitting those containing 'apple pie' ||
    ||apple "-pie"      ||the words 'apple' and '-pie' ||
    ||apple - pie      ||'apple', '-', and 'pie' ||
    ||"pie:"            ||the word 'pie' with a colon ||
    ||"pie=tasty"      ||the phrase 'pie=tasty' ||
    ||pmwiki/          ||all pages in the [=PmWiki=] group ||

    Some ''special characters'' need to be enclosed in quotes, including the colon (:), equals sign (=), less than (<), single quote (') and double quote(").

    [[#searchinfoend]]
    2013-02-02 09:32 [UTC-7] by Blue Hell -
    Changed line 8 from:
    (:searchbox size=20:)
    to:
    (:searchbox size=120:)
    2013-02-02 09:30 [UTC-7] by Blue Hell -
    Added line 7:
    2013-02-01 20:56 [UTC-7] by Blue Hell -
    Changed lines 13-14 from:
    Searches can be targeted to restrict the search to certain pages.  For example, a search can be restricted based on groups, where, for instance, "group=PmWiki" searches only the PmWiki group, and "group=-PmWiki" searches only pages that are not in the PmWiki group.  In addition to groups, searches can be restricted based on page names ("name="), [[wiki trails]] ("trail="), backlinks ("link=") and other criteria (e.g. "list=normal") and capped at a maximum number ("count=").  For documentation about each of these parameters, see [[page lists]]. 
    to:
    Searches can be targeted to restrict the search to certain pages.  For example, a search can be restricted based on groups, where, for instance, "group=PmWiki" searches only the PmWiki group, and "group=-PmWiki" searches only pages that are not in the PmWiki group.  In addition to groups, searches can be restricted based on page names ("name="), [[PmWiki/wiki trails]] ("trail="), backlinks ("link=") and other criteria (e.g. "list=normal") and capped at a maximum number ("count=").  For documentation about each of these parameters, see [[PmWiki/page lists]]. 
    Changed line 18 from:
    :order=: allows results to be sorted according to different criteria, such as name and title.  For documentation about each of these parameters, see [[page lists]]. 
    to:
    :order=: allows results to be sorted according to different criteria, such as name and title.  For documentation about each of these parameters, see [[PmWiki/page lists]]. 
    Changed line 30 from:
    '''Readers''' can create targeted and customized search results simply by typing the relevant parameters , e.g. "group=PmWiki", into search boxes together with their search string.  '''Authors''' can predefine such targeted and customized searches by incorporating the parameters into pages using the [@(:searchbox:)@] and [@(:searchresults:)@] directives (documented at [[PageLists]]).
    to:
    '''Readers''' can create targeted and customized search results simply by typing the relevant parameters , e.g. "group=PmWiki", into search boxes together with their search string.  '''Authors''' can predefine such targeted and customized searches by incorporating the parameters into pages using the [@(:searchbox:)@] and [@(:searchresults:)@] directives (documented at [[PmWiki/PageLists]]).
    2013-02-01 20:51 [UTC-7] by Blue Hell -
    Added lines 4-9:
    [[#example]]
    !!!!Try it: this page generates custom searches
    Any search that is run from this page will automatically generate pre-defined sets of search results that: '''''target''''' different clusters of pages (documentation, cookbook and PITS, if available); use '''''customized''''' formats, content and ordering; and '''''reveal''''' the specific parameters used to generate each search result.  Whether you use the search box below, or the regular search box that appears at the top of this page, any search that you run from this page will provide the customized results. 
    (:searchbox size=20:)

    Deleted lines 37-42:


    [[#example]]
    !!!!Try it: this page generates custom searches
    Any search that is run from this page will automatically generate pre-defined sets of search results that: '''''target''''' different clusters of pages (documentation, cookbook and PITS, if available); use '''''customized''''' formats, content and ordering; and '''''reveal''''' the specific parameters used to generate each search result.  Whether you use the search box below, or the regular search box that appears at the top of this page, any search that you run from this page will provide the customized results. 
    (:searchbox size=20:)
    2013-02-01 20:50 [UTC-7] by Blue Hell -
    Deleted lines 3-6:
    >>rframe width=300pcx font-size=smaller<<
    -< '''This page uses [[#example|custom]] searches.'''
    For regular searches, view another page.
    >><<
    2013-02-01 20:48 [UTC-7] by Blue Hell -
    Added lines 1-79:
    (:description A page for advanced and customized search options:)
    (:Summary:Targeting and customising search results:)
    (:if !equal {$Action} "search":)
    >>rframe width=300pcx font-size=smaller<<
    -< '''This page uses [[#example|custom]] searches.'''
    For regular searches, view another page.
    >><<
    PmWiki provides a basic search function.  While it is not powered by a "search engine", it can be tweaked to produce results that are ''targeted'' and ''customized.''

    !!!! Targeted searches
    Searches can be targeted to restrict the search to certain pages.  For example, a search can be restricted based on groups, where, for instance, "group=PmWiki" searches only the PmWiki group, and "group=-PmWiki" searches only pages that are not in the PmWiki group.  In addition to groups, searches can be restricted based on page names ("name="), [[wiki trails]] ("trail="), backlinks ("link=") and other criteria (e.g. "list=normal") and capped at a maximum number ("count=").  For documentation about each of these parameters, see [[page lists]]. 

    !!!! Customized display
    The display of search results can be customized to control the format, content and order of the returned results. 
    :fmt=: select format and content by specifying a pagelist template that determines layout, such as list styles, and page elements, such as title and description. 
    :order=: allows results to be sorted according to different criteria, such as name and title.  For documentation about each of these parameters, see [[page lists]]. 
    For examples of pagelist template formats see [[Site.Page List Templates]], (:if2 exists Site.LocalTemplates:)[[Site.Local Templates]],(:if2end:) and [[Cookbook:Pagelist Template Samples]].

    The [@(:pagelist request=1 req=1:)@] directives can be used instead of [@(:searchresults:)@] to remove the "Results of search for" message.
    Neither of these directives work for the [@(:searchresults:)@] or [@(:searchbox:)@] directives.
    :req=1: disables the pagelist until search results are returned.
    :request=1: see [[PmWiki/PageLists#pagelistrequest|pagelists]]
    This can be used in many more cases than the default pmwiki search.
    Data from pages with PTVs, etc can be searched, filtered, and reordered.
    Note that the default ordering is of text strings, ie. 1, 10, 2, 3 and not the numeric value 1, 2, 3, 10, but a custom pagelist sort function (see the [[cookbook/]]) can return any order required.

    !!!! Anyone, anywhere
    '''Readers''' can create targeted and customized search results simply by typing the relevant parameters , e.g. "group=PmWiki", into search boxes together with their search string.  '''Authors''' can predefine such targeted and customized searches by incorporating the parameters into pages using the [@(:searchbox:)@] and [@(:searchresults:)@] directives (documented at [[PageLists]]).

    [@(:searchresults:)@] can be customized by editing page [@Site.Search@].

    See also
    * $PageSearchForm
    * $SearchBoxOpt
    * $SearchPatterns


    [[#example]]
    !!!!Try it: this page generates custom searches
    Any search that is run from this page will automatically generate pre-defined sets of search results that: '''''target''''' different clusters of pages (documentation, cookbook and PITS, if available); use '''''customized''''' formats, content and ordering; and '''''reveal''''' the specific parameters used to generate each search result.  Whether you use the search box below, or the regular search box that appears at the top of this page, any search that you run from this page will provide the customized results. 
    (:searchbox size=20:)


    (:ifend:)
    (:if equal {$Action} "search":)
    [[{$Name}|back]]\

    (:table border=0 width=100%:)\

    (:cell width=30%:)\

    !!!! [[Site/AllRecentChanges?q=PmWiki/+order%3Dname&action=search|All Documentation]]
    (:searchresults group=PmWiki fmt=#onegroupdesc order=name:)
    (:if expr exists Cookbook.Cookbook and equal {$Action} "search":)
    (:cell width=35%:)\

    !!!! [[Cookbook.Cookbook|All Cookbook Recipes]]
    (:searchresults group=Cookbook fmt=#summary order=name:)
    (:if expr exists PITS.PITS and equal {$Action} "search":)
    (:cell width=35%:)\

    !!!! [[PITS.PITS|PITS (Issue Tracking)]]
    (:searchresults group=PITS fmt=#summary name=0* order=-name:)
    (:if equal {$Action} "search":)
    (:tableend:)

    Note: The strings that were used to target and format each search result are shown above in ''italics'' and can be entered directly into a regular search box.

    (:title Search:)
    (:if false:)

    [[#onegroupdesc]]
    [[{=$Group}/{=$Name}]] %font-size=smaller font-style=italic%{=$Description}%%\\
    [[#onegroupdescend]]

    [[#summary]]
    [[{=$Group}/{=$Name}]] %font-size=smaller font-style=italic%{=$:Summary}%%\\
    [[#summaryend]]
    (:ifend:)

    Edit - History - Print - Recent Changes - Search Page last modified on 2013-03-01 20:17 [UTC-7] - 972 views