The heuristic mode is based on naming conventions of internationalization (I18N) keys. This is the default search mode. The mode is based on a few quick and fast lookups. But the heuristic mode is not reliable. In case there is an index page, the heuristic assumes that there are document instances of the given type. This may not be true. I18N keys are specified in resource bundles, typically in a properties file, that is deployed as an app (formally known as plugin or add-on) to a Confluence server. The homepage for a given doctype needs to have a I18N key of the following format: Code Block |
---|
<any-chars>.content.<doctype>.home.title |
The index page for doctypes is assumed to be referenced by the following I18N key: Code Block |
---|
<any-chars>.content.<doctype>.index.all.title |
<any-chars> may actually any chars that are valid for an I18N key. <doctype> is a placeholder to represent the identifier of a doctype.
In case all documents are removed, the index page needs to be removed manually. Example Box |
---|
title | Requirement Doctype Example |
---|
| A key used by the Requirement doctype. Code Block |
---|
projectdoc.content.requirement.home.title
projectdoc.content.requirement.index.all.title |
|
Example Box |
---|
title | Imaginary Fancy Report Doctype |
---|
| A key for the imaginary Fancy Report doctype of a sample organisation. Code Block |
---|
com.example.myorg.content.fancy-report.home.title
com.example.myorg.content.fancy-report.index.all.title |
In order to not clash with keys from projectdoc products, users should use their own key prefixes. These could be defined by the name of their internet domain. |
|