extras/README

   1 Contains templates, clipart galleries, palettes, symbol font, autocorrections, autotexts etc.
   2
   3 How-to add a new gallery:
   4         + create a directory extras/source/gallery/foo/
   5         + create a .str file extras/source/gallery/foo/foo.str
   6         + add a [foo] section to extras/source/gallery/share/gallery_names.ulf
   7         + add a Gallery_foo.mk at the top-level (and mention in Module_extra.mk)
   8         + add a new GALLERY_FILELIST statement in scp2/
   9
  10 How-to add a new autotext category
  11         + create a directory extras/source/autotext/lang/xx/foo/ where xx is your lang code. xx must exactly fit with an UI lang code.
  12         + unzip your foo.bau autotext file in this directory (including an empty mimetype file)
  13         + add xx/foo.bau in extras/AllLangPackage_autotextshare.mk
  14         + in extras/CustomTarget_autotextshare.mk:
  15                 + add xx/foo in extras_AUTOTEXTSHARE_AUTOTEXTS
  16                 + add all files contained in foo.bau (except mimetype) in extras_AUTOTEXTSHARE_XMLFILES
  17                 + if foo.bau contains files with other extension than .xml, .rdf, .svm and .png
  18                         + add a CPY call at the end of the file
  19
  20 How-to add a new autotext to an existing category
  21         + create a directory extras/source/autotext/lang/xx/standard/FOO/ to add it in category standard of lang xx
  22         + add files of the autotext (at least FOO.xml for an unformatted autotext)
  23         + add autotext name in extras/source/autotext/lang/xx/standard/BlockList.xml
  24         + add all files of autotext in extras/source/autotext/lang/xx/standard/META-INF/manifest.xml
  25         + in extras/CustomTarget_autotextshare.mk:
  26                 + add all files of autotext in extras_AUTOTEXTSHARE_XMLFILES
  27                 + if some files have different extension from .xml, .rdf, .svm and .png
  28                         + add a CPY call at the end of the file
  29
  30 How-to add a new Impress template
  31         + clean-up template file as indicated on wiki https://wiki.documentfoundation.org/Documentation/HowTo/Impress/Make_template_language_independent
  32         + unzip Foo.otp in extras/source/templates/presnt/Foo (no space allowed in any file names)
  33         + add Foo.otp in Package_tplpresnt.mk
  34         + in CustomTarget_tplpresnt.mk:
  35                 + add Foo / in extras_TEMPLATES_PRESENTATIONS
  36                 + add files names contained in Foo.otp (except mimetype) in extras_PRESENTATIONS_XMLFILES
  37                 + if Foo.otp contains files with other extension than .xml, .svm, .svg, .png and .jpg
  38                         + add a CPY call at the end of file
  39
  40 How-to add a new Writer template
  41         + clean-up template file as much as possible, and choose a template category <Category>
  42         + unzip Foo.ott in extras/source/templates/<Category>/Foo (no space allowed in any file names)
  43         + add Foo.ott in Package_<tplCategory>.mk
  44         + in CustomTarget_<tplCategory>.mk:
  45                 + add Foo / in extras_TEMPLATES_<CATEGORY>
  46                 + add files names contained in Foo.otp (except mimetype) in extras_<CATEGORY>_XMLFILES
  47                 + if Foo.ott contains files with other extension than .xml, rdf, .svm, .svg, .png and .jpg
  48                         + add a CPY call at the end of file
  49
  50 How-to add a new template category
  51         + create a directory extras/source/templates/foo/
  52         + unzip your foo0.ott template files in extras/source/templates/foo/foo0
  53         + add Package_tplfoo and CustomTarget_tplfoo in Module_extras.mk
  54         + use other category Package_tplcategory.mk to create Package_tplfoo.mk
  55         + use other category CustomTarget_tplcategory.mk to create CustomTarget_tplfoo.mk
  56                 + replace all category by foo and CATEGORY by FOO
  57                 + add all files contained in foo0.ott (except mimetype) in extras_FOO_XMLFILES
  58                 + if foo0.ott contains files with other extension than .xml, .rdf, .svm, .svg, .png and .jpg
  59                         + add a CPY call at the end of the file
  60                 + optionally, replace extension ott (4 places)