Change log

revision 28 — 2009/05/31 01:28:54 — Fil Salustri

Change log for xiki version 0.7X.

» Code

» Skins

» Content

Code

allgroups

New function; returns list of group names by looking in site config and all web config files.

allusers

New function; returns list of all user names by looking in $passwordfile.

Anchors

Ensured first char of anchors is internally uppercased, like topics.
Anchor text was not rendered if no topic given; fixed.
Now all spaces are properly converted to underscores.

BLOGSUMMARYSIZE

Removed this variable. Couldn't figure out how to make it work right.

calendar plugin

Fixed some bugs in processing stuff. Changed syntax of CALENDAR.
Now has links to next/prev months.
Now supports {from [Template DD MMM YYYY]} to collect items by topic name.

CHANGEPASSWORD

New function in admin.pl to process a change of password for an authenticated user.

chunk

Created chunk plugin and documented (new style) in text chunk.

CLEARLEFT

New variable added.

CLEARRIGHT

New variable added.

CLEARBOTH

New variable added.

"code" font mod

Implemented ={code}= syntax to highlight some monotype. Added styles and colours to Wa, Hurgh, and Wov skins.

Command Bar

Reimplemented to allow changes to the text shown for each command, and cleaned up formatting. Still not perfect, but better.

Comments

Added various functions; altered pipeline slightly to accommodate.
Changed processimmediates to pre-treat comments.

Compile

Now treats redirections.

config()

Fixed bug: when including topics, config was called recursively without sending a proper $scope variable.

DEFINE

HTML in DEFINE values was being interpreted on rendering. Now it's escaped.

DEFINED

New wikan function to determine if a variable is defined.

Definition Lists

Now, the dt part of a def list is automatically made an anchor too.

DEFMACRO

New directive to create simple substitution macros.

dir2files()

Added optional 2nd argument, a compiled regex. If present, it is used to filter the filenames to be returned.

Editing

When editing a long page, it was hard to remember when looking at the bottom of the preview that you were editing (and that you need to save). New template vars T:PREVIEWWRAP and T:PREVIEWWRAPEND which wrap just inside the div id=content in the templates. I use it to put the preview image into the edit pages but not the view pages.

escapemacros()

Removed processing of escaped newlines.

FFpagesummary()

Now leaves right number of newlines after parsing so that next chunk is processed properly.

FFstrippagesummary()

Now properly strips SUMMARY keyword from the text.
- Should rebuild search database to eliminate SUMMARY keyword completely.

FFtypicalsymbols()

Added ⇔ to auto-rendered symbols.

FINDALLORPHANS

Now searches every web. Also improved efficiency.
Now accepts args to limit which webs to check.
Can now produce a form that runs itself, or a URL.
Now checks only Main namespace: if there's no Main, then it doesn't make sense to consider the topic existent – which means it can't be an orphan.
Now only produces links. Actual finding moved to LISTORPHANS.

FINDUNDEFINEDPAGES

Tweaked to ignore escaped WRLs (that end with a hyphen). Updated find all orphans pages in other namespaces.
Avoids matching group names, which look like WRLs but aren't.
Avoids matching odd user names that look like WRLs, like [Every one].
Checks its own free args, and the CGI param webs for webs to check; uses all webs as default.
Avoids pages in Trash namespace, on premise they'll be removed completely, or reinstated eventually.
Can now produce a form that runs itself, or a URL.
Now only produces links. Actual finding moved to LISTUNDEFINEDPAGES.

FLOAT

New function.

FOR

New function.
Now supports the {separator "text"} clause.

Free formatter

Wikan constructs now seem to work.

FREEZE

new directive to make a variable immutable until THAW is called.

Glyphs

Added en dash to FFtypicalsymbols and its stripper.

Go box

Fixed a bug when starting an edit session; left a note explaining the problem. Current fix is ugly.

GOOGLE

New function that builds a google query from its text arguments.

handleversions()

Removed this subroutine.

handleview()

Sent $wrl instead of $page->{THEWRL} to memorizetopic().

Headings

Now headings include two anchors, one with the section number, and the other with the heading text.

HIDEFROMBREADCRUMBS

New directive added; used in web search pages to stop the search results from being stored in breadcrumbs.

HIDESECTIONNUMBERS

Variable removed from all code.

ICON

Now accepts {attr value} parameters to tweak the img tag that it generates.

IF

Now accepts newlines between its 3 clauses.

included topics

Now section headings in included topics are tweaked to be consistent given the section headings in the including topic. EG: A level 1 section included within a level 2 section comes out as a level 3 heading.

includeversiondiffs()

New function to tweak a page to render showing version differences.
New way to use rcsdiff:
- args used: --old-line-format="-%L" --new-line-format="+%L" --unchanged-line-format=" %L"
- In this way,
  - every line common to both versions starts with a space,
  - every line only in old version starts with -, and
  - every line only in new version starts with +.
- This is very easy to work with.

ISBROWSEABLE

New wikan function; just calls isbrowseable().

ISCHANGEABLE

New wikan function; just calls ischangeable().

JOIN

New function that joins its parts. A bit iffy, but works for now.

LINEAGE

New xiki function to get all the parents of a topic.

LISTDOWNLOADABLES

Fixed bug that showed the delete link to all users — was letting robots delete uploads. Now only authenticated users can delete uploads. It's still a problem for wide-open webs.

LISTORPHANS

New function; actually lists orphan topics. Doesn't work for-all-webs.

LISTUNDEFINEDPAGES

New function; actually lists undefined topics. Doesn't work for-all-webs.

LOCALCSS

New variable to allow CSS to be tweaked per-page.

makeanchortext()

New routine to convert text into something suitable for use in an anchor.

MAKEWEB

Fixed bugs from reimplementation from v0.6.

MODIFYCSS

New directive to allow CSS to be tweaked per-page.

MULTICOLUMN

Removed width=100% on <table> tag, which seems to fix the problem of tables being too wide in IE.

nolinks()

Inlined images (e.g. icons) were not being rendered in TOC. Fixed nolinks() to address this.
Now text from keywords is properly included.

normalisewrlparts()

Added a 3rd optional argument: a topic to use as default if a topic isn't given in the wrl. Used by FINDUNDEFINEDPAGES.
Added 4th optional arg for a preferred web. This is passed to findinwebpath as a new optional 3rd arg, where it is used in preference to THEWEB. This is used in FINDUNDEFINEDPAGES to suggest where a page should be rather than enforce it to be found there (or not).
Now handles [Web/] as an abbreviation for the web's home page.

NOW

New function.

OTHERWEBSINOTHERWINDOWS

New variable to selectively open topics in new windows/tabs.

PAGESUMMARY

Now a built-in variable set to $summaryformat.
Removed as a variable, and added to all skins.

pathinfo2wrl()

Now returns a wrl only if there is one in PATH_INFO; else it returns FALSE.

$predeleteaction($wrl)

New function pointer. When deleting a topic, if this points to a function, the function is run before deleting the topic. Example of use: to clean up keyword tags before deleting a blog topic.

printablewrl()

Now handles [Web/] as an abbreviation for the web's home page.
Now understands that web home is identical to Web home.

processfunvar()

Now partially compiles parameter values; does escaped macros, literals, variables and functions.

PROGENY

New xiki function to get the direct children of a topic.

RANDOMPAGE

New plugin to go to a random page, and added it to web config.

Raw view

Removed rendered version of page; now only shows the raw version.

RCS

Now double-quotes are used to capture filenames etc in rcs commands, cuz single quotes seemed to mash up odd filename characters, like apostrophe.
Now ignore version and only use branch number. Functions xiki2rcs and rcs2xiki translate version numbers.

Redirection

Implemented redirection from one page to another; new directive ($Dredirect), new processor (processredirect()), some new code in compile().

renaming topics

Implemented as a more action. Original destination is moved to Trash, then source topic is moved to destination.
Now updates references to moved topic in either a list of webs or, if list is missing, all webs.
new support functions:
- updatewrlref(actual wrl, original normalized wrl, new normalized wrl)
  and
  updatewrlrefs(old normalized wrl, new normalized wrl, string-list of webs to check for reference updates)

render()

Added new rule for escaped newlines.

renderdiffs()

Complete rewrite to leverage new use of rcsdiff.

renderheading()

Section anchors were formatted as 1.2.3. with a trailing dot, which ain't good. Rejigged to render the final dot, but not include it in the anchor.

rendertableargs()

Rewrote to fix sundry logic flow problems, triggered by screwing up row-wise mods on rows with th entries.

renderwrl()

Now checks for WRL aliases.

RESETPASSWORD

New function in admin.pl that resets a given user's password without knowing the old one. Only Site Admin can run it.

rewriteextendedwrl()

New function to rewrite wikan syntax for extended WRLs.

Rhtml regexp

Added iframe tag so that I can embed google maps in a page.

savewrl()

New optional third argument. If T, try to do a quiet save (no RCS check-in).
Before processimmediates, escaped macros and level 3 and 4 literals are set aside (with Store) so immediates that they contain are not processed during save.
No longer treats escaped macros as immediates.
No longer does MAJOR/MINOR saves; just plain SAVE.
Now has CHECKPOINT option implemented.

SECTIONNUMBERS

New function to turn section number rendering on/off.
Accepts (case insensitive) on|off|true|false|1|0 as legitimate values.

sendemail()

Now uses 2 xiki variables NOTIFSERVER and NOTIFSENDER defined in site config for the mail server and email address to use.
SMTP limits lines to 990 characters. Now insert newlines as required.
Changed xiki() to return its output, then it gets printed if !$asplugin.
Changed cronhits2 to run xiki as a plugin, then just print the return value.

SHOWVERSIONSINFO

New function that produces a table containing information about recent versions.

SKINMODSFROM

New variable; point to topic with skin mods.

SORT

New function for sorting content provided as text-arg. Only sorts tables by row, for now.

Status tags

In site config several keywords are defined with WRLSTYLE to be used as status tags because I didn't like the icons I have that are just gifs (and so can't be smartly manipulated).
They are: <<done>> <<updated>> <<closed>> <<obsolete>> <<todo>> <<new>> <<paused>> <<stopped>> <<refactor>>

storeescapemacros()

New routine – variation of escapemacros() that just stores a escaped macro constructs, not just the macro itself.

strikethrough font mod

Implemented -{strikethrough}- syntax.

stripwikan()

Added new rule for escaped newlines.

summaryformat

New internal variable to define the default format for the topic summary.
Removed in favour of using the skins to define the format of the summary.

Superscripts & Subscripts

superscripts and subscripts now (a) ignore surrounding whitespace and (b) use Rcurly to capture the text.

Tables

Added caption feature.
Added {bands on} and {bands #hhh #hhh} clauses.
Rewrote to clean up handling of options, including grid and related things.
- Not sure I like it, though, and I can't get single cells to have borders. Probably needs another rewrite.

THAW

new directive to make a variable made immutable with FREEZE mutable again.

THEPARENT

New builtin, read-only variable, defined in $page.

THESTATUS

New built-in, read-only variable defined in $page to store the status of THEWRL.

THESUMMARY

New built-in, read-only variable defined in $page to store the summary of THEWRL.

TOC

Tweaked rendering of long TOCs to show section number OR TOC item delimiter, but not both.

TODAY

New function.

translatercsdiff

Now encode HTML in the diffs to be shown.

unknownstatus

New internal variable to hold the default text/icon for unknown page status.

updatewrlrefs()

Now also updates the search db files.

Uploads

Raised max size of uploads to 10mb (less, considering encoding for transmission).

URLSINOTHERWINDOWS

New variable to open URLs in new windows/tabs.

validatepermissions()

Now checks properly for cases where Every one is given permission.
Now always returns TRUE if user is in Site Admin or Web Admin groups.

wrlparent(optionalWRL)

New function, returns the parent of the optionalWRL if given, or THETOPIC if missing.
If given, optionalWRL may or may not have square brackets.
Returns $defaulttopic if no parent defined.

WRLs

Added syntax (preceding + sign) to do 'extended' WRL formatting.

WRLALIAS

New function.
Now a directive, cuz as a function it wasn't loading in web config.

WRLSTATUS

New function to fetch STATUS field from WRLs.

WRLSTYLE

New directive to change rendering of specific WRLs.

WRLSUMMARY

New function to fetch summaries from WRLs.

Xiki()

Now uses lastvisitedtopic() to try to return users to last visited page if no wrl is specified.
Removed XIKIACTION for versions, and added one for more topic actions, and another for showing diffs.
When restarting, HIDEFROMBREADCRUMBS is set to FALSE, so that a Go search that leads to one page – and which causes a restart – will put that page in the breadcrumbs. Still, when there are multiple search hits, the web search page will not go into the breadcrumbs.
Now MESSAGES and DIAGNOSTICS are rendered with alert-like (but smaller) icons. DEFMACRO not used cuz these are rendered after the pipeline.

Skins

BlogEdit

Added button for QUIET SAVE.
Added button for CHECKPOINT; replaced MAJOR and MINOR buttons with SAVE.

BlogVersions

Skin deleted.

Hurgh

Created new skin, and Wov variant.
HurghEdit: Added button for CHECKPOINT; replaced MAJOR and MINOR buttons with SAVE.
Added extra padding to th and td tags.
Removed background colours from th.
Added new style span.strikethrough.

WaEdit

Added button for QUIET SAVE.
Moved edit help to right side, and put standard sidebar back on left.
Added button for CHECKPOINT; replaced MAJOR and MINOR buttons with SAVE.

WaMore

New skin file to support more topic actions.

WaShowdiff

New skin file to support the showdiff action.

WaStyle

Added a bit of vertical margin to rcsinfo class to separate the rcs info from text above & below.
Small aesthetic changes to STANDARDRCSINFO and STANDARDFOOTER. Tweaked colours of borders to be consistent.
Added a bit more space at top of page. But there's still too much space above some types of headings.
Added figurecaption CSS class and use it in FIGURE function.
Changed pre.raw style to make the raw view box as tall as needed to show the wikan without vertical scrolling.
Created div.edithelp class to help format the edit help stuff.
Added div.gotopagetop and div.gotopagebottom for the top/bottom of page icons.
Removed font-size specs for td and li tags.
Tweaked line-height to 1.3 for content elements like li, p, dt and dd.
Added span.redirectionnotice style for the notice boxes at top of page when redirected to a new topic.
Tweaked width of raw and lit boxes to fit better (I think/hope) on the screen.

WaVersions

Skin removed.

WaView

Added new anchors to the body of the page, for top/bottom of page links.
Added new templates for top/bottom of page icons, and put them in place.
Removed use of CMDVERSION in command bar.
Added use of CMDMORE in command bar.

Content

For new webs

Updated for new web files in Admin Web to reflect changes to 0.70.

Change password

New topic to let users change their passwords.

HurghSkin

New topic for Hurgh skin.

Icons

Uploaded a bunch of large-ish icons "borrowed" from mediawiki. Updated xiki icons to list them.
Created/uploaded new icons for progress, e.g. NOTDONE, and tweaked site config to use them.

Math symbols