Re: IDL Generation and MediaWiki [Was Re: Website Content plus Look and Feel Improvements]
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
IDL Generation and MediaWiki [Was Re: Website Content plus Look and Feel Improvements]
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 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
Re: IDL Generation and MediaWiki [Was Re: Website Content plus Look and Feel Improvements]
On Tue, Jul 5, 2011 at 2: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. 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. Another factor is the preservation of external links, including deep links into the OOo website. With MediaWiki we should be able to preserve the URL's or at least allow a trivial rewrite rule for redirections. With Confluence I think we would have a harder time. 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