Mi empresa está trabajando en los documentos de usuario final/desarrollador utilizando mediawiki. Me gustaría tomar muchos de los documentos API que phpdoc escupió (para funciones/métodos específicos) y tenerlos en el marcado wiki para una fácil transferencia.phpDocumentor to wiki?
¿Alguna solución para obtener el marcado de wiki o salida de wiki de phpDoc? Miré alrededor y no encontré nada.
Una opción (fuera de lo común) es utilizar la compilación API en MediaWiki, y publicar los datos usted mismo. (a través del script, por supuesto).
La única otra manera sería piratear phpDoc, e incluso entonces, tendría que publicarlo en MediaWiki de alguna manera.
De acuerdo con el sitio web PHPDocumentor y su documentation HTML y XML de salida es posible. A continuación, puede importar el XML utilizando las funciones integradas import de MediaWiki, aunque es posible que desee exportar primero para ver cuál es el formato del XML. También mencionan que el uso de XML para importar grandes cantidades de datos puede generar tiempos de espera y tener una alternativa que le permite crear consultas SQL para insertar los datos. También es probable que necesite una extensión para que MediaWiki muestre el código (algo así como SyntaxHighlight GeSHi).
Todo esto realmente no explica cómo convertir la salida de PHPDocumentor en algo utilizable con MediaWiki (es decir, usando la sintaxis de Wiki). Lo más probable es que use scripts para convertir una sintaxis en la otra. Parece que crear su propio formato de salida a través de PHPDocumentor es la manera más fácil (aunque la salida como XML: DocBook puede funcionar).
También puede convertir un documento XML en XML de estructura diferente mediante un script XSLT. Muy útil, y tiene buen rendimiento. –
Acabo de encontrar esto mientras busco una manera de generar una salida Twiki desde phpDoc. Tampoco he encontrado una buena solución para esto y he comenzado un proyecto aquí: http://step2.co.in/content/phpdoc-twiki para comenzar a trabajar en esto. Si alguien está interesado en ayudar, por favor póngase en contacto.
¿Alguna vez encontró o desarrolló una solución? Estoy interesado en tal solución. –