Trace:

You are here: Home » Public Area » Computers » DokuWiki Tweaks

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
public:computers:dokuwiki_tweaks [29/01/26 17:55 GMT] – [Monobook user/screen.css] johnpublic:computers:dokuwiki_tweaks [02/02/26 18:19 GMT] (current) – john
Line 2: Line 2:
  
 ====== DokuWiki Tweaks ====== ====== DokuWiki Tweaks ======
 +===== Vector / Monobook tweaks =====
 +
 +I like the Vector and Monobook templates, very similar feel to Wikipedia
 +
 +==== Logout errors with later versions of Dokuwiki ====
 +
 +After upgrading Dokuwiki to //Igor// it became impossible to log out due to a warning 
 +
 +<note warning>
 +Security Token did not match. Possible CSRF attack.
 +</note>
 +
 +I initially ignored it but then downgraded back to //Hogfather// as there seemed to be no fix - other than to use a different template.
 +
 +I recently upgraded to the latest Dokuwiki (Jack Jackrum), and upgraded all plugins and templates where possible. However the problem with logout with Vector and Monobook re-appeared.
 +
 +I found there was a fix described on the forum:
 +
 +[[https://forum.dokuwiki.org/d/20248-security-token-did-not-match-possible-csrf-attack-cannot-log-out]]
 +
 +and the cure is to edit the appropriate line in ''main.php'' for each template, as the author seems not to be maintaining these templates any more, at least not the official ones accessed via Dokuwiki's Template/Extension installer. The github repository shows that the fix has been applied to ''Vector'', and a pull request submitted to fix ''Monobook'', the fixes haven't appeared in the official versions. 
 +
 +The FIXME does work, though...
 +
 +For Vector edit ''/var/www/html/dokuwiki/lib/tpl/vector/main.php'' to add '', 'sectok' => getSecurityToken()'' in the ''array'' statement after ''"do" => "logout"''
 +
 +<code php>
 + echo  "      <li id=\"pt-logout\"><a href=\"".wl(cleanID(getId()), array("do" => "logout", 'sectok' => getSecurityToken()))."\" rel=\"nofollow\">".hsc($lang["btn_logout"])."</a></li>\n"; //language comes from DokuWiki core
 +
 +</code>
 +
 +and the same for ''Monobook''
 +<code php>
 + echo  "          <li id=\"pt-logout\"><a href=\"".wl(cleanID(getId()), array("do" => "logout", 'sectok' => getSecurityToken()))."\" rel=\"nofollow\">".hsc($lang["btn_logout"])."</a></li>\n"; //language comes from DokuWiki core
 +
 +</code>
 +
 +
 +==== Monospace font ====
 +
 +I found the style applied to ''monospace'' text was a little underwhelming. 
 +
 +I found the place to change it:
 +
 +'' /var/www/html/dokuwiki/lib/tpl/{vector|monobook}/user/screen.css ''
 +
 +add the the following and adjust as needed:
 +
 +<code css>
 +
 +div#content .dokuwiki code {
 +  font-size: 100%;
 +  padding-left: 5px;
 +  padding-right: 5px;
 +  background-color: #eee;
 +  color: #00f;
 +  direction: ltr;
 +  text-align: left;
 +}
 +
 +
 +</code>
 +
 +==== Footer Buttons ====
 +
 +Remove the default footer buttons by editing ''{vector|monobook}/user/buttons.php'' and adding
 +
 +<note tip>
 +For Monobook, change to <code>$_monobook_btns = array();</code>
 +</note>
 +
 +<code php>
 +
 +//delete all (defaults)
 +$_vector_btns = array();
 +</code>
 +
 +this suppresses the inclusion of footer buttons from ''vector/conf/buttons.php''
 +
 +=== Add just the Dokuwiki and Vector/Monobook Buttons ===
 +
 +Edit ''{vector|monobook}/user/buttons.php''
 +
 +<note tip>
 +Swap ''monobook'' for ''vector'' as appropriate
 +</note>
 +
 +<code php>
 +
 +<?php
 +
 +//check if we are running within the DokuWiki environment
 +if (!defined("DOKU_INC")){
 +    die();
 +}
 +//delete all (defaults)
 +$_vector_btns = array();  
 +
 +//note: The buttons will be rendered in the order they were defined. Means:
 +//      first button will be rendered first, last button will be rendered at
 +//      last.
 +//DokuWiki button
 +$_vector_btns["dw"]["img"]      = DOKU_TPL."static/img/button-dw.png";
 +$_vector_btns["dw"]["href"]     = "https://www.dokuwiki.org/";
 +$_vector_btns["dw"]["width"]    = 80;
 +$_vector_btns["dw"]["height"]   = 15;
 +$_vector_btns["dw"]["title"]    = "DokuWiki";
 +$_vector_btns["dw"]["nofollow"] = !(cleanID(getID()) === "start");
 +
 +//"vector for DokuWiki" button
 +$_vector_btns["vecfdw"]["img"]      = DOKU_TPL."static/img/button-vector.png";
 +$_vector_btns["vecfdw"]["href"]     = "https://www.dokuwiki.org/template:vector";
 +$_vector_btns["vecfdw"]["width"]    = 80;
 +$_vector_btns["vecfdw"]["height"]   = 15;
 +$_vector_btns["vecfdw"]["title"]    = $lang["vector_mdtemplatefordw"];
 +$_vector_btns["vecfdw"]["nofollow"] = !(cleanID(getID()) === "start");
 +
 +</code>
 +====  Mobile Scaling ====
 +
 +The layout on a phone isn't too good, and can't be zoomed/scaled. 
 +
 +I found this thread:
 +
 +[[https://forum.dokuwiki.org/d/12469-vector-template-doesn-t-display-correctly-on-mobile-devices/6]]
 +
 +and applied the comment-out of the line :
 +
 +<code php>
 +
 +//echo "<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\" />";
 +</code> 
 +
 +in ''main.php'' and ''mediamanager.php''
 +
 +the page now scales/zooms okay to make it useable on a phone.
  
 ===== Monobook user/screen.css ===== ===== Monobook user/screen.css =====
Line 476: Line 612:
   * it seems necessary to disable ''showThemeSwitcher'' and to select a default theme to be used outside of any listed in the conf file   * it seems necessary to disable ''showThemeSwitcher'' and to select a default theme to be used outside of any listed in the conf file
  
-===== Vector / Monobook tweaks ===== 
- 
-I like the Vector and Monobook templates, very similar feel to Wikipedia 
- 
-==== Logout errors with later versions of Dokuwiki ==== 
- 
-After upgrading Dokuwiki to //Igor// it became impossible to log out due to a warning  
- 
-<note warning> 
-Security Token did not match. Possible CSRF attack. 
-</note> 
- 
-I initially ignored it but then downgraded back to //Hogfather// as there seemed to be no fix - other than to use a different template. 
- 
-I recently upgraded to the latest Dokuwiki (Jack Jackrum), and upgraded all plugins and templates where possible. However the problem with logout with Vector and Monobook re-appeared. 
- 
-I found there was a fix described on the forum: 
- 
-[[https://forum.dokuwiki.org/d/20248-security-token-did-not-match-possible-csrf-attack-cannot-log-out]] 
- 
-and the cure is to edit the appropriate line in ''main.php'' for each template, as the author seems not to be maintaining these templates any more, at least not the official ones accessed via Dokuwiki's Template/Extension installer. The github repository shows that the fix has been applied to ''Vector'', and a pull request submitted to fix ''Monobook'', the fixes haven't appeared in the official versions.  
- 
-The FIXME does work, though... 
- 
-For Vector edit ''/var/www/html/dokuwiki/lib/tpl/vector/main.php'' to add '', 'sectok' => getSecurityToken()'' in the ''array'' statement after ''"do" => "logout"'' 
- 
-<code php> 
- echo  "      <li id=\"pt-logout\"><a href=\"".wl(cleanID(getId()), array("do" => "logout", 'sectok' => getSecurityToken()))."\" rel=\"nofollow\">".hsc($lang["btn_logout"])."</a></li>\n"; //language comes from DokuWiki core 
- 
-</code> 
- 
-and the same for ''Monobook'' 
-<code php> 
- echo  "          <li id=\"pt-logout\"><a href=\"".wl(cleanID(getId()), array("do" => "logout", 'sectok' => getSecurityToken()))."\" rel=\"nofollow\">".hsc($lang["btn_logout"])."</a></li>\n"; //language comes from DokuWiki core 
- 
-</code> 
- 
- 
-==== Monospace font ==== 
- 
-I found the style applied to ''monospace'' text was a little underwhelming.  
- 
-I found the place to change it: 
- 
-'' /var/www/html/dokuwiki/lib/tpl/{vector|monobook}/user/screen.css '' 
- 
-add the the following and adjust as needed: 
- 
-<code css> 
- 
-div#content .dokuwiki code { 
-  font-size: 100%; 
-  padding-left: 5px; 
-  padding-right: 5px; 
-  background-color: #eee; 
-  color: #00f; 
-  direction: ltr; 
-  text-align: left; 
-} 
- 
- 
-</code> 
- 
-==== Footer Buttons ==== 
- 
-Remove the default footer buttons by editing ''{vector|monobook}/user/buttons.php'' and adding 
- 
-<note tip> 
-For Monobook, change to <code>$_monobook_btns = array();</code> 
-</note> 
- 
-<code php> 
- 
-//delete all (defaults) 
-$_vector_btns = array(); 
-</code> 
- 
-this suppresses the inclusion of footer buttons from ''vector/conf/buttons.php'' 
- 
-=== Add just the Dokuwiki and Vector/Monobook Buttons === 
- 
-Edit ''{vector|monobook}/user/buttons.php'' 
- 
-<note tip> 
-Swap ''monobook'' for ''vector'' as appropriate 
-</note> 
- 
-<code php> 
- 
-<?php 
- 
-//check if we are running within the DokuWiki environment 
-if (!defined("DOKU_INC")){ 
-    die(); 
-} 
-//delete all (defaults) 
-$_vector_btns = array();   
- 
-//note: The buttons will be rendered in the order they were defined. Means: 
-//      first button will be rendered first, last button will be rendered at 
-//      last. 
-//DokuWiki button 
-$_vector_btns["dw"]["img"]      = DOKU_TPL."static/img/button-dw.png"; 
-$_vector_btns["dw"]["href"]     = "https://www.dokuwiki.org/"; 
-$_vector_btns["dw"]["width"]    = 80; 
-$_vector_btns["dw"]["height"]   = 15; 
-$_vector_btns["dw"]["title"]    = "DokuWiki"; 
-$_vector_btns["dw"]["nofollow"] = !(cleanID(getID()) === "start"); 
- 
-//"vector for DokuWiki" button 
-$_vector_btns["vecfdw"]["img"]      = DOKU_TPL."static/img/button-vector.png"; 
-$_vector_btns["vecfdw"]["href"]     = "https://www.dokuwiki.org/template:vector"; 
-$_vector_btns["vecfdw"]["width"]    = 80; 
-$_vector_btns["vecfdw"]["height"]   = 15; 
-$_vector_btns["vecfdw"]["title"]    = $lang["vector_mdtemplatefordw"]; 
-$_vector_btns["vecfdw"]["nofollow"] = !(cleanID(getID()) === "start"); 
- 
-</code> 
-====  Mobile Scaling ==== 
- 
-The layout on a phone isn't too good, and can't be zoomed/scaled.  
- 
-I found this thread: 
- 
-[[https://forum.dokuwiki.org/d/12469-vector-template-doesn-t-display-correctly-on-mobile-devices/6]] 
- 
-and applied the comment-out of the line : 
- 
-<code php> 
- 
-//echo "<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\" />"; 
-</code>  
- 
-in ''main.php'' and ''mediamanager.php'' 
- 
-the page now scales/zooms okay to make it useable on a phone. 
  
 ==== Alternative ==== ==== Alternative ====

Navigation