View source for Libreoffice System Development Kit

= LibreOffice 25.8 SDK - Master Documentation Outline =
'''Target Audience:''' Comfac Interns & Documentation Team '''Objective:''' This outline maps out the entire LibreOffice SDK. Links to the original site are blocked by bot-protection. Interns must manually navigate to these sections, copy the text/code, and rebuild these pages as child-pages within the Comfac Wiki.
----

== 1. SDK Core & Setup ==
''These pages explain how to configure the environment before writing code.''

* '''Installation Guide:''' Details on <code>setsdkenv_unix.sh</code> / <code>setsdkenv_windows.bat</code>, environment variables (like <code>OO_SDK_HOME</code>), and compiling tools (GNU Make, compilers).
* '''Development Tools:''' Documentation for tools like <code>uno</code>, <code>unopkg</code> (for extensions), <code>cppumaker</code>, and <code>javamaker</code>.

== 2. API Reference Material (CRITICAL) ==
''This is the dictionary for the AI. It is the most important section to mirror.''

* '''IDL Reference (UNO IDL API):''' The complete index of all LibreOffice objects, interfaces, services, and properties.
* '''Java UNO Runtime Reference:''' API for the Java binding.
* '''C++ Reference:''' API for the C++ UNO runtime and helper classes.
* '''LibreOffice Basic Language Binding:''' Documentation on accessing UNO via macros.

== 3. The Developer's Guide ==
''This is the conceptual textbook. Interns must mirror the text and code snippets from every chapter.''

* '''Part 1: Core Fundamentals'''
** Chapter 1: First Steps (Bootstrapping UNO, environment setup)
** Chapter 2: Professional UNO (Concepts, technologies)
** Chapter 3: Writing UNO Components (Inner workings of service manager, UNOIDL)
** Chapter 4: Extensions (How to package and deploy <code>.oxt</code> files)
** Chapter 5: Advanced UNO (Language bindings, core reflection)
** Chapter 6: Office Development (Application framework features)
* '''Part 2: Document Models'''
** Chapter 7: Text Documents (Writer objects, formatting, text cursors)
** Chapter 8: Spreadsheet Documents (Calc objects, calculations, cells)
** Chapter 9: Drawings and Presentations (Draw/Impress, shapes, slides)
** Chapter 10: Charts (Embedded graphical representations)
* '''Part 3: Advanced Features'''
** Chapter 11: LibreOffice Basic (Macros and dialogs)
** Chapter 12: Database Access (Base connectivity)
** Chapter 13: Forms (Event-driven form controls)
** Chapter 14: Universal Content Broker (UCB) (File and resource access)
** Chapter 15: Configuration Management (Accessing <code>Tools > Options</code>)
** Chapter 16: JavaBean for Office Components (<code>OfficeBean</code> integration)
** Chapter 17: Accessibility (Accessibility API implementation)
** Chapter 18: Scripting Framework (JavaScript, Python, BeanShell integration)
** Chapter 19: Graphical User Interfaces (Creating consistent GUIs)
* '''Appendices'''
** A. Guidelines and Specifications
** B. IDL Documentation Guidelines
** C. Universal Content Providers
** D. UNOIDL Syntax Specification (IDL Grammar)

== 4. Framework Tutorials ==
''Specific how-to guides mentioned in the wiki.''

* Context Menu Interception
* Popup Menu Controller
* Statusbar Controller
* Accelerators Configuration
* Addon Menu Toolbar Merging
* Asynchronous Callback Service
* Easy To Use Message Boxes
* Generic UNO Interfaces for complex toolbar controls

== 5. SDK Examples Library ==
''Interns must download the actual source code files for these examples.''

* '''Java Examples:''' <code>BookmarkInsertion</code>, <code>HardFormatting</code>, <code>SWriter</code>, <code>StyleCreation</code>, <code>StyleInitialization</code>, <code>TextDocumentStructure</code>, <code>TextReplace</code>, <code>GraphicsInserter</code>, <code>WriterSelector</code>, <code>CalcAddins</code>, <code>ChartTypeChange</code>, <code>EuroAdaption</code>, <code>SCalc</code>, <code>SDraw</code>, <code>DocumentConverter</code>, <code>DocumentLoader</code>, <code>DocumentPrinter</code>, <code>DocumentSaver</code>, <code>Object Inspector</code>, <code>Minimal Component</code>, <code>PropTest</code>, <code>ToDo</code>, <code>EmbeddedObject</code>.
* '''Python Examples:''' <code>Tool Panel Poc</code>, <code>Document Converter</code>, <code>DocumentLoader</code>, <code>DocumentPrinter</code>, <code>DocumentSaver</code>, <code>BookmarkInsertion</code>, <code>Hard Formatting</code>, <code>SWriter</code>, <code>StyleCreation</code>, <code>StyleInitialization</code>, <code>TextDocumentStructure</code>, <code>TextReplace</code>, <code>GraphicsInserter</code>, <code>WriterSelector</code>, <code>ChartTypeChange</code>, <code>EuroAdaption</code>, <code>SCalc</code>, <code>SDraw</code>, <code>InputEvents</code>.
* '''C++ Examples:''' <code>Draw</code>, <code>DocumentLoader</code>, <code>Counter</code>, <code>Remote client</code>, <code>complextoolbarcontrols</code>.
* '''Basic Examples:''' <code>Changing Appearance</code>, <code>Replacing Text</code>, <code>Using Regular Expressions</code>, <code>Inserting Bookmarks</code>, <code>Creating an Index</code>, <code>Adapting to Euroland</code>, <code>Import/Export of ASCII Files</code>, <code>Stock Quotes Updater</code>, <code>Forms and Controls</code>.
* '''Additional Examples Repository:''' Interns must clone and mirror: <code><nowiki>https://gerrit.libreoffice.org/sdk-examples</nowiki></code>

== 6. Specifications ==

* '''OASIS OpenDocument Format (ODF):''' TC specifications.
* '''OpenOffice.org XML File Format:''' Legacy XML specs.

=== What is Missing That You Need to Download? ===
To put it simply, you currently have the "Table of Contents," but your AI tools need the actual "Book". Here is exactly what your interns must scrape and save to the Comfac Wiki:

# '''The API/IDL Reference:''' This is the absolute most critical missing piece. The AI needs to know the exact names of the UNO objects, methods, and properties (e.g., <code>com.sun.star.text.TextDocument</code>). Your interns must go to <code>api.libreoffice.org/docs/idl/ref/</code> and scrape the class definitions.
# '''The Actual Code Examples:''' The <code>Examples.pdf</code> tells us a <code>BookmarkInsertion.java</code> exists, but the AI needs the actual <code>.java</code> and <code>.py</code> files to see ''how'' the API is called. They need to extract the <code>.zip</code>/<code>.tar.gz</code> of the SDK or pull them from the gerrit repo (<code><nowiki>https://gerrit.libreoffice.org/sdk-examples</nowiki></code>).
# '''The Chapter Content:''' The 19 chapters of the Developer's Guide. The interns need to click into each of those chapters on the TDF Wiki and copy the text and code snippets explaining how the components work.
# '''Makefiles/Build Instructions:''' AI agents frequently fail at compiling C++ and Java UNO components because they don't know the specific build flags. The interns need to grab the <code>setsdkenv</code> scripts and example Makefiles.