From c16158772d64cab8a4ed1f165cab57d307998e78 Mon Sep 17 00:00:00 2001 From: Hossein Date: Tue, 23 Mar 2021 14:20:32 +0430 Subject: Using .md extension/Markdown syntax for modules README Renaming all README files for all top level modules to README.md, applying no content change at this stage to be able to track history of the files. These files should be edited to use correct Markdown syntax later. Change-Id: I542fa3f3d32072156f16eaad2211a397cc212665 Reviewed-on: https://gerrit.libreoffice.org/c/core/+/112977 Tested-by: Jenkins Reviewed-by: Christian Lohmaier --- icon-themes/README | 66 --------------------------------------------------- icon-themes/README.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 66 insertions(+), 66 deletions(-) delete mode 100644 icon-themes/README create mode 100644 icon-themes/README.md (limited to 'icon-themes') diff --git a/icon-themes/README b/icon-themes/README deleted file mode 100644 index 79ca0ed54b87..000000000000 --- a/icon-themes/README +++ /dev/null @@ -1,66 +0,0 @@ -Icon repository for the applications - -All of the icons, separated by themes are included in this -directory. These icons are built into .zip files, and re-ordered / -packed for efficiency reasons based on our UI configuration by the -postprocess/CustomTarget_images.mk. - -An icon theme does not need to contain all images, since these can be -layered one on top of another. - -In general the layering is done like this: - - -breeze -colibre - -How to add a new image set: ---------------------------- - -- Create a directory for it here (let's call it e.g. new_set) - - FIXME: It is important to use an underscore '_' to delimit more words. - scp2 compilation crashes when using a dash '-'. - It evidently splits the name into two strings. - ^ It's probably not true anymore with filelists. - ^ if this gets changed, IconThemeSelector::SetPreferredIconTheme needs to change too - -- Add its name (new_set) to WITH_THEMES variable in configure.ac - -- The fallback for particular icons is defined be packimages_CUSTOM_FALLBACK_1 - in packimages/CustomTarget_images.mk - - -How to add a new icon for a new command: ----------------------------------------- - -- Assume you defined a dispatch command in officecfg like the following: - - in officecfg/registry/data/org/openoffice/Office/UI/CalcCommands.xcu - - - - ~Open... - - - 1 - - - - Here, you need to define a property named "Properties", with its value set - to 1 so that the icons show up. - -- Now, you need to add 2 new icon images under icon-themes/colibre/cmd/, one - for the large size and one for the smaller size. The name of each image - must be lc_.png and sc_.png. Here, the command - name is the name given in the above .xcu file without the ".uno:" prefix and - all its letters lower-cased. In this example, the file names will be - lc_openfromcalc.png and sc_openfromcalc.png. Note that you need to add new - images to the colibre theme for them to show up in any themes at all. - -How to call optipng to optimize size: ---------------------------- - -8 bit palettes are on the slow path for quartz/svp/gtk3 so avoid using palettes with... - -$ optipng -nc diff --git a/icon-themes/README.md b/icon-themes/README.md new file mode 100644 index 000000000000..79ca0ed54b87 --- /dev/null +++ b/icon-themes/README.md @@ -0,0 +1,66 @@ +Icon repository for the applications + +All of the icons, separated by themes are included in this +directory. These icons are built into .zip files, and re-ordered / +packed for efficiency reasons based on our UI configuration by the +postprocess/CustomTarget_images.mk. + +An icon theme does not need to contain all images, since these can be +layered one on top of another. + +In general the layering is done like this: + + +breeze +colibre + +How to add a new image set: +--------------------------- + +- Create a directory for it here (let's call it e.g. new_set) + + FIXME: It is important to use an underscore '_' to delimit more words. + scp2 compilation crashes when using a dash '-'. + It evidently splits the name into two strings. + ^ It's probably not true anymore with filelists. + ^ if this gets changed, IconThemeSelector::SetPreferredIconTheme needs to change too + +- Add its name (new_set) to WITH_THEMES variable in configure.ac + +- The fallback for particular icons is defined be packimages_CUSTOM_FALLBACK_1 + in packimages/CustomTarget_images.mk + + +How to add a new icon for a new command: +---------------------------------------- + +- Assume you defined a dispatch command in officecfg like the following: + + in officecfg/registry/data/org/openoffice/Office/UI/CalcCommands.xcu + + + + ~Open... + + + 1 + + + + Here, you need to define a property named "Properties", with its value set + to 1 so that the icons show up. + +- Now, you need to add 2 new icon images under icon-themes/colibre/cmd/, one + for the large size and one for the smaller size. The name of each image + must be lc_.png and sc_.png. Here, the command + name is the name given in the above .xcu file without the ".uno:" prefix and + all its letters lower-cased. In this example, the file names will be + lc_openfromcalc.png and sc_openfromcalc.png. Note that you need to add new + images to the colibre theme for them to show up in any themes at all. + +How to call optipng to optimize size: +--------------------------- + +8 bit palettes are on the slow path for quartz/svp/gtk3 so avoid using palettes with... + +$ optipng -nc -- cgit