[pmwiki-users] Attach: Syntax and the Default Upload Quick Reference
Patrick R. Michaud
pmichaud at pobox.com
Thu Feb 2 16:55:07 CST 2006
On Thu, Feb 02, 2006 at 03:32:48PM -0700, H. Fox wrote:
> On 2/1/06, Patrick R. Michaud <pmichaud at pobox.com> wrote:
> > On Sun, Jan 29, 2006 at 03:35:27PM -0700, H. Fox wrote:
> > > That's a good point. What's needed appears to be
> > >
> > > (:if <$UploadPrefixFmt is ''>:)
> > > One instruction (site-wide).
> > > (:if <$UploadPrefixFmt is ''/$Group'>:)
> > > Another instruction (by group).
> > > (:if <$UploadPrefixFmt is ''/$FullName'>:)
> > > Yet another instruction (by page).
> > > (:if:)
> >
> > I think that's too complex for what we're trying to solve.
> > I'd prefer instructions that make sense regardless of the
> > configuration, if that's at all possible.
>
> It's possible, however the reference wouldn't be optimally helpful
> using the "least common denominator", would it? I think accurate
> Attach: syntax is important information to have there.
The only syntax that differs from one configuration to the next
is the Attach:file.ext syntax -- the others keep the same
interpretation regardless of configuration.
Attach:Group.Name/file.ext -- file.ext as seen by Group.Name
Attach:Name/file.ext -- file.ext as seen by either
{$Group}.Name (if it exists)
or Name.Name
If attachments are site-wide, then the syntax really
doesn't matter, since all attachments are available to all pages
and all three forms point to the same attachment.
If attachments are per-page, then saying "Attach:file.ext refers
to file.ext associated with the current page" is sufficient.
If attachments are per-group (PmWiki's default), I think it's still
okay to talk about attachments being associated with the "current
page", even though those attachments may be shared with other
pages in the current group. But I can see both sides of the issue
for this one.
At the end, I'm not sure that it's important at the quick-reference
level to get into a bunch of details about how the attachments
are internally organized--that's really an issue for the admin.
Essentially an author just needs to know
Attach:file.ext
-- link to an attachment
Attach:Name/file.ext
Attach:Group.Name/file.ext
-- link to an attachment from another group or page
(Once we make the switch so that Name/file.ext tends to associate
with another group instead of a page in the current group, I think
95% of the confusion that has existed will disappear.)
> Do you mean the code to do that would be too complex, or the quick
> reference page itself?
I was primarily meaning the quick reference page itself.
Pm
More information about the pmwiki-users
mailing list