moin icon indicating copy to clipboard operation
moin copied to clipboard

/+meta/help-en/markdown does not show any Item Links

Open RogerHaase opened this issue 3 years ago • 1 comments

Same problem with +meta/help-en/rst

All markdown items have this problem, including the sample item.

RogerHaase avatar Jun 03 '22 17:06 RogerHaase

In /help/en/rst.meta the itemlinks are included in the externallinks list:

"externallinks": [
    "http:Home",
    "http://www.python.org/",
    "http://moinmo.in/",
    "http:/users/Home",
    "http:rst/MissingItem",

UlrichB22 avatar Jun 03 '22 19:06 UlrichB22

Result in meta is now:

External Links: http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#enumerated-lists, http://moinmo.in/, http://www.python.org/
Item ID: 412d0e59c79147058ef2e947d1772d5f
Item Links: [help-en/rst/Home](http://localhost:5000/help-en/rst/Home), [help-en/rst/users/Home](http://localhost:5000/help-en/rst/users/Home), [Home](http://localhost:5000/Home), [rst/MissingItem](http://localhost:5000/rst/MissingItem)

Links moved from External links to Item links, but target seems to be wrong. E.g. first link is http:/Home with the comment link to a page in the default namespace of this wiki but it is pointing to http://localhost:5000/help-en/rst/Home

UlrichB22 avatar Mar 10 '23 17:03 UlrichB22

the links on /help-en/markdown suffer from the confusion between page-relative and wiki_root-relative wiki.local links

in moinwiki, the links work reverse of how href works in html:

  • wiki.local link starting with "/" is a relative to current path otherwise relative to wiki_root

in /help-en/markdown there appears to be expectation in both directions

  • there are working img tags where links don't start with "/" and refer to paths relative to wiki_root: under the Images heading we see working ![Alt text](help-common/logo.png "Optional title")
  • there are broken links which appear to expect the opposite [sibling item](Sibling) -> http://localhost:8080/Sibling but I'm thinking the author of the help page expects http://localhost:8080/help-en/Sibling

question 1: as a beginner user of moin, I am still suffering the gocha of the reversal of the role of the leading "/" in item links, can this be changed, or is it something that an experienced moin user would expect?

question 2: how is it supposed to work in markdown?

bylsmad avatar Mar 22 '23 13:03 bylsmad

Agree the help pages need more help. Moving the help items from the default namespace to the help-en namespace made some of the examples confusing and wrong.

There is this clause near the top: The examples below are dependent upon the use of the "help-en" namespace to separate help items from the main wiki content. Some target items may be missing from the default or users namespace.

The sibling link should be

|`[sibling item](../Sibling)`|[sibling item](../Sibling)|

markdown and moinwiki syntax both use a leading / to link to a subitem

Will open a new issue for fixing the help docs

RogerHaase avatar Mar 23 '23 16:03 RogerHaase

I did a bit of work on the help files already see #1373

bylsmad avatar Mar 23 '23 22:03 bylsmad

TODO: As of 2023-07-25, meta views for DocBook and HTML items still show "Item Links: (None)" in help-en namespace.

ReST, DocBook, and HTML show "Item Links: (None)" in default namespace.

RogerHaase avatar Apr 27 '23 21:04 RogerHaase