Configuration Setting: useheading

When this option is enabled, a link to a wiki page name will automatically use the first heading in the page for each of the following:

• The title of the page, as shown in the browser or in search engine results.
• The text for a link to the page, unless the link specification contains an explicit title.
• The title of RSS feed entries for the page

• Type: Boolean
• Default: 0

develonly

A patched was pushed on 2008-11-28 altering this configuration setting as detailed below.

• Type: Mixed
• Default: 0
• Values:
  • 0 : off, use page name in link text
  • 'content' : use first heading text for links in wiki page content
  • 'navigation' : use first heading text for links in non-page content, e.g. breadcrumps, backlinks, search results, etc.
  • 1 : use first heading text in all links

(for backwards compatibility, any other values are mapped to 0 or 1 by empty() function.)

Never use confidential information in the first headings of any page that has restricted read access.

The first heading of pages with restricted read access will be disclosed on other parts of the wiki which link to that page. Even if you ensure that no links to a particular page are themselves on non-restricted pages it is still possible for an editor of a non-restricted page to create a link to the restricted page in order to discover the first heading.

• Configuring DokuWiki