wiki: internal links - how to??
Posted by: SoerenB
Date: August 19, 2010 02:45PM

Hi,

the internal links on the Documentation page (4, in the first paragraph) don't work from their text body links, though the same 4 link targets are speedily presented when you click the links in the navigation box (?) above.

I did spend some time on that, but now I surrendered.

Is there any native English speaker out there who is expert enough with the wiki markup language to help me understanding the "anchors" paragraph here?

The words that are not clear enough for me are:
reference (as opposed to: refence(d) to and reference(d) from)
anchor name
link title

I miss clearer words like:
link (the screen range you click on), usually containing the
link text (blue text, and code representing it).
link target (contenmt jumped to, and code representing it)

Plus, I have a dim feeling that the info in that paragraph is not really consistent?

Please, can someone enlighten me ...

Cheers
SoerenB

No more own machines, because of addiction.
Don't know when I'll be back to normal ...

Re: wiki: internal links - how to??
Posted by: JamesD
Date: August 19, 2010 06:53PM

The page is incorrect. Some of the code is below.
We have documents both for [new users | #beginner] and ...

!! For New Users #[beginner]

The correct method for a link is like this code from MacroLanguage2.
From the table of contents
*[Comments | #comments]

The link
 #[comments]%%%
The link is begun in column 2 and is not part of the heading. The %%% is only to provide space below the link.

Have you found these pages?
http://kmeleon.sourceforge.net/wiki/WikiMarkup
http://kmeleon.sourceforge.net/wiki/ExtendedWikiMarkup

I don't claim to be much of a teacher, but I will be glad to answer any questions that I can.

Re: wiki: internal links - how to??
Posted by: SoerenB
Date: August 19, 2010 07:05PM

Thanks, JamesD,

but I'm afraid I'm not seeing the obvious. The "anchor" paragraph I was referring to is part of that "Extended Markup Language" page (your second link) - but I can't digest it.

I think the easiest would be if someone (you?) could repair the English page - then I could do the German one.

Cheers
SoerenB

No more own machines, because of addiction.
Don't know when I'll be back to normal ...

Re: wiki: internal links - how to??
Posted by: JamesD
Date: August 19, 2010 08:06PM

OK, I fixed it. The old code
!! For New Users #[beginner]
and the way I fixed the code
 #[beginner]
!! For New Users


Re: wiki: internal links - how to??
Posted by: siria
Date: August 19, 2010 09:10PM

Quote
JamesD
#[comments]%%%[/code]
The link is begun in column 2 and is not part of the heading.

I suppose with "column 2" you mean that blank at the beginning of the line... Just discovered (again?) this too a few minutes ago, that a blank there matters! grinning smiley
(Added some bookmarks stuff to FAQ, how to search and open folders)

Re: wiki: internal links - how to??
Posted by: SoerenB
Date: August 19, 2010 09:31PM

Quote

I suppose with "column 2" you mean that blank at the beginning of the line

that was "the obvious" which I had missed!

Docs should be ok now.

Thx, you both!

Cheers
SoerenB

No more own machines, because of addiction.
Don't know when I'll be back to normal ...

Re: wiki: internal links - how to??
Posted by: ndebord
Date: August 22, 2010 10:50PM

Quote
SoerenB
Quote

I suppose with "column 2" you mean that blank at the beginning of the line

that was "the obvious" which I had missed!

Docs should be ok now.

Thx, you both!

SorenB,

If part of the problem was in how the documentation was written, then perhaps this "draft" rewrite might be of some use.

============

Anchors are used to link inside of pages, instead of linking from page to page. Anchors are defined and referenced through use of the hash sign, which is placed inside of square brackets. Example: #[anchorname]

Use or reference requires you to use both the hash sign and the anchor name inside square brackets.

(Don't quite get what the next section is all about, but IF it is about how to put in instructions, THEN perhaps this would be proper???

Both Anchors and anchor references are remarked (entitled????) using quotation marks or the dash sign. Examples:


* #[anchor "Title for this anchor"].
* [#anchor2 "anchor2 jump link title"]

============

N

K-Meleon forum is powered by Phorum.