Test repository to check push and ssh key
Find a file
Daniel Arato (NISZ) 797fef3861 tdf#118535 DOCX export: save header image once
Writer used to dump the same image file as many times
as it was featured in different headers or footers in
the document, bloating the .docx file size.

This is countered by making all "relationships" in the
header*.xml.rels files point to the same image.

Change-Id: I44d72630289c721d58d8f7e208517df2f1fe621c
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/112656
Tested-by: László Németh <nemeth@numbertext.org>
Reviewed-by: László Németh <nemeth@numbertext.org>
2021-03-26 13:07:57 +01:00
.git-hooks
.github
.vscode
accessibility Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
android Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
animations Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
apple_remote Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
avmedia Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
basctl Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
basegfx Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
basic const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
bean cid#1473991 Dereference null return value 2021-03-25 15:46:43 +01:00
bin Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
binaryurp Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
bridges Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
canvas Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
chart2 const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
cli_ure Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
codemaker Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
comphelper const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
compilerplugins loplugin:unusedvarsglobal 2021-03-25 14:13:12 +01:00
config_host Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
configmgr Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
connectivity fix connectivity build 2021-03-25 12:11:42 +01:00
cppcanvas vcl: add initializer_list constructor to BitmapPalette and use it 2021-03-26 08:18:19 +01:00
cppu Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
cppuhelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
cpputools const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
cui tdf#134734 svx,sd: BackgroundFullSize 2021-03-25 11:11:53 +01:00
dbaccess loplugin:unusedvarsglobal 2021-03-25 14:13:12 +01:00
desktop const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
dictionaries@a968e48f9b
distro-configs Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
drawinglayer create operator bool for Bitmap 2021-03-26 11:58:03 +01:00
editeng const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
embeddedobj const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
embedserv Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
emfio WMF/EMF Convert all index type of Objects to unsigned 2021-03-25 14:25:13 +01:00
eventattacher Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
extensions const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
external external: update pdfium to 4450 2021-03-25 09:01:45 +01:00
extras tdf#140839 all ToTD images use 150x150px size 2021-03-25 22:36:16 +01:00
filter vcl: add initializer_list constructor to BitmapPalette and use it 2021-03-26 08:18:19 +01:00
forms const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
formula Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
fpicker const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
framework const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
helpcompiler
helpcontent2@a21d3cc17c Update git submodules 2021-03-26 01:24:11 +01:00
hwpfilter ofz#32499 overflowing pos 2021-03-26 11:51:21 +01:00
i18nlangtag Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
i18npool const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
i18nutil Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
icon-themes Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
idl Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
idlc Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
include tdf#118535 DOCX export: save header image once 2021-03-26 13:07:57 +01:00
instsetoo_native Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
io Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
ios Fix editing mistake for iOS build 2021-03-25 15:30:12 +02:00
javaunohelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
jurt Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
jvmaccess Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
jvmfwk Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
l10ntools Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
librelogo Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
libreofficekit Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
lingucomponent tdf#124173: Enable thesauruses in the iOS app 2021-03-25 09:06:39 +01:00
linguistic const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
lotuswordpro cid#1222240 silence bogus Untrusted divisor 2021-03-24 16:20:15 +01:00
m4 Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
nlpsolver Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
o3tl Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
odk Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
offapi tdf#134734 svx,sd: BackgroundFullSize 2021-03-25 11:11:53 +01:00
officecfg tdf#107588 Assign F4 shortcut to Image Properties in Writer 2021-03-25 14:21:47 +01:00
onlineupdate Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
oovbaapi Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
oox tdf#118535 DOCX export: save header image once 2021-03-26 13:07:57 +01:00
opencl Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
osx Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
package const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
pch Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
postprocess tdf#124173: Enable thesauruses in the iOS app 2021-03-25 09:06:39 +01:00
pyuno Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
qadevOOo Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
readlicense_oo update credits 2021-03-24 17:19:41 +01:00
registry Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
remotebridges Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
reportbuilder Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
reportdesign const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
ridljar Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sal const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
salhelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sax Revert "Fix typo" 2021-03-24 12:47:08 +01:00
sc sc: fix incorrect comment 2021-03-26 11:52:40 +01:00
scaddins Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sccomp Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
schema tdf#134734 tdf#141059 tdf#122508 cui,sw,xmloff: BackgroundFullSize 2021-03-25 09:49:33 +01:00
scp2 Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
scripting Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sd create operator bool for Bitmap 2021-03-26 11:58:03 +01:00
sdext loplugin:unusedvarsglobal 2021-03-25 14:13:12 +01:00
setup_native
sfx2 Added delete keyinput to listview, fixed reload() issues: solves tdf#138884 2021-03-26 08:46:28 +01:00
shell Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
slideshow Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
smoketest Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
solenv Include the pdfimport library constructor in the mobile apps if enabled 2021-03-25 14:27:34 +01:00
soltools
sot Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
starmath const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
stoc Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
store Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
svgio Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
svl tdf#140968 tdf#140978 XLSX import: fix lost rounded filters 2021-03-25 15:00:31 +01:00
svtools const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
svx tdf#34828 Give draw object a name when made 2021-03-25 20:28:30 +01:00
sw tdf#118535 DOCX export: save header image once 2021-03-26 13:07:57 +01:00
swext Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sysui Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
test Extract copy&pasted namespace list to XmlTestTools::registerODFNamespaces() 2021-03-26 09:07:59 +01:00
testtools Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
toolkit Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
tools tdf#58745 - Detect end of month when extending a date list 2021-03-25 09:42:40 +01:00
translations@943a62baf9
ucb const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
ucbhelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
udkapi Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
uitest Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
UnoControls Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
unodevtools const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
unoidl Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
unoil Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
unotest
unotools Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
unoxml Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
ure Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
uui Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
vbahelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
vcl ofz#32111 Timeout 2021-03-26 12:50:55 +01:00
winaccessibility Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
wizards ScriptForge - (scriptforge.py) String class 2021-03-24 18:38:42 +01:00
writerfilter const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
writerperfect Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmerge Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmlhelp Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmloff Extract copy&pasted namespace list to XmlTestTools::registerODFNamespaces() 2021-03-26 09:07:59 +01:00
xmlreader Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmlscript Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmlsecurity const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
.buckconfig
.buckversion
.clang-format
.editorconfig
.git-blame-ignore-revs
.gitattributes
.gitignore
.gitmodules
.gitpod.dockerfile
.gitpod.yml
.gitreview
antivirusDetection.vbs
autogen.sh
BUCK
config.guess
config.sub
config_host.mk.in
config_host_lang.mk.in
configure.ac tdf#124173: Enable thesauruses in the iOS app 2021-03-25 09:06:39 +01:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst external: update pdfium to 4450 2021-03-25 09:01:45 +01:00
g
hardened_runtime.xcent.in
install-sh
leak-suppress.txt
Library_merged.mk
lo.xcent
logerrit
Makefile.fetch
Makefile.gbuild
Makefile.in
README.cross
README.md
README.Solaris
Repository.mk tdf#124173: Enable thesauruses in the iOS app 2021-03-25 09:06:39 +01:00
RepositoryExternal.mk Rename LO Windows arm64 ID to aarch64 2021-03-23 23:46:12 +01:00
RepositoryFixes.mk
RepositoryModule_build.mk
RepositoryModule_host.mk
sanitize-ubsan-excludelist
setup.cfg
TEMPLATE.SOURCECODE.HEADER

LibreOffice

Coverity Scan Build Status CII Best Practices Translation status

LibreOffice is an integrated office suite based on copyleft licenses and compatible with most document formats and standards. Libreoffice is backed by The Document Foundation, which represents a large independent community of enterprises, developers and other volunteers moved by the common goal of bringing to the market the best software for personal productivity. LibreOffice is open source, and free to download, use and distribute.

A quick overview of the LibreOffice code structure.

Overview

You can develop for LibreOffice in one of two ways, one recommended and one much less so. First the somewhat less recommended way: it is possible to use the SDK to develop an extension, for which you can read the API docs here and here. This re-uses the (extremely generic) UNO APIs that are also used by macro scripting in StarBasic.

The best way to add a generally useful feature to LibreOffice is to work on the code base however. Overall this way makes it easier to compile and build your code, it avoids any arbitrary limitations of our scripting APIs, and in general is far more simple and intuitive - if you are a reasonably able C++ programmer.

The build chain and runtime baselines

These are the current minimal operating system and compiler versions to run and compile LibreOffice, also used by the TDF builds:

  • Windows:
    • Runtime: Windows 7
    • Build: Cygwin + Visual Studio 2019 version 16.5
  • macOS:
    • Runtime: 10.10
    • Build: 10.14.4 + Xcode 11.3
  • Linux:
    • Runtime: RHEL 7 or CentOS 7
    • Build: either GCC 7.0.0; or Clang 5.0.2 with libstdc++ 7.3.0
  • iOS (only for LibreOfficeKit):
    • Runtime: 11.4 (only support for newer i devices == 64 bit)
    • Build: Xcode 9.3 and iPhone SDK 11.4
  • Android:
    • Build: NDK r19c and SDK 22.6.2

If you want to use Clang with the LibreOffice compiler plugins, the minimal version of Clang is 5.0.2. Since Xcode doesn't provide the compiler plugin headers, you have to compile your own Clang to use them on macOS.

You can find the TDF configure switches in the distro-configs/ directory.

To setup your initial build environment on Windows and macOS, we provide the LibreOffice Development Environment (LODE) scripts.

For more information see the build instructions for your platform in the TDF wiki.

The important bits of code

Each module should have a README file inside it which has some degree of documentation for that module; patches are most welcome to improve those. We have those turned into a web page here:

https://docs.libreoffice.org/

However, there are two hundred modules, many of them of only peripheral interest for a specialist audience. So - where is the good stuff, the code that is most useful. Here is a quick overview of the most important ones:

Module Description
sal/ this provides a simple System Abstraction Layer
tools/ this provides basic internal types: 'Rectangle', 'Color' etc.
vcl/ this is the widget toolkit library and one rendering abstraction
framework UNO framework, responsible for building toolbars, menus, status bars, and the chrome around the document using widgets from VCL, and XML descriptions from /uiconfig/ files
sfx2/ legacy core framework used by Writer/Calc/Draw: document model / load/save / signals for actions etc.
svx/ drawing model related helper code, including much of Draw/Impress

Then applications

Module Description
desktop/ this is where the 'main' for the application lives, init / bootstrap. the name dates back to an ancient StarOffice that also drew a desktop
sw/ Writer
sc/ Calc
sd/ Draw / Impress

There are several other libraries that are helpful from a graphical perspective:

Module Description
basegfx/ algorithms and data-types for graphics as used in the canvas
canvas/ new (UNO) canvas rendering model with various backends
cppcanvas/ C++ helper classes for using the UNO canvas
drawinglayer/ View code to render drawable objects and break them down into primitives we can render more easily.

Rules for #include directives (C/C++)

Use the "..." form if and only if the included file is found next to the including file. Otherwise, use the <...> form. (For further details, see the mail Re: C[++]: Normalizing include syntax ("" vs <>).)

The UNO API include files should consistently use double quotes, for the benefit of external users of this API.

loplugin:includeform (compilerplugins/clang/includeform.cxx) enforces these rules.

Finding out more

Beyond this, you can read the README files, send us patches, ask on the mailing list libreoffice@lists.freedesktop.org (no subscription required) or poke people on IRC #libreoffice-dev on irc.freenode.net - we're a friendly and generally helpful mob. We know the code can be hard to get into at first, and so there are no silly questions.