DokuWiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== Page Title Plugin ======

---- plugin ----
description: Macro to set the title of page instead of the first heading text of the page.
author     : S.Sahara 
email      : sahara.satoshi@gmail.com 
type       : syntax
lastupdate : 2015-10-19
compatible : 2015-08-10a "Detritus"
depends    : 
conflicts  : 
similar    : meta
tags       : title, breadcrumb

downloadurl: https://github.com/ssahara/dw-plugin-pagetitle/zipball/master
bugtracker : https://github.com/ssahara/dw-plugin-pagetitle/issues
sourcerepo : https://github.com/ssahara/dw-plugin-pagetitle/
donationurl:

----

===== Installation =====

Install the plugin through the [[plugin:extension|Extension Manager]] or [[plugin:plugin|Plugin Manager]] using the download URL above, which points to latest version of the plugin. Refer to [[:plugin_installation_instructions|plugin installation instructions]].

:!: **Require PHP 5.3 at least**

===== Examples/Usage =====

====Define and render a title of the wiki page ====

<title>
  **Page Title** plugin for DokuWiki
  </title>

The specified title becomes the title of HTML document in combination with your DokuWiki site [[config:title]]. You may need to set [[config:useheading]] option to "navigation" (other than "0") in order to show specified title in the browser title bar.

You can use **bold**, //italic//, <sup>superscript</sup> and <sub>subscript</sub> text to show appropriate title on the page. The formatted page title is shown on the page, but it is converted to a plain text for the title of HTML document. The pagetitle plugin overwrites 'title' value of the [[devel:metadata]] to store the plain title text.

When there are multiple ''<title>'' entries in a page, the first entry should be effective.

If you want to set a page title without showing itself on the page, you can instead use following syntax macro:

~~Title: **Page Title** plugin for DokuWiki ~~

==== Hierarchical breadcrumbs on the page ====
(expermental)

This syntax allow you to put a hierarchical breadcrumbs in the page. The place holder ''%%%%'' is replaced by the hierarchical breadcrumbs provided by this plugin,  which uses page id for a breadcrumbs name independently from [[config:useheading|$conf('useheading')]] setting.

===== Development =====
{{rss>https://github.com/ssahara/dw-plugin-pagetitle/commits/master.atom date 5}}
  
=== ToDo/Wish List ===

* ''%%<title>%%'' syntax to define pagename (title of the page) on the page (v2 branch) -> done in release 2015-09-24
  * '''%%%%'' syntax to show a Hierarchical breadcrumbs on the page (v2 branch) -> done in release 2015-09-24

===== Known Bugs and Issues =====

Please fill all the letters into the box to prove you're human. A T X I C Please keep this field empty:

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International