2009-07-30 6 views
10

Quiero crear una docset para mi API que se ve y funciona como el docset Biblioteca corazón de la manzana. Por ejemplo, mira la página de NSString.¿Cómo puedo crear docsets Xcode que se ven y funcionan como los de Corazón de manzana Biblioteca

he tratado Doxygen y he tratado headerdoc2html. Tampoco lo hace muy cerca de lo que quiero.

Los archivos generados por headerdoc no tienen la mayor parte de la estructura de orden superior que los archivos de Apple hacen, y el diseño gráfico es diferente. Abajo en el nivel más detallado, como cuando se mira un método específico, las cosas están más cerca, pero no tienen toda la estructura detallada.

Los archivos generados por Doxygen tienen una estructura de alto nivel muy diferente, por no hablar de tener un diseño gráfico muy diferente.

¿Qué más debo probar? ¿O hay parámetros para cualquiera de estas herramientas que me darían algo más cercano?

Gracias, Pat

Respuesta

1

Usted puede utilizar Doxygen to generate Xcode docsets.

+0

La pregunta era cómo generar docsets de Xcode que se parecen a los que Apple ofrece para sus API. Si Doxygen puede hacer esto, aún no sé cómo. –

+0

oh, bueno, ¿en ese caso no puedes usar un CSS personalizado que se parece al de Apple? –

+0

O no entiendo todas las capacidades de los CSS o las diferencias son mucho más de lo que un CSS puede manejar. Por ejemplo, todas las cosas en la columna de la izquierda tienen una estructura completamente diferente, no solo apariencia diferente. He observado varios ejemplos del uso de doxygen además de mis propios experimentos. Todo lo que he visto muestra que la salida de doxygen tiene una estructura, formato y aspecto muy distintivos, que es muy diferente de la que entrega Apple. –

0

Desafortunadamente, la salida Doxygen mirar y comportarse como un desarrollador de Apple biblioteca de documentos aún no se ha descubierto ...

0

también estoy realmente interesado en este :(he sido capaz de generar docsets y documentos doxygen, pero si pudiera hacer que se vean iguales (o más cercanos) que los documentos "normales" de Apple (como SDK), sería mejor.:/

10

Lo mejor que he encontrado hasta ahora es Tomaz's appledoc. Con eso puedo crear documentación de la API estilo de la manzana e instalar directamente en los DocSets que Xcode se uisng. Funciona muy bien y se basa en doxygen.

+0

Hola Derek, Debería haber respondido antes. Hice ese proyecto editando a mano el HTML en agosto. (¡Uf! ¡Enorme, Ugh! Pero funcionó.) Cuando necesite actualizarlo, examinaré las cosas de Tomaz. No quiero aceptar una respuesta hasta que lo haya intentado, pero volveré a visitarlo cuando lo haya hecho. Gracias, Pat –

+0

Hay un buen ejemplo de representación (con appledoc) aquí: http://www.gentlebytes.com/content/appledoc/exampledoc/ (bueno, al menos mejor que la versión doxygen básica;) – yonel

+0

Sí, appleDoc sigue mejorando cada vez más. No, no lo escribí :-) – drekka

Cuestiones relacionadas