DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:pagetitle

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:pagetitle [2015-10-23 14:01] – [Page Title Plugin] s.saharaplugin:pagetitle [2021-06-23 14:32] (current) porg
Line 1: Line 1:
-====== Page Title Plugin ======+====== PageTitle Plugin ======
  
 ---- plugin ---- ---- plugin ----
Line 6: Line 6:
 email      : sahara.satoshi@gmail.com  email      : sahara.satoshi@gmail.com 
 type       : syntax type       : syntax
-lastupdate : 2015-10-23 +lastupdate : 2019-09-29 
-compatible : Hrun, 2015-08-10a "Detritus"+compatible : 2014-09-29d, 2015-08-10a, 2016-06-26a, 2017-02-19b, 2018-04-22a, !Hogfather
 depends    :  depends    : 
 conflicts  conflicts 
Line 21: Line 21:
  
 ===== Installation ===== ===== Installation =====
 +Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:plugin installation instructions]] on how to install plugins manually.
  
-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 ===== ===== Examples/Usage =====
Line 30: Line 28:
 ====Define and render a title of the wiki page ==== ====Define and render a title of the wiki page ====
  
-  <title>+  <title classes #id>
   **Page Title** plugin for DokuWiki   **Page Title** plugin for DokuWiki
   </title>   </title>
Line 37: Line 35:
  
 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. 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.
 +You can give ''classes'' or ''#id'' to the title element (%%<h1>%%) if [[plugin:wrap|wrap]] plugin is available in your wiki site. 
 +
  
 When there are multiple ''<title>'' entries in a page, the first entry should be effective. When there are multiple ''<title>'' entries in a page, the first entry should be effective.
Line 42: Line 42:
 If you want to set a page title without showing itself on the page, you can instead use following syntax macro: 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 ~~+  ~~Title: Page Title plugin for DokuWiki ~~ 
 + 
 +=== CSS for PageTitle === 
 + 
 +You can use class selector "pagetitle" for the HTML element of Page Title rendered in the page. 
 + 
 +<code css> 
 +.dokuwiki h1.pagetitle { 
 +    text-align: center; 
 +
 +</code> 
  
  
Line 51: Line 62:
  
 This syntax allow you to put a hierarchical breadcrumbs in the page. The place holder ''%%<!--YOU_ARE_HERE-->%%'' 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. This syntax allow you to put a hierarchical breadcrumbs in the page. The place holder ''%%<!--YOU_ARE_HERE-->%%'' 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.
 +
 +  ~~ShortTitle: pageTitle ~~
 +
 +ShortTitle macro is additionally available if you want use shorter title instead of (longer) pagetitle in the hierarchical breadcrumbs.
 +
  
  
Line 56: Line 72:
  
 ===== Development ===== ===== Development =====
 +
 {{rss>https://github.com/ssahara/dw-plugin-pagetitle/commits/master.atom date 5}} {{rss>https://github.com/ssahara/dw-plugin-pagetitle/commits/master.atom date 5}}
 +
      
 === ToDo/Wish List === === ToDo/Wish List ===
Line 65: Line 83:
 ===== Known Bugs and Issues ===== ===== Known Bugs and Issues =====
  
 +==== Incompatibilities with 2020-07-29 Hogfather ====
 +  * [[https://github.com/ssahara/dw-plugin-pagetitle/issues/19|(Re-)activating the plugin should clear/regenerate the caches]]
 +  * [[https://github.com/ssahara/dw-plugin-pagetitle/issues/20|Visible title syntax: Rendered in page but not put into html head title]]
 +  * [[https://github.com/ssahara/dw-plugin-pagetitle/issues/21|Invisible title syntax: Rendered as raw markup AND not put into html head title]]
 +
 +==== parse error after upgrade ====
 +After I did an upgrade to the most recent version of the plugin, my dokuwiki instance became dysfunctional (white screen of death). The logs of my apache2 server contained this hint:
 +
 +  [Wed May 08 00:17:48.543750 2019] [:error] [pid 19136] [client 130.75.103.103:35866] PHP Parse error:  syntax error, unexpected '=' in /srv/www/iqwiki.iqo.uni-hannover.de/lib/plugins/pagetitle/syntax/shorter.php on line 72
 +
 +The server runs on PHP 7.0 . Dokuwiki itself is on greebo.
 +
 +--- [[user>KaiMartin|KaiMartin]] //2019-05-08 00:23//
 +
 +>  Just a hint from me: As far as I can see, you are not using Greebo... (The icons are not from Greebo.) --- [[user>Michaelsy|Michael Sy.]] //2019-05-08 00:45//
 +
 +>  The plugin requires PHP 7.1.x or later. However, PageTitle release 2019-05-08 should work with PHP 7.0.x that has already ended its life. Please refer to https://www.php.net/supported-versions.php   --- [[user>s.sahara|s.sahara]] //2019-05-08 00:56//
 +
 +I can confirm functionality on PHP7.1. Maybe you should correct your commit description on github. ''PHP 7.0.x support'' is a little misinterpretative. ;)
 + --- [[user>punkt|Punkt]] //2019-06-25 13:30//
 +
 +Pagetitle makes my Detritus crash (error 500), at mekineer.com.  PHP version: <del>7.3.6</del> sorry, it was actually running 5.6.40.  I updated my site to use 7.0.x, and pagetitle works now.
  
 +I'm a bit confused about functionality.  I am using indexmenu plugin, and want the URL path for the menu.  However, I want the page title to be what's in <title> This way, I can keep my menu with brief names, yet have the page title be more descriptive.  Is this not possible?   --- [[user>mekineer|mekineer]] //2020-01-16 02:51//
plugin/pagetitle.1445601718.txt.gz · Last modified: 2015-10-23 14:01 by s.sahara

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki