[pmwiki-users] PmWiki 20 years, version 2.3.1 released

Jake D. Parsons jakedp at posteo.net
Wed Mar 2 10:47:17 PST 2022

On 1/15/22 07:03, Petko Yotov wrote:
> Hello,
> PmWiki version 2.3.1 was published today, and is available at:
>   * https://www.pmwiki.org/pub/pmwiki/pmwiki-2.3.1.tgz
>     <https://www.pmwiki.org/pub/pmwiki/pmwiki-2.3.1.tgz>
>   * https://www.pmwiki.org/pub/pmwiki/pmwiki-2.3.1.zip
>     <https://www.pmwiki.org/pub/pmwiki/pmwiki-2.3.1.zip>
>   * svn://www.pmwiki.org/pmwiki/tags/latest
> January 2022 is the *20th year anniversary* of the release of PmWiki 
> version 0.1, and 13 years since I (Petko) became core developer. This 
> merited additional work and effort with hopefully interesting and useful 
> new production.
> *PHP 5.3 - 8.1 compatibility*
>   * PmWiki 2.3.1 includes updates for PHP 8.0 and 8.1.
>   * Consequently, it requires PHP version 5.3 (released 2009) or more
>     recent.
> *PmSyntax*. A new function PmSyntax was added to the core, and enabled 
> on pmwiki.org.
>   * It highlights PmWiki syntax in the documentation, and possibly in
>     the basic edit form.
>   * It only highlights PmWiki markup, and is independent from
>     Highlight.js. See Cookbook:PmSyntax
>     <https://www.pmwiki.org/wiki/Cookbook/PmSyntax> and
>     |$EnablePmSyntax|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#EnablePmSyntax>.
>   * It should highlight most core language features and those of many
>     recipes, see this mashup of various markups
>     <https://www.pmwiki.org/wiki/Test/PmSyntax>.
>   * Developers can add custom rules in the |$CustomSyntax|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#CustomSyntax>
>     array, see Cookbook:CustomSyntax
>     <https://www.pmwiki.org/wiki/Cookbook/CustomSyntax>.
>   * The |(:markup:)| directive can now have |class=norender| to only
>     show the source code without processing it. This may be useful,
>     together with PmSyntax, in 2 cases: writing/discussing markup code
>     without actually running it, or working on PageList Templates where
>     you want to see and edit them highlighted.
> *Improvements to the edit form*
>   * PmSyntax (above) can be enabled to highlight the PmWiki markup the
>     edit form, and should work in recent standards-compliant browsers.
>   * The variable |$EnableNotSavedWarning|
>     <https://www.pmwiki.org/wiki/PmWiki/EditVariables#EnableNotSavedWarning>
>     is now enabled by default. Add to config.php
>     ||$EnableNotSavedWarning|
>     <https://www.pmwiki.org/wiki/PmWiki/EditVariables#EnableNotSavedWarning>
>     = 0;| to disable it.
>   * A new variable |$EnableIncludedPages|
>     <https://www.pmwiki.org/wiki/PmWiki/EditVariables#EnableIncludedPages>
>     allows listing of other pages included from the currently edited
>     page, with links to see or edit them. When the variable is enabled,
>     the list of pages appears in the edit form, after the text area, in
>     a collapsed <details> element. The list includes pages from which
>     text, text variables, or templates are included from the edited
>     page. This is enabled on pmwiki.org if you wish to preview it.
>   * The |$EnableEditAutoText|
>     <https://www.pmwiki.org/wiki/PmWiki/EditVariables#EnableEditAutoText> function
>     will now feel more like other text editors by removing the
>     automatically inserted bullet when Enter is pressed twice.
> *Dates and times, monitoring, review*
>   * The |{(ftime)}| Markup expression now accepts a new format '|%o|'
>     for the ordinal suffix of the date.
>   * The Notify <https://www.pmwiki.org/wiki/PmWiki/Notify> feature now
>     accepts a |tz=| timezone specifier for individual subscribers. See
>     Notify#tz <https://www.pmwiki.org/wiki/PmWiki/Notify#tz>.
>   * A function based on Cookbook:LocalTimes
>     <https://www.pmwiki.org/wiki/Cookbook/LocalTimes> was added to the
>     core. See the recipe page
>     <https://www.pmwiki.org/wiki/Cookbook/LocalTimes> for the
>     differences. You can continue using the recipe, or disable it and
>     enable the core function.
>   * New core variables |$EnableLocalTimes|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#EnableLocalTimes>,
>     |$CurrentLocalTime|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#CurrentLocalTime>.
>   * New markup |@2022-01-09T08:35:00Z| output as a <time> element,
>     formatted via |$TimeFmt|
>     <https://www.pmwiki.org/wiki/PmWiki/BasicVariables#TimeFmt>;
>     localized if |$EnableLocalTimes|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#EnableLocalTimes>.
>   * Added a variable |$EnableRecentUploads|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#EnableRecentUploads>
>     which makes it easy to enable the Recent Uploads feature on
>     AllRecentChanges. This is a basic format that may be good enough for
>     many wikis. For more options, see Cookbook:RecentUploadsLog
>     <https://www.pmwiki.org/wiki/Cookbook/RecentUploadsLog>.
>   * The default |$RecentChangesFmt|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#RecentChangesFmt> now
>     use the variable |$CurrentLocalTime|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#CurrentLocalTime> instead
>     of |$CurrentTime|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#CurrentTime>. In
>     the wiki source text it saves the timestamps in a portable time
>     format in GMT, which is then shown formatted per |$TimeFmt|
>     <https://www.pmwiki.org/wiki/PmWiki/BasicVariables#TimeFmt> (wiki
>     timezone). It looks just like |$CurrentTime|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#CurrentTime> did
>     previously, but can be converted to the visitor's time zone if
>     LocalTimes is enabled. If you have custom |$RecentChangesFmt|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#RecentChangesFmt> entries
>     that use |$CurrentTime|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#CurrentTime>,
>     nothing will change for you, but you may want to update these with
>     |$CurrentLocalTime|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#CurrentLocalTime> if
>     you want to benefit from localization.
>   * The "page history" page now has CSS classes for the delay between
>     edits: diffday, diffweek, diffmonth, diffyear. These allow styling
>     of vertical spacing between individual edits in page histories. See
>     Cookbook:DiffDelay <https://www.pmwiki.org/wiki/Cookbook/DiffDelay>
>     for an example.
>   * The page history can now have a "hidden" edit type, in addition to
>     "minor". This is intended to be used by recipes in order to hide,
>     rather than delete, some edits from the page history. A couple of
>     new recipes using this feature will be added in the next few days.
> *PageLists, categories, backlinks*
>   * PageLists <https://www.pmwiki.org/wiki/PmWiki/PageLists> now accept
>     a new argument |category=Name| which lists only pages declared in
>     the category with the markup |[[!Name]]|, and does not include pages
>     simply linking to |[[Category/Name]]| (unless they also contain
>     |[[!Name]]|).
>       o The differentiation between links to !Name and Category.Name
>         requires the pages containing category links to be re-indexed;
>         see Cookbook:ReindexCategories
>         <https://www.pmwiki.org/wiki/Cookbook/ReindexCategories> which
>         can automate this.
>   * Also in PageLists, the arguments |link=| and |category=| now accept
>     multiple and negative specifiers, and wildcards. See
>     PageLists#wildcards
>     <https://www.pmwiki.org/wiki/PmWiki/PageLists#wildcards>. If you
>     previously used the recipe Cookbook:PageListMultiTargets
>     <https://www.pmwiki.org/wiki/Cookbook/PageListMultiTargets>, please
>     disable it when you upgrade to 2.3.0.
>   * Category links can now have a different text, like |[[!Name|Text]]|,
>     and the markup generally behaves like other links, see PITS:01095
>     <https://www.pmwiki.org/wiki/PITS/01095>.
> *Styles* (core skin PmWiki-responsive)
>   * Collapsible sections details+summary will now change the cursor to
>     the "pointer" style over the clickable element, and the color will
>     change to "navy".
>   * The core table of contents function (|$PmTOC|
>     <https://www.pmwiki.org/wiki/PmWiki/LayoutVariables#PmTOC>) has had
>     its styles updated, in order to properly indent long sub-headings.
> *Core helper functions*
>   * A new helper function PSFT() can now be used as an /almost/ drop-in
>     replacement for strftime() and gmstrftime() which became deprecated
>     in PHP 8.1. Please review the documentation at Functions#PSFT
>     <https://www.pmwiki.org/wiki/PmWiki/Functions#PSFT>. If you have
>     local configurations or recipes using strftime() you can change for
>     PSFT() now.
>   * A helper function DownloadUrl(|$pagename|
>     <https://www.pmwiki.org/wiki/PmWiki/BasicVariables#pagename>, $path)
>     was added, see Functions#DownloadUrl
>     <https://www.pmwiki.org/wiki/PmWiki/Functions#DownloadUrl>. It can
>     simplify the handling of attached files by recipes.
> Last but not least, *the documentation* in English has been updated with 
> the latest development (and in German by MFWolff).
> See also Upgrading from version 2.2.145 to 2.3.0 
> <https://www.pmwiki.org/wiki/PmWiki/Upgrades#v22v23>.
> Note: /Our release script wasn't configured for a change from 2.2.x to 
> 2.3.x and unexpectedly zeroed the $VersionNum variable which broke some 
> settings in 2.3.0. This quick 2.3.1 release fixes it./
> As always, if you have any questions or difficulties, please let us know.
> Petko
> _______________________________________________
> pmwiki-users mailing list
> pmwiki-users at pmichaud.com
> http://www.pmichaud.com/mailman/listinfo/pmwiki-users

Congratulations for 20 years! A pmwiki user for over a year now and a 
refuge from DokuWiki. A year later and still amazed at what I consider 
the best PHP, webpage period, software out there. I have been doing 
websites for about 20 years now mostly personally but sometimes 
professionally. pmwiki was the software I was always looking for. A 
toast for another 20 years!

Thank you for bringing my enjoyment of writing webpages back.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: OpenPGP_signature
Type: application/pgp-signature
Size: 840 bytes
Desc: OpenPGP digital signature
URL: <http://www.pmichaud.com/pipermail/pmwiki-users/attachments/20220302/7f723e1a/attachment.sig>

More information about the pmwiki-users mailing list