Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section


Column


Document Properties Marker
overridefalse


Short DescriptionShow how to use document properties to filter on searches.
Doctypetopichide
NameSearch Filter based on Properties
Short Name
Parent
Parent Property
property-nameName
hide
Audience

Name List
doctyperole
render-no-hits-as-blanktrue
render-list-as-comma-separated-valuestrue
namesReader, Documentation Architect, Documentation Gardener, Template Author, Author
propertyAudience


Subject
Name List
doctypesubject
propertySubject

Categories
Name List
doctypecategory
propertyCategories

Tags

Tag List
namesprojectdoc Toolbox, Confluence, Search, Filter, properties
propertyTags

hide
Flagshide
Iteration

Iteration
valuefinished

hide
Type

Name List
doctypetopic-type
render-no-hits-as-blanktrue
namesTip
propertyType


Level of Experience

Name List
doctypeexperience-level
render-no-hits-as-blanktrue
namesAdvanced Beginner
propertyLevel of Experience


Expected Duration5 min
Sponsors
Name List
doctypestakeholder
render-no-hits-as-blanktrue
propertySponsors

Sort Keyhide
enable-heading-numberstruehide




Column


Panel
titleContents

Table of Contents
outlinetrue
indent10px
excludeReferences
stylenone



...

Section
titlePrerequisites


Section
titleFilter Navigation PagesThe Problem

If you search for a term like "Role" or "Stakeholder" you'll get plenty of hits. This is because the Core Doctypes provide doctypes with this name. For each space there may be a home page and an index page for each of these doctypes and these pages also contain the string "Role" or "Stakeholder".

In addition to those, there are also home pages and index pages for the corresponding type doctype, like "Role Type" and "Stakeholder Type". So these pages will also clutter your search result.

Image Added

The result set above shows a number of home pages for Role Types.


Section
titleTwo Kind of Pages

There a two kind of pages in a Confluence site: destination pages and navigation pages.

Section


Column
width50%


Section
titleDestination Pages

A destination page is a page contains actual relevant information. It is something like a description, an open issue, a service, a role, or a stakeholder.

Destination pages why a space has been created.



Column
width50%


Section
titleNavigation Pages

A navigation page has only one purpose. It holds links of some kind and enables users to browse pages. Navigation pages are important to organize and find pages, but no space would be created only for navigation pages.

Home page and index pages typically have only navigation purposes. Readers know where to look for a list of roles or the address book of stakeholders.


When searching for "Role" or "Stakeholder" these navigation pages should not show up as search results.

Only destination pages, containing actual relevant information, should.



Section
titleFilter Navigation Pages

Confluence does not distinguish between destination pages and navigation pages. There is only the concept of a page.

The projectdoc Toolbox provides navigation pages by the doctype named docsection.

This makes it easy to remove these pages from the search results.!

Instead of 

Code Block
"Stakeholder" -Doctype: docsectionRole"

you would type the following:

Code Block
"StakeholderRole" -Doctype: docsection


Image Added

Now Confluence will only return destination pages related to "StakeholderRole" and remove all navigation pages from the result set.

projectdoc-box-tip

The Doctype property is almost like any other property. The same way you filter on the Doctype property you could chose any other property or combination of properties to put constraints on a search.

Code Block
"Role" +Severity: High +Doctype: task




projectdoc-section
titleSummary

A Confluence site consists of a number of spaces. Within a space home pages and index pages provide navigation support to users. They make it easy to browse documents of a given type and find related information.

Besides navigation page as space's main purpose is to server destination pages. In searches user typically want only destination pages in their result set.

To remove navigation pages add -Doctype: docsection to your search query.

...

Section
titleReferences


Tour
render-no-hits-as-blanktrue
render-as-definition-listtrue
marker-column-property-nameTitle
replace-title-with-nametrue


TitleShort Description





Section
titleResources

More information on running and configuring searches in Confluence.

Tour
render-no-hits-as-blanktrue
render-as-definition-listtrue
marker-column-property-nameTitle
replace-title-with-nametrue


TitleShort Description
SearchConfluence gives you a few ways to find what you're looking for. Here's an overview of Confluence search, and a few tips to help you find things more easily.
Configuring the Confluence Search and IndexConfluence administrators can adjust the behavior of the Confluence search, and manage the index used by the search.
Confluence Search Syntax

You can create an advanced search query using Confluence search syntax. These are special words and symbols you enter into the search field to narrow the focus of your search. This page outlines the syntax supported by Confluence's search engine, Lucene.

Search Tips




Piwik Set Multiple Custom Variables


NameValue
Departmentprojectdoc
Categoryprojectdoc-tip
Typehowto


...