Rationale:: Allow url rewriting for "pretty" URLs, adding GET arguments etc.
Input:
- one array reference with the following fields
- path : the path from the current document root
- basename: basename of the script to invoke (can be empty)
- vars: the query string, as key => value array
- anchor: anchor fragment, if any
- text: the link text
- attributes: additonal attributes for the a tag (style, etc) as key => value array
- data: additional contextual data, depending on the location. can be used to pass data to other MODs
- protocol: http(s) etc
- link: if the link is already assembled, it can be passed in this field. If so, the above fields will be ignored.
- path : the path from the current document root
- basename: basename of the script to invoke (can be empty)
- vars: the query string, as key => value array
- anchor: anchor fragment, if any
- text: the link text
- attributes: additional attributes for the a tag (style, etc) as key => value array
- protocol: http(s) etc
- link: if the link is already assembled, it can be passed in this field. If so, the above fields will be ignored.
Semantics: The links output to the user are assembled from the resulting array. This means that hooking modules can add arguments to the query string or change the link completely.