• View
• Edit
• History
• Attach
• Print
• Backlinks

StaticPages

Questions answered by this recipe

• How do I publish pmwiki pages as static pages?
• How can I reduce the time it takes to open a pmwiki page?

Description

• Allows an Administrator to Publish PmWiki pages inside the working directory (wiki.d) as static pages.

Installation

• 2.0.1
• Download StaticPages-2.0.1.zipΔ and extract it to your cookbook directory.
  • Bug fix, see version 2.0.0 for instructions.
• 2.0.0
• Download StaticPages-2.0.0.zipΔ and extract it to your cookbook directory.
• Updating your config.php
  • Required: Add the following to your pmwiki/local/config.php
    • include_once("$FarmD/cookbook/StaticPageOutput.php");
    • include_once("$FarmD/cookbook/RelativeURLs.php"); (This must be your last entry in config.php)
  • Required: An admin password for pmwiki will need to be set to access the StaticPageGenerator action page
    • $DefaultPasswords['admin'] = crypt("test");
  • Optional: Define your Static Page output location
    • $StaticPageDir = "pub/web"; (Default)
  • Optional: Define your wiki location from your Static Page output location
    • $StaticPageDirToWikiDir= "./../.."; (Default)
  • Optional: Set the pmwiki action name (http://localhost/pmwiki/pmwiki.php?action=StaticPageGenerator) to show the StaticPageGenerator page
    • $StaticPageGeneratorActionName = "StaticPageGenerator"; (Default)
  • Optional: When a wiki page is saved, does it update the corresponding static page.
    • $StaticPageUpdateOnEditSaveAction = TRUE; (Default)
  • Optional: When a dynamic wiki page is shown, this will automatically generate all static links associated.
    • $StaticPageAutomaticCreation = TRUE; (Default)
  • Optional: The file naming format for the static page files produced.
    • $FmtPV['$staticPageName'] = '"$group.$name.html"' (Default)
  • Optional: Not all operating systems support UTF-8 file names. So select the encoding of the Static Page file names.
    • $ServerFileSystemEncoding = "UTF-8"; (Default)
    • $ServerFileSystemEncoding = "WINDOWS-1252"; (Default for $_ENV['OS'] containing the text "Windows")
  • Optional: Exclude Wiki Pages that you do not wish to have static pages generated for. (Both for "Save" and the action=StaticPageGenerator page)
    • $StaticPageRegularExpressionExclude = array(); (Default)
    • $StaticPageRegularExpressionExclude = array("/Main\.H.*/", "Main.WikiSandbox");
    • $StaticPageRegularExpressionExclude = array("/Main\.*/"); (Exclude all pages in the Main Group)
  • Optional: List of additional pages to be built when you "Save" a page.
    • $StaticPageSaveActionPageList = array(); (Default)
    • $StaticPageSaveActionPageList = array("Main.RecentChanges");
    • $StaticPageSaveActionPageList = array("Main.HomePage", "Group.RecentChanges"); (The Group keyword will be replaced with the group of the page being saved.)

Cookbook files

• From 2.0.0
• RelativeURLs.php
  • Responsible for allowing relative URLs. [[./path/relative.html]]
• StaticPageOutput.php
  • Responsible for the Static Page functionality.
• StaticPageGenerator.php
  • The output page when the http://localhost/pmwiki/pmwiki.php?action=StaticPageGenerator action is called.

Usage

• When you "View" (browse) a page, all the linked Wiki Pages will have the associated Static Pages generated. (Default: StaticPageAutomaticCreation = TRUE)
• When you "Save" a wiki page, the associated Static Page will be generated.
• Access to the special "Administrator" StaticPageGenerator page at;
  • [(approve links) edit diff]

Notes

• Don't use with dynamic navigations (e.g. DynamicPageActions) as generated static pages won't have all actions on it.
• It would be great if those you use this, could give me some feedback. Did it work. Did it not. Was it a pain. What did you like etc etc

Release Notes

• 2.0.1
  • BugFix: RelativeURLs.php was having problems with UTF-8 html link encoding and the styles markup.
• 2.0.0
  • Reworked quite a bit.
  • UTF-8 webpages are NOW handled correctly.

Comments

• New release 2.0.0 Please let me know how it goes for you --MarkS 20.05.2007
  • I've just finished installing and testing 2.0.0 on pmwiki-2.1.27. Everything seems to be running smoothly and the old problems are gone. Relative linking rules! If you ever come to Helsinki, I'll buy you three beers. ;) --Pervilä 1.6.2007
  • Okay, caught a minor glitch. External links without the square brackets become invisible. E.g., [[http://www.pmwiki.org/]] works, but http://www.pmwiki.org/ does not. I tested this with a clean pmwiki-2.2.0-beta52 and said pmwiki-2.1.27. -Pervilä 1.6.2007
• New release 2.0.1 Should fix bug described above (In version 2.0.0). -- MarkS 07.06.2007
  • Thanks again! I can confirm a working installation on pmwiki-2.1.27, if we spot any new bugs, I'll keep this page posted. -Pervilä 10.6.2007
  • 2007-06-10 / Maddes / Bug:
    One link is not changed to a static link, the one in the title which leads to the homepage of a group. Here it would be Cookbook at the top of this page.
  • 2007-06-10 / Maddes / Enhancement:
    Had to change the script a little bit, so that it works with my farm setup (2 fields) with pmwiki-2.1.27.
    My wiki data is stored outside the web folders, so I needed to separate between file pathes and URL pathes.
    • Defined an additional variable in config.php called $StaticPageDirFile, which is used for file accesses.
    • In StaticPageOutput.php added after line #15:
      if (!isset($StaticPageDirFile)) {$StaticPageDirFile = $StaticPageDir;}
    • Replaced $StaticPageDir with the new $StaticPageDirFile in the functions createStaticPage() and ensureStaticPageDirExists() of StaticPageOutput.php plus also in StaticPageGenerator.php.
  • 2007-06-09 Smc What a great recipe well done! Thought I'd post a problem I've found. It's taken me ages to actually diagnose the issue. I've found that if you use "$EnablePathInfo = 1" which gives URLs of the form .../pmwiki.php/Group/PageName then the static URLs on the page have the wrong root. In the example above linked URLs look like .../pmwiki.php/Group/pub/web/Group.PageName.html (note that 'pmwiki.php/Group/' should not be there. If I switch off $EnablePathInfo so URLs look like .../pmwiki.php?n=Group.PageName then all work as expected. Digging around your code I'd guess that one of your 'dirname()' calls is not doing what you expect. I'm no expert though!
  • This looks like just the thing I could use for running pmwiki on my NSLU2 embedded device, some large/complex pages take up to 20s to load from markup, whereas equivalent static pages take 1s... However, I didn't get it to work yet, when I use https it doesn't generate anything (except for lots of "Could not open URL for copying" messages), and with http it does generate something, but then seems to be incompatible with UserAuth2 (generates all links with login screens instead of pages, regenerating after login not possible). Any ideas anyone?
    Still this looks promising! -2007-08-03, Lennert
    • Page Generation is done by making a URL connection to a remote address. I haven't tested with https, so I never had to deal with authentication issues. I will have a look at all these issues soon, and update this page. -- MarkS 03.08.07
• Getting a blank page back from StaticPageGenerator - Ben, Oct 2010
  • This is likely caused by a PHP execution time-out. In the cookbook directory, edit the StaticPageGenerator.php and just below the comment at the top, add this (otherwise increare the time-out in php.ini):

ini_set("display_errors", 1); ini_set('max_execution_time', '0');

• Error about undefine mb_convert_encoding - Ben, 21 Dec 2008
  • I got an error in StaticPageOutput.php about undefined function mb_convert_encoding (running on Windows, IIS, no choice). I do not have access to my php installation to install this module, but I was able to work around it by editing StaticPageOutput.php and commenting these three lines out:
    • #if (isset($ServerFileSystemEncoding)){
    • # $pagenameLink = mb_convert_encoding($pagenameLink, $ServerFileSystemEncoding, "UTF-8");
    • #}
  • Needless to say, only do this if there is no alternative, and it wont work in all cases. I have no idea what the impact of this is, other than that it may be a good idea to avoid pages with non-ASCII names.
  • With this change StaticCache worked great and resulted in *significantly* reduced page loading times (which I desperately needed). Thank you so very much! I tried using Cookbook.FastCache but it did not help in my case, likely because I could not use Apache/mod_rewrite.
  • Mark, IMHO the description of this module does not seem to do justice to the immense difference that it can make and the fact that in some cases it is the only available option to drastically reduce page load times.
  • With this change I do notice that immediately after you edit a page, you initially get the old page content and you also get the old content if you request the page. This is a little disconcerting but seems to fix itself after about five seconds or so and then everything is nice and fast and properly working again.
  • Please see this excellent discussion: http://www.mail-archive.com/pmwiki-users@pmichaud.com/msg11441.html
  • It may also help to change the line:
    • if (isset($ServerFileSystemEncoding)){
  • to
    • if (isset($ServerFileSystemEncoding) && $ServerFileSystemEncoding<>"UTF-8"){
  • because then you could set it to UTF-8 on Windows and have it work without having to change the code.
• Anchored links to another wiki page (OtherPage#Anchor) do not seem to work - Nicolas, 7 Dec 2009
  • Using the latest PmWiki (2.2.8) and StaticPages-2.0.1 with all default parameters, it looks like links to anchors (#anchor) on the same page are generated and working correctly on the StaticPages built, however wiki links to AnotherPage#anchor are not -- they are missing the #anchor in the link generated on the static page. The problem does not appear on pages which are kept dynamic (excluded from Static generation) so it looks like a StaticPage-2.0.1 bug to me... Any idea/workaround ? This is quite annoying as it breaks many things... Thanks !
• '''Q: All of the links on my pages have the external link icons (i.e. a little square with an arrow point to the upper right) behind them? How do I get rid of them?
  • The simplest way to fix this is to edit local/config.php and place this text in there:

## This changes external links to not have the small link icon in them:
# This is the default:
#$UrlLinkFmt = "<a class='urllink' href='\$LinkUrl' title='\$LinkAlt' rel='nofollow'>\$LinkText</a>";
$UrlLinkFmt = "<a class='plainlinks' href='\$LinkUrl' title='\$LinkAlt' rel='nofollow'>\$LinkText</a>";

*Question: StaticPageOutput.php gives the error "Could not open URL for copying". No cached pages are being generated, even if I go to admin page and refresh them. My server has "allow_url_fopen = Off" and I cannot turn it on to fix it. The error log shows "failed to open stream: no suitable wrapper could be found." What can I do? If curl is enabled, you can add the function file_get_contents_curl below to StaticPageOutput.php (just below include_once, line 11):

function file_get_contents_curl($url)

    {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_AUTOREFERER, TRUE);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);       
    $data = curl_exec($ch);
    curl_close($ch);
    return $data;
    }

And then change the call file_get_contents in that file to file_get_contents_curl instead. So instead of this:

    if (! ($wikiLinkPageContents = file_get_contents($wikiLinkAddress)) ){
     	echo "Could not open URL for copying:  " .  $wikiLinkAddress;
 	   return FALSE;
       }

use this:

    if (! ($wikiLinkPageContents = file_get_contents($wikiLinkAddress)) ){
       if (! ($wikiLinkPageContents = file_get_contents_curl($wikiLinkAddress)) ){
     	echo "Could not open URL for copying:  " .  $wikiLinkAddress;
    	   return FALSE;
       }
    }

See Also

• Cookbook.FastCache

Contributors

• MarkS