Simon's profile

Jack of all trades ...

Features I use

the documentation to read if you're going to read documentation

• PmWiki.Available actions All PmWiki page actions (?action=) and other query parameters
• PmWiki.Blocklist Blocking IP addresses, phrases, and expressions to counteract spam and vandalism.
• PmWiki.Categories Categories are a way to organize and find related pages
• PmWiki.Comment markup various forms of comments and how to achieve them for wiki pages
• PmWiki.Conditional markup The if directive allows portions of a page to be included or excluded from rendering
• PmWiki.Deleting pages ($DeleteKeyPattern) Removing wiki pages
• PmWiki.File permissions PmWiki's settings for file and directory permissions in a typical Unix environment
• PmWiki.How To Get Assistance How to seek help and assistance and report PmWiki bugs
• PmWiki.Include other pages ($ImgExtPattern) Include contents from other PmWiki pages
• PmWiki.Markup expressions String and formatting operations
• PmWiki.Notify How to receive email messages whenever pages are changed on the whole wiki site, individual groups or selected watchlists of pages
• PmWiki.Page text variables Page variables automatically made available through natural or explicit page markup
• PmWiki.Security Resources for securing your PmWiki installation
• PmWiki.Site analyzer Analyse PmWiki security and software versions
• PmWiki.Analyze results Instructions and possible responses from using the Site Analyzer
• PmWiki.Troubleshooting Advice for troubleshooting an installation, keywords: deprecated, preg_replace, crypt, blank pages, headers, .flock, upgrade, create_function
• PmWiki.Url approvals and ($WhiteUrlPatterns) Require approval of Url links
• PmWiki.Uploads Allow authors to upload files, also known as page attachments
• PmWiki.Uploads admin ($UploadExts) Administration of PmWiki uploads
• PmWiki.Upload variables ($UploadNameChars) Variables used for uploads/attachments
• PmWiki.Wiki trails Trails from lists items from a single page
• $EnablePostAuthorRequired

Skins customisations used

• Skins:Skin change change skin via query or cookie setting

Trying out, but not yet got to work

• Cookbook.Clean Urls Enable URLs that are shorter (without .php) and/or look like paths to wiki pages.

Vaguely relevant

• Codehaus Manifesto
• Agile manifesto
• GNU manifesto

Config.php customisations used

• Markup('[[<]]', '[[<<]]', '/\\[\\[&lt;\\]\\]/', '<br style="clear:left;" />'); # break clear left
• Markup('[[>]]', '[[<<]]', '/\\[\\[&gt;\\]\\]/', '<br style="clear:right;" />'); # break clear right
• $PageSearchForm = '$DefaultGroup.Search'; # to fully use customised search page.
• $UploadNameChars = "-\w. !=+#"; # allow exclamations, equals, plus, and hash
• [[mailto:?Subject=<subject>: {*$Namespaced}&Body=From the <subject>: {*$Namespaced} &#40;{*$PageUrl}&#41; - {*$:Summary}|[-email page as link-]]]

My weapons

• Notepad++
• Win merge source file and directory comparison
• FileZilla ftp client and server
• Libre Office office suite
• Edge, ]]Vivaldi, Chrome, Firefox browsers

My CSS suggestions and customisations

When creating a skin simply include the original PmWiki CSS file, this ensures you benefit from pmwiki upgrades, viz

 @import url("/pmwiki/pub/skins/pmwiki/pmwiki.css");

Use CSS to suppress and change some elements of the page when printing (latterly pmwiki also uses this), eg

  @media print {
  /* style sheet for print */
    #wikilogo, #wikihead, #wikifoot, #wikileft, #wikicmds, 
   .wikitrail, .noprint {
  	display : none;
	}
  }

My template suggestions and customisations

Change the order of the skin CSS and run time CSS lines (which replace the Headertext) to ensure your customised skin CSS overrides the page by page generated CSS, viz

 <!--HeaderText-->
 <link rel='stylesheet' href='$SkinDirUrl/pmwiki.css' type='text/css' />

My configuration suggestions and customisations

Changes for config.php

• set up $EditTemplatesFmt

 # include DefaultGroup in page search
 $PagePathFmt = array ('$1.{$DefaultName}', '{$Group}.$1', '{$DefaultGroup}.$1', '$1.$1');
 # Authors must give a name
 $EnablePostAuthorRequired = 1;
 # Create a simple 'last changed page' for including on other pages
 $RecentChangesFmt['Site.LastChanged'] = '[-[[$Group.$Name]]-][[<<]]  ';
 # try to make recent changes show all recent changes (YMMV)
 if (preg_match('![./]RecentChanges$!', $pagename))
  $DefaultPageTextFmt = '(:include Site.AllRecentChanges lines=60 :)';
 $RecentChangesFmt['$Group.RecentChanges'] = '(:include Site.AllRecentChanges lines=60 :)';
 # add a soft break markup
 Markup('[[<]]', '[[<<]]', '/\\[\\[&lt;\\]\\]/', '<br />'); # break without clear all 
 # make search stay in group
 $PageSearchForm = '$DefaultGroup.Search';  

Set $EnableDiag and

 include_once("$FarmD/cookbook/analyze.php");
$AnalyzeKey = 'secret'; 

on one page only by creating a page specific configuration file.

PITS:PITS entries

Knows enough to be ...

Cookbook customisations used (favourites, recommended)

• Cookbook:Add image type Add new image type extension
• Cookbook:Add newline Make wiki text end with a newline character, so the last line won't be marked as changed if text is added at the bottom
• Cookbook:All group header How to create a page that appears as a header (or footer) for all pages in all groups
• Cookbook:Attach links Get Attach: links to display by default without the "Attach:" prefix
• Cookbook:Attachtable Actions to rename, delete, and restore deleted attachments, as well as an attachlist replacement to use those actions, show file types, and list attachment references.
• Cookbook:Attachlist enhanced How to list missing or orphaned attachments.
• Cookbook:Case correction Makes PmWiki intelligently case-insensitive
• Cookbook:Clean up Purge deleted pages and attachments from the server directories
• Cookbook:De Ob Mail Unobtrusive e-mail link (de)obfuscator now part of core
• Cookbook:DeltaBytesRecentChanges Display the number of bytes (characters) added or deleted to a page in RecentChanges.
• Cookbook:Drag Drop Multi Upload Allow authors to upload files by simply dropping them into the wiki page
• Cookbook:Edit templates ($EditTemplatesFmt) Specify a wiki page or pages to use as a template when a new page is created.
• Cookbook:Excel paste (Cookbook:Tabtable-jt) Copy and paste spreadsheet tables (e.g., from Excel) into pages (Support embedded line feeds, trim spaces and add prior patch (make first row a header))
• Cookbook:External links Configure external links to open in a new window, have a "tooltip title", or use other CSS classes
• Cookbook:Favicon Add a Favicon to your website
• Cookbook:Gui edit resize Allows resizing of the Edit text box, for convenience.
• Cookbook:Image map Directive to create image maps and image toolbars
• Cookbook:Include file How to include an external file (from the same file system)
• Cookbook:Include Url Include html pages into PmWiki 2.x pages
• Cookbook:Limit diffs per page Paginate the "diff" output (when viewing a page history, limit the number of displayed revisions at once)
• Cookbook:Link icons Add icons to your links according to their extensions.
• Cookbook:Markup extensions Adds a range of character, start of line, and link markup extensions
• Cookbook:More custom page variables Additional custom page variables for use in pages, forms, includes and conditional markup.
• Cookbook:New group box Input box to create new wiki groups from predefined template pages
• Cookbook:New page box plus Adds customisable box plus button form for page creation
• Cookbook:NotSaved Warning Warn authors when they move away from a page without saving it; optionally request an edit summary or an author name now part of core
• Cookbook:open pass Set a global password which is openly displayed to reduce spam
• Cookbook:Pagelist Auth List Short Display, in brief format, the permissions settings for pages that have permissions set.
• Cookbook:PageList Multi Targets Enable multiple pages and wildcards in PageList
• Cookbook:Pagelist Recent Changes A recent changes page created using Page lists
• Cookbook:Pagelist Site Map Create a sitemap using the page list directive
• Cookbook:Page Table of Contents Adds a clickable table of contents to a page
• Cookbook:Per Group Sub Directories Subdivide wiki.d into subdirectories according to page group
• Cookbook:Preview changes Preview highlighted changes of the wiki markup now part of core
• Cookbook:Random quote Insert random quotes or markup into a page
• Cookbook:Recent uploads log List all uploaded files in RecentUploads pages
• Cookbook:Recipe check Check for new versions of recipes on pmwiki.org
• Cookbook:Reminder Birthday, anniversary and other task reminders
• Cookbook:ROS patterns ($ROSPatterns) How to use $ROSPatterns, $ROEPatterns, and $TROEPatterns?
• Cookbook:Rowspan in simple tables Markup to add a rowspan attribute on a simple table cell
• Cookbook:Search patterns ($SearchPatterns) Q & A's on search patterns
• Cookbook:Shared pages and groups Share selected pages among several wikis on a common server, as in WikiFarms
• Cookbook:Spam filters Automatic blocking of some spambots
• Cookbook:System limits Ways to increase various memory and filesize limits for a PmWiki installation
• Cookbook:Thumb list Cookbook:Thumb list-Talk A thumbnail picture gallery for PmWiki
  • IPTC and EXIF metadata extraction for Cookbook:Thumb list, e.g. $ThumbList['EXIFvars']['x_orientation']='IFD0.Orientation';
• Cookbook:Toggle Adds links or buttons for toggling (hiding/showing) elements on a page
• Cookbook:Total counter A statistic counter - counts page views, users, languages, browsers, operating systems, referers, locations and web bots
• Cookbook:Upload form Alternative file upload form using (:input file:)
• Cookbook:Watch lists Track the most recent changes to a list of pages
• Cookbook:Wiki footer Website page footer

Last modified by me

(thanks Pico for the pagelist)

Watch list

General tips

Make Firefox refresh every time

type about:config in the location bar, right click on browser.cache.check_doc_frequency and select modify, change to 1 and Firefox will now check for a new version of the page on every page load

Safe Mode and uploads

try chmod 777 /home/username/public_html/pmwikiuploads/