On 11/7/05, Wendy Smoak <[EMAIL PROTECTED]> wrote: > On 11/7/05, Rahul Akolkar <[EMAIL PROTECTED]> wrote: > > > Does anyone know if there is a way to generate the documentation > > without the pre blocks, or more generally with span blocks and a > > stylesheet of choice? To better illustrate my point, a before and > > after sample of the TLD docs overview page is here: > > > > http://people.apache.org/~rahul/struts/taglib-doc.html > > I'm not sure. The <pre> blocks are not in the TLDs, so they must be > coming from taglibrarydoc (https://taglibrarydoc.dev.java.net/) which > is used by the plugin. The documentation there does mention > customizing the output, but the process involves modifying the .jar. > <snip/>
Indeed, for example, for the overview-summary.html that I posted the before/after for, scroll to the bottom of the following stylesheet (long URL below, might be fragmented), you'll find the <pre> block: https://taglibrarydoc.dev.java.net/source/browse/taglibrarydoc/taglibrarydoc/src/share/com/sun/tlddoc/resources/overview-summary.html.xsl This isn't ASL code, thats a dead end AFAIAC. > > Another issue I noticed is that the taglib:tagreference goal seems to > > produce inconsistent internal anchors on the tagreference pages? > > Internal anchors are defined as "taglib-short-name:tag-name" and > > linked to as "#tag-name" so none of the internal anchors work. > > That seems to have been introduced in the 1.4.1 version of the Taglib > plugin. The links work fine if you generate the site with version > 1.4, (but then you get <base> instead of <base> in the summary.) > > > I guess this is all probably best clarified in maven taglib plug-in > > land, but appears they don't have mailing lists. > > I sent Fabrizio a note about the broken links. I'm sure he would > appreciate a patch to the m1 version of the taglib plugin if you're so > inclined. :) <snap/> Must you insist? ;-) On [ http://cvs.sourceforge.net/viewcvs.py/maven-taglib/maven-taglib-plugin/src/plugin-resources/taglibdoc.xsl?view=markup ] the discrepancy seems to be between line 84 (no short-name prefix) and lines 126-132 (short-name prefix). And ofcourse, this has a third license. I'll send him a note on his sf.net email. Hopefully, that should fix this one. > Meanwhile, please open a bug against the Struts site so > we don't forget to follow up on this. > <snip/> OK, in a bit. -Rahul > Thanks! > -- > Wendy > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
