Extension:DoxyWiki

Please note: our donwload host somtimes is offline, try latter if not work!

More..: comming up. this page in english.

Para que sirve Doxywiki
DoyWiki es una extension para MediaWiki que integra la documentacion generada por la herramienta doxygen dentro de la funcionalidad de Mediawiki. En nuestra empresa, desde hacia tiempo utilizabamos exitosamente Mediawiki como herramienta central de documentacion y disenio de nuestros desarrollos, con la desventaja de tener otra interface para la documentacion de referencia de nuestro codigo fuente. Por tal motivo he desarrollado esta herramienta que espero les agrade y sea util.

Como funciona?
Esta implementado en 2 partes:

La primera parte es un desarrollo en c++ integrado a doxygen (vea: Instalacion y Configuracion) este genera la organizacion jerarquica de la documentacion construyendo archivos formateados y likeados entre si a la manera MediaWiki.

Luego se utiliza la segunda parte, desarrollada en PHP en la forma de una SpecialPage de Mediawiki. Esta es responsable de los Indices generales y la renderizacion final para mostrar al usuario.

Instalacion y Configuracion
Para utilizar la herramienta por ahora son varios pasos... suerte!

Descargar doxygen y compilar
Lo primero que debemos hacer es descargar la revision 629 del SVN de doxygen y compilarla a la manera indicada para asegurarons que esta ok.

para obtener los fuentes de doxygen ejecute:


 * 1) mkdir doxygen-svn; cd doxygen-svn
 * 2) svn co https://doxygen.svn.sourceforge.net/svnroot/doxygen/trunk
 * 3) cd trunk
 * 4) ./configure
 * 5) make

Instalar el parche doxygen_r999_v9.patch
En la distribucion hay un archivo de extension .patch que es el parche que se debe aplicar a doxygen para que realize la salida con formato mediawiki.

.../doxygen-svn/trunk patching file wikidocvisitor.h patching file docvisitor.h patching file libdoxygen.pro.in patching file wikigen.cpp patching file doxygen.cpp patching file config.l patching file wikidocvisitor.cpp patching file pagedef.h patching file wikigen.h
 * 1) pwd
 * 1) cd src
 * 2) patch -p1 </location/of/doxygen_r999_v9.patch
 * 1) cd ..
 * 2) make

Instalar el componente PHP para MediaWiki
Dentro de la distribucion, hay una carpeta llamada Doxywiki. Esta debe ser copiada al directorio extensions de MediaWiki y como siempre se hace incluir en LocalSettings.php la siguiente linea...

require_once( "extensions/DoxyWiki/DoxyWiki.php" );

Configurar los proyectos de Doxywiki
Una vez instalado, se debe crear un articulo con el nombre 'Mediawiki:doxywiki projects'. Se recomienda protegerlo. En este se formatea por asi decirlo la tabla de proyectos doxywiki.

En esta tabla se asigna toda la informacion que esta extension necesita para generar acceder a los articulos y para la navegacion general, descripciones adicionales, etc.

Formato de Mediawiki:doxywiki projects:

... lets continue tomorro.