Class AptUtils
java.lang.Object
org.apache.maven.doxia.module.apt.AptUtils
A collection of utility methods for dealing with APT documents.
- Since:
- 1.1
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic String
encodeAnchor
(String id) Construct a valid anchor.static String
encodeFragment
(String text) Deprecated.This method was used for the original apt format, which removed all non alphanumeric characters from anchors.static boolean
isExternalLink
(String link) Checks if the given string corresponds to an external URI, ie is not a link within the same document nor a link to another document within the same site.static boolean
isInternalLink
(String link) Checks if the given string corresponds to an internal link, ie it is a link to an anchor within the same document.static boolean
isLocalLink
(String link) Checks if the given string corresponds to a relative link to another document within the same site.static String
Deprecated.This method was used for the original apt format, which removed all non alphanumeric characters from anchors.
-
Constructor Details
-
AptUtils
private AptUtils()
-
-
Method Details
-
encodeFragment
Deprecated.This method was used for the original apt format, which removed all non alphanumeric characters from anchors. UseencodeAnchor(String)
instead.Replace all characters in a text.AptTools.encodeFragment( null ) = null AptTools.encodeFragment( "" ) = "" AptTools.encodeFragment( "http://www.google.com" ) = "httpwwwgooglecom"
- Parameters:
text
- the String to check, may be null.- Returns:
- the text with only letter and digit, null if null String input.
-
isExternalLink
Checks if the given string corresponds to an external URI, ie is not a link within the same document nor a link to another document within the same site. This forwards toDoxiaUtils.isExternalLink(String)
.- Parameters:
link
- The link to check.- Returns:
- True if DoxiaUtils.isExternalLink(link) returns true.
- See Also:
-
isInternalLink
Checks if the given string corresponds to an internal link, ie it is a link to an anchor within the same document. -
isLocalLink
Checks if the given string corresponds to a relative link to another document within the same site.- Parameters:
link
- The link to check.- Returns:
- True if the link starts with either "/", "./" or "../".
- See Also:
-
linkToKey
Deprecated.This method was used for the original apt format, which removed all non alphanumeric characters from anchors. UseencodeAnchor(String)
instead.Transforms the given text such that it can be used as a link. All non-LetterOrDigit characters are removed and the remaining characters are transformed to lower-case.- Parameters:
text
- The text to transform.- Returns:
- The text with all non-LetterOrDigit characters removed.
-
encodeAnchor
Construct a valid anchor. This is a simplified version ofDoxiaUtils.encodeId(String)
to ensure the anchor is a valid Doxia id. The procedure is identical to the one inHtmlTools.encodeId(String)
:- Trim the id
- If the first character is not a letter, prepend the letter 'a'
- Any space is replaced with an underscore '_'
- Remove any non alphanumeric characters except ':', '_', '.', '-'.
- Parameters:
id
- The id to be encoded.- Returns:
- The trimmed and encoded id, or null if id is null.
-