tapestry-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ulrich Stärk <...@spielviel.de>
Subject Re: Document : Reference plan
Date Thu, 30 Sep 2010 18:35:24 GMT
So true.

The javadoc tag can be done in two ways: a macro that converts a fully qualified class name
to a 
link to the apidocs (easy) or a plugin that takes a class name, tries to look up a fully qualified

class name and converts that to a link to the apidocs (difficult).

You will only have fast if you can do without some of the features that confluence gives you.
That's 
due to the autoexport plugin not being actively maintained, having bugs and how confluence
works 
internally. Wokrking directly in confluence won't be possible because it's just too slow.

Uli

On 30.09.2010 18:35, Howard Lewis Ship wrote:
> Seems like getting Confluence to do what we want could be a full time job!
>
> My other request would be an easy way to link to JavaDoc.  Ideally,
> I'd be able to put {javadoc:Dispatcher} into my page, and (somehow)
> Confluence would locate
> http://tapestry.apache.org/tapestry5.2-dev/apidocs/org/apache/tapestry5/services/Dispatcher.html
> and create a link, labeled (in code font) "Dispatcher".  Is this even
> possible?
>
> I don't really care what mix of static (exported) HTML and live (via
> Confuence) content we have ... as long as it is easy to edit, easy for
> users to navigate, and fast.
>
> On Thu, Sep 30, 2010 at 1:27 AM, Christophe Cordenier
> <christophe.cordenier@gmail.com>  wrote:
>> Actually, we have to find a good design to display reference link to
>> ease navigation, and provide direct access to latest stable and
>> current versions, if we choose to move older releases on a dedicated
>> page, i don't think this is necessary. But is this a good design ?
>> @PMC members what's your opinions ?
>>
>> 2010/9/30 Ulrich Stärk<uli@spielviel.de>:
>>> It's still not optimal though. The js is included directly from confluence,
>>> something we should avoid. All resources should be locally served but there
>>> is no way around that if we use this macro. Is this really necessary?
>>>
>>> On 30.09.2010 09:46, Christophe Cordenier wrote:
>>>>
>>>> Weird, it seems to work today... Yesterday evening there was no JS
>>>> included
>>>>
>>>> 2010/9/30 Ulrich Stärk<uli@spielviel.de>:
>>>>>
>>>>> I don't know which page exactly you mean but
>>>>> https://cwiki.apache.org/TAPESTRY/documentation.html is looking fine
to
>>>>> me... Clicking the "more" link will expand the section, or is there
>>>>> anything
>>>>> else I'm missing?
>>>>>
>>>>> Uli
>>>>>
>>>>> On 29.09.2010 22:48, Ulrich Stärk wrote:
>>>>>>
>>>>>> This is probably due to the generated output not including the necessary
>>>>>> JavaScript or something. I'll investigate.
>>>>>>
>>>>>>
>>>>>>
>>>>>> Am 29.09.2010 um 21:25 schrieb Christophe
>>>>>> Cordenier<christophe.cordenier@gmail.com>:
>>>>>>
>>>>>>> FYI I have used
>>>>>>>
>>>>>>> https://www.adaptavist.com/display/AtlassianConfluence/cloak+macro
>>>>>>>
>>>>>>> and
>>>>>>>
>>>>>>> https://www.adaptavist.com/display/AtlassianConfluence/composition-setup+macro
>>>>>>>
>>>>>>> It works in preview mode but not in the generated site... I will
>>>>>>> continue to investigate
>>>>>>>
>>>>>>> 2010/9/29 Howard Lewis Ship<hlship@gmail.com>:
>>>>>>>>
>>>>>>>> FYI:
>>>>>>>>
>>>>>>>> {newcode:controls=true|linenumbers=true}
>>>>>>>>
>>>>>>>> looks nice
>>>>>>>>
>>>>>>>> On Wed, Sep 29, 2010 at 10:21 AM, Howard Lewis Ship<hlship@gmail.com>
>>>>>>>>   wrote:
>>>>>>>>>
>>>>>>>>> Confluence has options for both creating tabbed views
on pages, and
>>>>>>>>> for creating dynamically hidden/revealed sections.  I
think the
>>>>>>>>> latter
>>>>>>>>> might work well, so you start with a list of modules
and can expend
>>>>>>>>> them to get to the detail links for that module.
>>>>>>>>>
>>>>>>>>> BTW, instead of using the {code} macro, use the {newcode}
macro ...
>>>>>>>>> just noticed it. Much prettier output!
>>>>>>>>>
>>>>>>>>> On Wed, Sep 29, 2010 at 9:56 AM, Christophe Cordenier
>>>>>>>>> <christophe.cordenier@gmail.com>      wrote:
>>>>>>>>>>
>>>>>>>>>> Sorry for spamming, but i think that we have to discuss
these kind
>>>>>>>>>> of
>>>>>>>>>> thing before going further with Confluence documentation.
>>>>>>>>>>
>>>>>>>>>> Actually, i have chosed to display Tapestry IOC,
then CORE... then
>>>>>>>>>> display the reference links in each version
>>>>>>>>>>
>>>>>>>>>> What about the other modules, if you create a section
for every
>>>>>>>>>> module
>>>>>>>>>> the Documentation page will become un-readable...
>>>>>>>>>>
>>>>>>>>>> I suggest to create a page for reference links, but
i am not
>>>>>>>>>> convinced.
>>>>>>>>>>
>>>>>>>>>> Any idea ?
>>>>>>>>>>
>>>>>>>>>> --
>>>>>>>>>> Regards,
>>>>>>>>>> Christophe Cordenier.
>>>>>>>>>>
>>>>>>>>>> Committer on Apache Tapestry 5
>>>>>>>>>> Co-creator of wooki @wookicentral.com
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> ---------------------------------------------------------------------
>>>>>>>>>> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
>>>>>>>>>> For additional commands, e-mail: dev-help@tapestry.apache.org
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> --
>>>>>>>>> Howard M. Lewis Ship
>>>>>>>>>
>>>>>>>>> Creator of Apache Tapestry
>>>>>>>>>
>>>>>>>>> The source for Tapestry training, mentoring and support.
Contact me
>>>>>>>>> to
>>>>>>>>> learn how I can get you up and productive in Tapestry
fast!
>>>>>>>>>
>>>>>>>>> (971) 678-5210
>>>>>>>>> http://howardlewisship.com
>>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>> --
>>>>>>>> Howard M. Lewis Ship
>>>>>>>>
>>>>>>>> Creator of Apache Tapestry
>>>>>>>>
>>>>>>>> The source for Tapestry training, mentoring and support.
Contact me to
>>>>>>>> learn how I can get you up and productive in Tapestry fast!
>>>>>>>>
>>>>>>>> (971) 678-5210
>>>>>>>> http://howardlewisship.com
>>>>>>>>
>>>>>>>> ---------------------------------------------------------------------
>>>>>>>> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
>>>>>>>> For additional commands, e-mail: dev-help@tapestry.apache.org
>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> --
>>>>>>> Regards,
>>>>>>> Christophe Cordenier.
>>>>>>>
>>>>>>> Committer on Apache Tapestry 5
>>>>>>> Co-creator of wooki @wookicentral.com
>>>>>>>
>>>>>>> ---------------------------------------------------------------------
>>>>>>> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
>>>>>>> For additional commands, e-mail: dev-help@tapestry.apache.org
>>>>>>>
>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>>>> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
>>>>>> For additional commands, e-mail: dev-help@tapestry.apache.org
>>>>>>
>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
>>>>> For additional commands, e-mail: dev-help@tapestry.apache.org
>>>>>
>>>>>
>>>>
>>>>
>>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
>>> For additional commands, e-mail: dev-help@tapestry.apache.org
>>>
>>>
>>
>>
>>
>> --
>> Regards,
>> Christophe Cordenier.
>>
>> Committer on Apache Tapestry 5
>> Co-creator of wooki @wookicentral.com
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
>> For additional commands, e-mail: dev-help@tapestry.apache.org
>>
>>
>
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
For additional commands, e-mail: dev-help@tapestry.apache.org


Mime
View raw message