[pmwiki-users] Bug in Trails?

[Ulf Bro‏]

Hello

I am new to this list. But I already use PmWiki for more than 5 years
as our general documentation system in my company.

I have never used the Trails feature. However there might now be
situations where it might come in handy.

I might use both syntaxes

^|Indexpage|^ and
<<|Indexpage|>>

For the simple reason that the trails I am going to gather will be
highly structured. The reader will want to know in what chapter he is
(how to go "up") and how to continue/go back from where he is. This is
quite natural.

Now, when I do something like:

# Genesis
## Adam
## Noah
# Exodus
## Moses
## Joshua

I see the following when using ^|Indexpage|^ on "Noah":

Indexpage | Genesis | Noah

Indexpage is just a name (should have been a link)
Genesis is a link
Noah is a link (should have been just a name)

Is this a bug?

Ulf

_______________________________________________
pmwiki-users mailing list
pmwiki...@pmichaud.com
http://www.pmichaud.com/mailman/listinfo/pmwiki-users

[Petko Yotov‏]

Ulf Bro writes:
> # Genesis
> ## Adam
> ## Noah
>

> I see the following when using ^|Indexpage|^ on "Noah":
>
> Indexpage | Genesis | Noah
>
> Indexpage is just a name (should have been a link)
> Genesis is a link
> Noah is a link (should have been just a name)

To have a link to the index page, use a link to the index page:

^|[[Indexpage]]|^

The self-link on the current page is probably an error, but it is not
technically trivial to remove the link while keeping the link text in
different cases:

* [[Link]]ed with a suffix
* [[Lini|+]] with a title
* [[Link|with an alternative text]]

In this case, to remove the self links, you have two options:

1. Set in config.php a plain text format for all self links:

$LinkPageSelfFmt = '$LinkText';

This will remove the links from all self links, not only those in trail paths.

2. You can use CSS to style differently the self link. Add in your file
pmwiki/pub/css/local.css (if it doesn't exist, create it) one of the
following lines:

/* for wikitrail selflinks only */
.wikitrail a.selflink {text-decoration: none; color: black;}

/* for all selflinks, use instead of the previous line */
a.selflink {text-decoration: none; color: black;}

This way, you will have a self link which doesn't look like a link but like
plain text.

Petko P.S. For this type of path wikitrails, some people prefer the ">"
separator which can be set by adding to config.php such a line:

$TrailPathSep = ' &gt; ';

[Ulf Bro‏]

> > I see the following when using ^|Indexpage|^ on "Noah":
> >
> > Indexpage | Genesis | Noah
> >
> > Indexpage is just a name (should have been a link)
> > Genesis is a link
> > Noah is a link (should have been just a name)
>
> To have a link to the index page, use a link to the index page:
>
> ^|[[Indexpage]]|^

Yes. That solved it. Thank you! I should have known. Now that you say it
I read it also in the documentation. My fault.

> The self-link on the current page is probably an error...

> In this case, to remove the self links, you have two options:
>
> 1. Set in config.php a plain text format for all self links:
>
> $LinkPageSelfFmt = '$LinkText';

> ... etc ...

Thank you so much. All problems are solved.

Ulf