strepsirrhini/office-gobmx
9
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
office-gobmx/extras/README.md
Laurent Balland b4b4c53cf9 Update extras/README 
Follow-up of simplifications of makefiles by Christian
and new merge makefiles for all templates

Change-Id: I37b81f1371c306c26dd2009835a616dab37ee726
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/140537
Tested-by: Jenkins
Reviewed-by: Laurent Balland <laurent.balland@mailo.fr>
2022-11-01 19:59:31 +01:00

2.9 KiB
Raw Blame History

Extra Modules

Contains templates, clipart galleries, palettes, symbol font, autocorrections, autotexts etc.

  • How-to add a new gallery:

    • create a directory extras/source/gallery/foo/
    • create a .str file extras/source/gallery/foo/foo.str
    • add a foo section to extras/source/gallery/share/gallery_names.ulf
    • add a Gallery_foo.mk at the top-level (and mention in Module_extra.mk)
    • add a new GALLERY_FILELIST statement in scp2/

  • How-to add a new autotext category

    • create a directory extras/source/autotext/lang/xx/foo/ where xx is your lang code. xx must exactly fit with an UI lang code.
    • unzip your foo.bau autotext file in this directory (excluding an empty mimetype file)
    • add xx/foo.bau in extras/AllLangPackage_autotextshare.mk
    • in extras/CustomTarget_autotextshare.mk:
      • add all files contained in foo.bau (except mimetype) in extras_AUTOTEXTSHARE_XMLFILES

  • How-to add a new autotext to an existing category

    • create a directory extras/source/autotext/lang/xx/standard/FOO/ to add it in category standard of lang xx
    • add files of the autotext (at least FOO.xml for an unformatted autotext)
    • add autotext name in extras/source/autotext/lang/xx/standard/BlockList.xml
    • add all files of autotext in extras/source/autotext/lang/xx/standard/META-INF/manifest.xml
    • in extras/CustomTarget_autotextshare.mk:
      • add all files of autotext in extras_AUTOTEXTSHARE_XMLFILES

  • How-to add a new template category

    • add long category name in TEMPLATE_LONG_NAMES_ARY in sfx2/inc/doctempl.hrc
    • add short category name in TEMPLATE_SHORT_NAMES_ARY in sfx2/source/doc/doctemplates.cxx

  • How-to add a new template to an existing category

    • clean-up template file as indicated on wiki https://wiki.documentfoundation.org/Documentation/HowTo/Impress/Make_template_language_independent
    • recommendation for settings.xml are given on wiki https://wiki.documentfoundation.org/Documentation/CompatibilityFlags#Settings_to_include_in_a_new_template
    • add <dc:title>Foo</dc:title> in meta.xml to make presentation name translatable
    • choose a template category <Category>
    • unzip Foo.ot? (? = p, t, s or g) in extras/source/templates/<Category>/Foo (no space allowed in any file names)
    • add <Category>/Foo.ot? / in Package_templates.mk (or Package_tplpresnt.mk if it's a presentation)
    • in CustomTarget_templates.mk (or CustomTarget_tplpresnt.mk if it's a presentation):
      • add <Category>/Foo/meta.xml / and all files which are not automatically added in extras_TEMPLATES_XMLFILES (or extras_PRESENTATIONS_XMLFILES for presentation)
    • for translation of template name
      • define a new STR_TEMPLATE_NAMExx in include/sfx2/strings.hrc
      • define a new STR_TEMPLATE_NAMExx_DEF in sfx2/inc/strings.hxx
      • in sfx2/source/doc/doctempl.cxx
        • add STR_TEMPLATE_NAMExx_DEF to aTemplateNames
        • add STR_TEMPLATE_NAMExx to STR_TEMPLATE_NAME