On Tue, Jul 5, 2011 at 8:04 PM, Dave Fisher <dave2w...@comcast.net> wrote:
> Hi Clayton, > > I am separating into two sub-topics: > > (1) IDL Generation. > > Thanks for the link to what the Wiki uses to create a short hand for > various IDL links. This points out a very important topic that needs to be > co-ordinated. How do those the IDL Pages get generated. This needs to be > co-ordinated with the build. > the IDL documentation is generated from the IDL sources during the normal build process as part of the SDK build process. The generated docu is part of the SDK and i have updated the online version with every new release. The cross references from the wiki into the generated IDL reference and vice versa are a very useful and effective way to find the matching documentation. The IDL tags in the wiki (Developers Guide section) should be collected from time to time (with a wiki bot, process is not really finished yet when i remember it) and a generated list with tags referenced on wiki pages is used as source for the IDL reference generation during the build. This way we can guarantee a working links. The IDL tags are explained on the page that Clayton have already referenced. > > Who knows about the "UNOIDL - that is, the Unified Network Object Interface > Description Language compiler, which produces the content of api.oo.o, and > the input files."? > it's me ;-) and i think i have explained it above Juergen > > (2) MediaWiki vs. Confluence vs. MoinMoin vs. Apache CMS > > There are several issues. > > (a) A MediaWiki at AOOo is the easiest solution for the project - > short-term - most of the work is export/import. > > (b) A MediaWiki is not currently supported by Apache Infrastructure. > MediaWiki Infra would need to be built. > > (c) There are a number of special extensions being used in MediaWIki with > developers here who can support it. > > (d) For Confluence extensions / emulating the extensions that MW uses will > be a learning curve. > > (e) Export requires co-operation with current OOo wiki admins. Confluence > may require more. > > If a MediaWiki is what people want then we'll need to have several people > who will be dedicated to helping Infrastructure support it. Please join the > infrastructure-dev list and ask. Please share your contacts with the > MediaWiki admins here so that others who may want to explore the convertor > can make progress. If we have enough volunteers we can start on both and > abandon one if one becomes clearly better. > > Regards, > Dave > > On Jul 5, 2011, at 9:13 AM, C wrote: > > > On Sun, Jul 3, 2011 at 21:16, Dave Fisher <dave2w...@comcast.net> wrote: > >> On Jul 3, 2011, at 11:16 AM, C wrote: > >>> - PDF and ODT export. Confluence can do PDF, but cannot do ODT.. > >>> only MS Word DOC format (a significant issue in my view for an OOo > >>> Wiki... a bit sad and embarassing that we'd only be able to export a > >>> proprietary document format, and not the primary doc format that OOo > >>> is known for). Export to PDF and ODT is something a lot of people use > >>> for the OOo Docs - especially the Basic and Developer's Guides. > >> > >> I understand the need for ODT export. Tell us about the MediaWiki > extension that is being used, is it part of OOo or is it a third party > extension? > > > > It's a MediaWiki extension, created by PediaPress - > > http://www.mediawiki.org/wiki/Extension:Collection > > > > > >>> - IDL Tags - custom (but simple) MW extension that creates links to > >>> the IDL library > >> > >> Do you mean these links: > >> > >> > http://api.openoffice.org/docs/common/ref/com/sun/star/awt/XTopWindowListener.html > >> > >> We will need to rewrite these anyway. Tell me how these are marked up in > MediaWiki. > >> > >> Is the IDL reference generated from the source code? We'll need to get > into that workflow too. > > > > The IDL Extension is all documented here - including the full source > > of the extension itself, and how it's implemented/used within the Wiki > > text: > http://wiki.services.openoffice.org/wiki/Wiki_maintenance/IDLTagExtension > > > > > >> No doubt this is a challenge in Confluence - it likes a flat hierarchy. > >> > >> If a MoinMoin Wiki is a better fit for conversion from MediaWiki we can > certainly try it. > > > > I've never done a lot with MoinMoin, so can't really comment on that > > one. The book-like hierarchy in the existing MediaWiki is created by > > a combination of sub-pages and the TOC navigation. It is not really > > the perfect implementation, but it works and keeps things at least > > somewhat "book-like".... makes it possible to generate PDF books, and > > provides a book-like navigation or flow through a topic. The other > > choice, and something I experimented with, is huge monster long pages > > with entire chapters in a single Wiki page. This is a nightmare to > > try and edit and maintain. > > > > > > C. > > -- > > Clayton Cornell ccorn...@openoffice.org > > OpenOffice.org Documentation Project co-lead > >