Hi Christophe, On 12 Jun 2014 at 14:36:08, Christophe Domas ([email protected](mailto:[email protected])) wrote:

Hi,

Create a link on a header in the same page is painfull.

First reflex is to use the link syntax of the link [[label>>Space.Page#HMyheading]] as described http://platform.xwiki.org/xwiki/bin/view/Main/XWikiSyntax#HLinks and ommitting the "Space.Page”.

1) This is not correct :) If you check http://platform.xwiki.org/xwiki/bin/view/Main/XWikiSyntax#HLinks it says that this is for the XWiki Syntax 2.0 version. If you also check that page below in the "XWiki Syntax 2.1 Link Specification” section you can see that XWiki Syntax 2.1 the syntax is: [[label>>reference||anchor=“…”]] 2) The Syntax guide has been improved in recent versions of XWiki. For example: http://playground.xwiki.org/xwiki/bin/view/XWiki/XWikiSyntax?xpage=print

It seems quite natural but it does not work and we have to use the xwiki syntax link specification : [[label>>||anchor="HMyHeading”]]

Correct

Each time I have to do this, I spend a lot of time to retrieve this information (my co-worker too), so I create my own xwiki user guide but I think it should be more easy if this information stay on xwiki syntax...

Is it possible to add a new row in the the table of Links section with [[label>>||anchor="HMyHeading"]] ?

Point 2) above should fix this.

Or better, allow us to create links with [[label>>#HMyheading]]

Well this was what we had in XWiki Syntax 2.0 and we debated on the list about changing it for XWiki Syntax 2.1, see: http://markmail.org/message/drm6jq4mosjbryew I know it’s not perfect and I understand it takes longer to type it. Please read the mail thread and let me know if you have an idea on how to resolve this better than what we did. We won’t stop at XWiki Syntax 2.1, there’ll be a XWiki Syntax 2.2 so we can make changes if we find a better solution.

By the way, I'm not alone: http://xwiki.475771.n2.nabble.com/XWiki-anchor-syntax-doesn-t-work-td7582454...

Yes, the guy used the syntax for XWiki Syntax 2.0 while he was writing in a XWiki Syntax 2.1 document. Maybe you missed the fact that pages can be written in lots of syntaxes: http://platform.xwiki.org/xwiki/bin/view/Features/PageEditing#HChoosingaSynt... Thanks -Vincent

Best regards,

Chrisophe

On 06/13/2014 06:20 PM, Christophe Domas wrote:

Hi

I know that I first used the wrong 2.0 syntax in a 2.1 xwiki page, but the documentation misleading me; *Since XWiki Syntax 2.1 is based on XWiki Syntax 2.0 all syntax from XWiki Syntax 2.0 is valid unless the 2.1 specifications suggest differently.* And the sample table on Links section had only 2 columns: one for the 1.0 syntax and another for 2.0.

That is just because I have not finished the new guide before 5.3 :( So, yes, that should be fixed in production releases, both on the 5.4.x and 6.y lines

By the way, I think it is an excellent idea to have one syntax page per version. It is so much clearer and error prone. Is it already in production? (I'm still in 5.1 and migration is painfull cause I have no internet access from the server that host my xwiki).

I think this is real cuprit, running with outdated stuff and unfixed bugs. But that should be fixable :) On my little server farm it is done the following way: Edit xwiki.properties, and add one line: extension.repositories=maven-xwiki:maven:file:///path/to/some/directory/ This disables looking up the main *.xar files from http://nexus.xwiki.org/ and uses the local file system instead. (If you have extensions installed, you might likely want to set extension.repositories=extensions.xwiki.org:xwiki:http://localhost/xwiki/rest/ and install the "Extensions repostitory app", as suggested: http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Installation#HInstalling... I have to admit that I have not tried to do that, however) Download the xwiki-enterprise-ui-mainwiki-5.4.5.pom and xwiki-enterprise-ui-mainwiki-5.4.5.xar from http://maven.xwiki.org/releases/org/xwiki/enterprise/xwiki-enterprise-ui-mai... via some server that has internet access, and copy it on the production server: mkdir -p /path/to/some/directory/org/xwiki/enterprise/xwiki-enterprise-ui-mainwiki/5.4.5 and drop both *.pom and *.xar into that dir. (Actually in my case I have been using mvn install:install-file instead, and it actually installs a modified set of pages ... but it should still work the same. Repeat the same with xwiki-enterprise-ui-wiki-5.4.5.pom/xar if you have subwikis: http://maven.xwiki.org/releases/org/xwiki/enterprise/xwiki-enterprise-ui-wik... Distribution wizard should kick in and fetch the *.xar from the local file system instead of the network. Note: even though I say it works, I have only tested it in a somewhat different configuration, so better try this on some test instance first, or if production is all you have, then at least make a full backup ... and maybe dont do it on a Friday evening ;) Cheers Clemens