office-gobmx/extras
Kevin Suo 5da75fcb40 Templates: tdf#86483: Add "Localization" category and add a template for zh_CN
This patch adds a new template category named "Localization", to be used for
templates created by our l10n team for each locale, so that languages which
requires special layout or formatting (such as CJK or CTL) can have their own
templates bundled by default.

This patch aslo adds a (general purpose) Writer template for the Simplified
Chinese language. Chinese language, by convention, need to format the
document to have the first line of the paragraph be indented by 2 characters.
The font size, line spacing, paragraph margin etc also need special treatment.
If the Chinese users start writing using the current default Writer template,
they need to adjust the style formatting every time to meet their needs.
Although this template can be provided as an "extension" on the extension
website, in practice very few people will go to the extension website and
look for such templates.

Such bundled templates can also be added by other l10n teams. The
extras/README.md will be updated in a separate patch to include documentation
on how to add such templates and have their template names translatable on
weblate.

This does not completely resolve the issue in tdf#86483, which requests to
"Implement different default templates per locale". However, with this patch,
we are a step closer to set a choosen template when the user switch to a
certain UI.

Change-Id: Ic295482354f343e981eb20908907bd6a945b7120
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/140802
Tested-by: Jenkins
Reviewed-by: Laurent Balland <laurent.balland@mailo.fr>
2022-11-04 21:29:33 +01:00
..
source Templates: tdf#86483: Add "Localization" category and add a template for zh_CN 2022-11-04 21:29:33 +01:00
util
AllLangPackage_autotextshare.mk
CustomTarget_autocorr.mk Fix typo 2022-02-15 20:06:33 +01:00
CustomTarget_autotextshare.mk simplify autotextshare makefile/only build what's packaged 2022-02-10 11:35:04 +01:00
CustomTarget_autotextuser.mk simplify autotextuser makefile 2022-02-10 11:35:22 +01:00
CustomTarget_gallsystem.mk
CustomTarget_glade.mk
CustomTarget_opensymbol.mk
CustomTarget_templates.mk Templates: tdf#86483: Add "Localization" category and add a template for zh_CN 2022-11-04 21:29:33 +01:00
CustomTarget_tplpresnt.mk Fix typos 2022-10-15 17:47:57 +02:00
CustomTarget_tplwizard.mk Fix typo 2022-10-12 06:45:23 +02:00
Gallery_backgrounds.mk
Gallery_sound.mk
Makefile
Module_extras.mk Merge makefiles of Writer and Draw templates 2022-10-14 10:48:19 +02:00
Package_autocorr.mk
Package_autotextuser.mk
Package_cfgsrvnolang.mk
Package_cfgusr.mk
Package_database.mk
Package_databasebiblio.mk
Package_fonts.mk
Package_gallbullets.mk
Package_gallmytheme.mk
Package_gallroot.mk
Package_gallsystem.mk
Package_gallsystemstr.mk tdf#140681 Translate Bullets default gallery name 2021-04-27 15:23:05 +02:00
Package_glade.mk
Package_labels.mk
Package_newfiles.mk
Package_palettes.mk
Package_resource_fonts.mk
Package_templates.mk Templates: tdf#86483: Add "Localization" category and add a template for zh_CN 2022-11-04 21:29:33 +01:00
Package_tplpresnt.mk
Package_tplwizard.mk tdf#143956 Convert all Wizards template to XML 2022-10-11 20:55:19 +02:00
Package_tplwizbitmap.mk
Package_tplwizdesktop.mk
Package_wordbook.mk
Personas.mk
README.md Update extras/README 2022-11-01 19:59:31 +01:00

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