You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Lammert Westerhoff (JIRA)" <ji...@codehaus.org> on 2008/11/25 16:07:19 UTC
[jira] Created: (DOXIA-266) Section titles are not becoming
anchors.
Section titles are not becoming anchors.
----------------------------------------
Key: DOXIA-266
URL: http://jira.codehaus.org/browse/DOXIA-266
Project: Maven Doxia
Issue Type: Bug
Components: Module - Apt
Affects Versions: 1.0-alpha-11
Reporter: Lammert Westerhoff
Attachments: file.apt, file.html, Test.java
When I run a apt file with section titles in it, it does not create anchors for these titles.
Because of this reason, the toc macro also does not work.
The method Sink.anchor(...) is also only invoked once from the AptParser class at the place where it is resolving normal anchors and links.
In case the Sink implementing class should implement creating an anchor for each section, than the bug is in the XhtmlSink (which is the only one I've tested it with) but I don't see such a contract defined in the Sink interface so I assume this is the responsibility of the Parser.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Commented: (DOXIA-266) Section titles are not becoming
anchors.
Posted by "Lammert Westerhoff (JIRA)" <ji...@codehaus.org>.
[ http://jira.codehaus.org/browse/DOXIA-266?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=155576#action_155576 ]
Lammert Westerhoff commented on DOXIA-266:
------------------------------------------
So that means that I have to explicitly specify the anchors with {SectionTitle}? For both the alpha version and future version? Thats fine by me.
FYI: I got the documentation from http://maven.apache.org/doxia/references/apt-format.html, where it still says "Section titles are implicitly defined anchors.".
Thanks for the info.
> Section titles are not becoming anchors.
> ----------------------------------------
>
> Key: DOXIA-266
> URL: http://jira.codehaus.org/browse/DOXIA-266
> Project: Maven Doxia
> Issue Type: Bug
> Components: Module - Apt
> Affects Versions: 1.0-alpha-11
> Reporter: Lammert Westerhoff
> Assignee: Lukas Theussl
> Attachments: file.apt, file.html, Test.java
>
>
> When I run a apt file with section titles in it, it does not create anchors for these titles.
> Because of this reason, the toc macro also does not work.
> The method Sink.anchor(...) is also only invoked once from the AptParser class at the place where it is resolving normal anchors and links.
> In case the Sink implementing class should implement creating an anchor for each section, than the bug is in the XhtmlSink (which is the only one I've tested it with) but I don't see such a contract defined in the Sink interface so I assume this is the responsibility of the Parser.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Closed: (DOXIA-266) Section titles are not becoming anchors.
Posted by "Lukas Theussl (JIRA)" <ji...@codehaus.org>.
[ http://jira.codehaus.org/browse/DOXIA-266?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Lukas Theussl closed DOXIA-266.
-------------------------------
Assignee: Lukas Theussl
Resolution: Won't Fix
For the doxia alpha branch I assume this is indeed a bug, at least the documentation is not clear about it. However for the next version of doxia we decided to change the behavior, see in particular the discussion at DOXIA-236. This is already documented (in svn) on the site [1] and in the sink api ([2], see the javadocs for sectionTitle).
[1] http://svn.apache.org/repos/asf/maven/doxia/site/src/site/apt/references/doxia-apt.apt
[2] http://svn.apache.org/repos/asf/maven/doxia/doxia/trunk/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java
> Section titles are not becoming anchors.
> ----------------------------------------
>
> Key: DOXIA-266
> URL: http://jira.codehaus.org/browse/DOXIA-266
> Project: Maven Doxia
> Issue Type: Bug
> Components: Module - Apt
> Affects Versions: 1.0-alpha-11
> Reporter: Lammert Westerhoff
> Assignee: Lukas Theussl
> Attachments: file.apt, file.html, Test.java
>
>
> When I run a apt file with section titles in it, it does not create anchors for these titles.
> Because of this reason, the toc macro also does not work.
> The method Sink.anchor(...) is also only invoked once from the AptParser class at the place where it is resolving normal anchors and links.
> In case the Sink implementing class should implement creating an anchor for each section, than the bug is in the XhtmlSink (which is the only one I've tested it with) but I don't see such a contract defined in the Sink interface so I assume this is the responsibility of the Parser.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira