Hi Andy
I like table of contents too , so I guess if Confluence can support large pages then we can indeed avoid creating additional custom
entry pages. I've seen your original update with the TOC and it looked good so if that can be made to work then it would be cool.
That said, over time, we migth also want to combine both approaches, custom entry pages plus TOCs per every page
Cheers, Sergey
Hi Sergey,
In opposite to approach you've mentioned, when working with confluence I
heavily rely on {toc} and other automation macros: once you have your titles
as headers (h1, h2...) its for free to get them dynamically computed and
listed using this simple magic spell -- manual TOC creation gets stalled too
fast. Same you can do using {children} macro for listing sub-pages.
I am not sure how wiki engine is integrated with main page but it seems that
URLs encoding is not done consistently that's why anchors are broken.
Personally I would prefer to make this working instead invest much more into
wiki pages rework :)
cheers,
andy.
Sergey Beryozkin-2 wrote:
Hi Andy
I've never used a {toc} macro so I can't comment. But it looks like, if we
look at say
http://cwiki.apache.org/CXF20DOC/jax-ws.html
that a pattern which has been followed so far is to introduce an entry
page which repersents the content and then
each link links to a seperate pageSo I was thinking of doing something
like that with the main page having similar links like :
Overview
Configuration
JAXRS and JAXWS
Building with Maven
etc
By the way, thanks for updating the docs with the info about
UriBuilder/UriInfo. Moreover, the UriBuilder implementation which you
did is of great help for me at the moment, with the client api prototyping
work, it was done just in time :-)
Cheers, Sergey
Recently I've added some content to JAX-RS section. Since its missing
table
of content I added it using {toc} macro. I've checked this on wiki edit
page
and everything was fine, however access from main site failed. Example
(reverted from wiki anyway):
working url:
http://cwiki.apache.org/confluence/display/CXF20DOC/JAX-RS+(JSR-311)#JAX-RS
(JSR-311)-Introduction
becomes not working fragment/anchor:
http://cwiki.apache.org/CXF20DOC/jax-rs-jsr-311.html#JAX-RS%2528JSR-311%2529-Introduction
Is that known issue, so we have to avoid TOCs?
cheers,
andy.
--
View this message in context:
http://www.nabble.com/TOC-wiki-URLs-fail-when-accessed-from-main-CXF-site-tp21905480p21905480.html
Sent from the cxf-dev mailing list archive at Nabble.com.
--
View this message in context:
http://www.nabble.com/TOC-wiki-URLs-fail-when-accessed-from-main-CXF-site-tp21905480p21910877.html
Sent from the cxf-dev mailing list archive at Nabble.com.
