[java] Javadoc reader & organizer

[flowerp]

Ik vroeg me af of iemand een methode weet om (onder Linux en/of Mac OS) Javadocs makkelijk te lezen en te beheren. Wat ik eigenlijk zoek is zoiets als de MSDN library waar je documentatie kunt indexen en een full text search op kunt uitvoeren.

De javadoc naar chm converter doet gedeeltelijk zoiets, maar ondanks alle pogingen (xchm) werkt dit nog steeds niet lekker onder Linux.

Wat ik al helemaal niet kan met die chm converter, is mijn verschillende Javadocs organiseren in 'books' die ik dynamisch kan toevoegen aan mijn collectie zodat de content wordt meegenomen in de library-wide index en search. De MSDN library kan dit wel.

Weet iemand een dergelijk oplossing voor javadoc?

[ronaldmathies]

Als je het alleen hebt over 3rd party docs (zoals die van sun zelf e.d.) dan kan je heel goed zoeken op www.jdocs.org. Hier staan inmiddels 136 API's beschreven met full text search.

Anders gebruik ik normaal gesproken gewoon find in files e.d.

[Alarmnummer]

Op JDocs staat alleen de j2se documentatie niet En verder heb ik het gevoel dat dat project geen lang leven beschoren is.. er staan zeker geen nieuwe api`s...

Ik gebruik zelf ook met erg veel plezier chm documentatie (vooral die van de j2se). Ik heb thuis ff een generator in elkaar gezet voor een chm-toc bestand en wil straks nog ff een generator in elkaar zetten voor chm-index bestanden. Dan kun je gewoon een directory verwijzen en wordt er netjes een chm van gemaakt.

Meerdere chm`s samenvoegen tot 1 systeem gaat denk ik niet lukken. Wat je wel kunt doen is die chm decompileren en laten indexeren door Lucene. (Gebruik ik thuis ook). Er zijn verder ook nog wat opensource projecten voor javadoc (kan je een server draaien met al je stuf erop). Alleen kan ik ze niet terug vinden... en weinig motivatie omdat ik met het chm gebeuren bezig ben.

[ Voor 3% gewijzigd door Alarmnummer op 28-03-2005 14:51 ]

[flowerp]

Alarmnummer schreef op maandag 28 maart 2005 @ 14:50:
Op JDocs staat alleen de j2se documentatie niet En verder heb ik het gevoel dat dat project geen lang leven beschoren is.. er staan zeker geen nieuwe api`s...

Ik gebruik zelf ook met erg veel plezier chm documentatie (vooral die van de j2se).

Ik gebruik dus zelf ook die van j2se en j2ee, maar onder OS X moet ik deze onder VPC draaien. Op Linux is er helemaal geen alternatief. xchm is gewoon dikke crap. Zoeken werkt niet, hyperlinks werken niet, etc. Ook is de chm viewer onder windows (htmlhelp) niet op te starten onder wine.

Meerdere chm`s samenvoegen tot 1 systeem gaat denk ik niet lukken.

Opzich moet het technisch wel kunnen. De MSDN library doet namelijk precies dit. De eerste keer dat ie een nieuwe chm tegen komt gaat ie hem zelf indexen en daarna staat de content gewoon in de main index. Het is niet helemaal drag en drop, want je moet wel zelf nog even een xml document aanpassen. Ik heb overigens geen documentatie gevonden van hoe je dit offcieel moet doen, maar als je in de meegeleverde bestanden van de MSDN library kijkt dan kun je met een beetje pielen vanzelf er wel achter komen.

Alleen kan ik ze niet terug vinden... en weinig motivatie omdat ik met het chm gebeuren bezig ben.

Het is toch wel opmerkelijk hoe weinig mensen er klaarblijkelijk een index en full tekst search waarderen. Ik zelf vind het echt super handig.