[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