Subdirectories: NewFeatures.
2005-06-05
DWiki can now generate Atom feeds for recently changed pages and recently made comments, either for the entire DWiki or for some subtree of it. For comments, this can be down to an individual article.
At the moment, pages in the Atom feed are rendered without macros
except for CutShort, for efficiency reasons. All of the links
are turned into absolute links (with http:// et al), since this is
basically required. Nulled-out macros produce a small message to that
effect in the generated content, so that people reading the Atom feed
can tell that something is going on.
2005-06-03
The primary way of getting nested lists is now to indent the nested list entries relative to the parent list (entry). This looks visually better in plain ASCII for cases when there is a decent amount of text.
Although ChrisSiebenmann thought he wasn't going to, the old style of
nesting lists (multiple list start characters, eg ***) still
works. It turns out the GNU Emacs will properly autoindent for these
lists but not for real indented lists, plus sometimes they actually
look visually better.
The amount of old-style nesting is ignored in an indented context; it's treated as just a new level.
2005-06-02
You can now use LinkAbbrevs by name (not by URL) without a |; ie,
instead of writing [[<text>|]], you can just write [[<text>]].
This only happens if <text> wouldn't result in a link to a real page
or an external URL if there was no abbreviation.
Thus, one can write [[Google http://www.google.com/]] in the
page once, and later write [[Google]], and have it work out.
DWiki now lets you use spaces to separate things in [[....]] links
instead of |. If you do this, the last word is taken as the link
URL or page, and the rest are the link name. (| has priority over
this; DWiki tries space-separation only if there is no |.)
Thus [[Google Rules The Web http://www.google.com/]] turns into
Google Rules The Web.
You can use either side as an abbeviation later, for example: Google Rules The Web, Google Rules The Web. (See View Source.)
LinkAbbrevs done this way don't have to use |, as long as there is a
space in the value: [[Google Rules The Web]] still turns into
Google Rules The Web.
This allows somewhat more aesthetic long link name things.
Note that the opening [[ and the closing ]] have to be on the
same line in the wikitext.
2005-06-01
Page Names That DWiki Won't Serve
There are some paths and page names that DWiki categorically refuses to serve, even if they seem to resolve to real files. Because they're enforced by both low-level code and high-level code, they apply to DWiki pages, static files being served by DWiki, and even templates. (Technically they apply to comments too, but comments can't generate file names that violate these rules.)
What gets rejected:
Any path that includes a path component that starts with a
., ends with,vor a~, or isRCS.Any non-relative path that includes
..,., or a sequence//; usually this might appear in the URL of an incoming request. (Incoming requests are not supposed to include things like that. But ChrisSiebenmann declines to believe that everyone sending DWiki requests is going to do what they're supposed to.)DWiki will reject REDIRECT files that either have too many '..' entries (so that they are trying to escape the root of the page directory) or that fail these checks after they've potentially been converted from relative path names to absolute inside-DWiki paths.
When DWiki rejects bad paths, generally it says that there is no page by that name. Sometimes it rejects the request entirely in huge flames.
Redirection Files
Files in the page directory can create HTTP redirections, making it trivial to support plurals, moved/renamed pages, and so on. There are two ways of doing it:
REDIRECTcontent and symbolic links.If a file starts with a line that says '
REDIRECT somewhere', and does not have more than a few lines of content, DWiki considers it a redirection. The somewhere is basically interpreted as if it was appearing in a[[....]], so it can be:
- redirection to another DWiki page.
- redirection to an external web site, written as
http://....- redirection to an absolute URL on this web site, written as
<...>These files are generically called REDIRECT files.
A symbolic link is only considered a redirect if DWiki can 'resolve' it into an existing page. To resolve the symbolic link redirect, DWiki tries to interpret the symbolic link's value as if it was appearing in a
[[...]]as a DWiki relative page name.If the symbolic link doesn't resolve this way, DWiki treats the whole thing as an ordinary page; this keeps 'ordinary' uses of symlinks intact in most cases, including when the symlinks point to something outside the DWiki page directory.
Redirects to http:// links or absolute URL links are a convenient way of creating WikiWord abbreviations to external things for local use. Make an appropriate REDIRECT file, stick it in your Aliases area, and now every page in the DWiki can say GoogleSearch or something and get a link, bam.
(WikiWord redirection rewriting means that in many cases the generated link will even point to the real target instead of the REDIRECT file, as you can see here.)
A DWiki RedirectFile can now point to absolute URLs as well
as local DWiki pages. Absolute URLs are written like they would be in
[[...]]; either http:// or <...>.
DWiki now supports generating links to URLs on the wiki's web server
that are outside the DWiki itself. These are written as links in the
format <...> and have to happen inside [[...]]. For example:
See [[the root of this web server|</>]].
generates a link to the DWiki's web server's root, which is all but certain to be outside the DWiki space if you're running DWiki as a CGI-BIN.