Uploaded image for project: 'Maven Doxia'
  1. Maven Doxia
  2. DOXIA-429

Broken link syntax in APT

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Minor
    • Resolution: Won't Fix
    • 1.2
    • None
    • Module - Apt
    • None

    Description

      A common cause of frustration is APT's linking feature. Consider this example: You want to link to an external resource without a name for the link. So you do write:

      {{http://truezip.java.net}}
      

      Some time later you decide you would prefer a name for the link, but you cannot insert

      {name}

      like so:

      {{{TrueZIP User Website}http://truezip.java.net}} // BROKEN!
      

      Rather than this, you have to reverse the order and write:

      {{{http://truezip.java.net}TrueZIP User Website}}
      

      So the URI effectively moves from

      {{URI}}

      to

      {{{URI}NAME}}
      

      This is really annoying!

      I know you can't change this without breaking compatibility. So please provide a new linking feature, probably something like this:

      [[URI]] and [[[NAME]URI]] respectively.

      Attachments

        Issue Links

          Activity

            People

              ltheussl Lukas Theussl
              christians Christian Schlichtherle
              Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: