Mailing-List: contact ooo-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: ooo-dev@incubator.apache.org
Received-SPF: pass (athena.apache.org: domain of dave2wave@comcast.net
 designates 76.96.27.211 as permitted sender)
Content-Type: text/plain; charset=us-ascii
Mime-Version: 1.0 (Apple Message framework v1084)
Subject: IDL Generation and MediaWiki [Was Re: Website Content plus Look and
 Feel Improvements]
From: Dave Fisher <dave2wave@comcast.net>
In-Reply-To: 
 <CAOVv=gN8HVzrV8JM3uxSxtd0TmOi7nwQviP12_A2tDG4TjXHtQ@mail.gmail.com>
Date: Tue, 5 Jul 2011 11:04:01 -0700
Content-Transfer-Encoding: quoted-printable
Message-Id: <FABAD125-CBC2-4D2F-8BE8-EFE1D96AB524@comcast.net>
References: <9B1C83A5-2E28-46BC-B62B-C16B76576308@comcast.net>
 <1309667350.2224.4410.camel@linux-krcc.site>
 <CAOVv=gNWdhzTU_g0R2UpPZh_Krz_NsLCZoicvhTcVpQ1BMmuNw@mail.gmail.com>
 <4E102ED1.70001@wtnet.de>
 <CAOVv=gNgxz2oFR9bMr77rVyEpkDL5u3J6=DyHkqJ06My1tDjWA@mail.gmail.com>
 <4E1045E3.5040200@cfl.rr.com>
 <CAOVv=gOQCBMm6_ysOa17BVkQox850ziO4EV0ZNZRvFRV62Y9gg@mail.gmail.com>
 <B9516F76-E5CD-4D89-9B50-93AB838D23F7@comcast.net>
 <CAOVv=gMAkpx4K96i5jHa3RcR=sT050xjicEDLPvTRiivEFXdXg@mail.gmail.com>
 <E7450F10-5F02-4C33-9282-91813897FD7A@comcast.net>
 <CAOVv=gN8HVzrV8JM3uxSxtd0TmOi7nwQviP12_A2tDG4TjXHtQ@mail.gmail.com>
To: ooo-dev@incubator.apache.org

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.

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."?

(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 <dave2wave@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.
>>=20
>> 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?
>=20
> It's a MediaWiki extension, created by PediaPress -
> http://www.mediawiki.org/wiki/Extension:Collection
>=20
>=20
>>> - IDL Tags - custom (but simple) MW extension that creates links to
>>> the IDL library
>>=20
>> Do you mean these links:
>>=20
>> =
http://api.openoffice.org/docs/common/ref/com/sun/star/awt/XTopWindowListe=
ner.html
>>=20
>> We will need to rewrite these anyway. Tell me how these are marked up =
in MediaWiki.
>>=20
>> Is the IDL reference generated from the source code? We'll need to =
get into that workflow too.
>=20
> 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
>=20
>=20
>> No doubt this is a challenge in Confluence - it likes a flat =
hierarchy.
>>=20
>> If a MoinMoin Wiki is a better fit for conversion from MediaWiki we =
can certainly try it.
>=20
> 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.
>=20
>=20
> C.
> --
> Clayton Cornell       ccornell@openoffice.org
> OpenOffice.org Documentation Project co-lead