summaryrefslogtreecommitdiff
path: root/oox/README.md
diff options
context:
space:
mode:
authorHossein <hossein@libreoffice.org>2021-07-31 17:17:42 +0200
committerIlmari Lauhakangas <ilmari.lauhakangas@libreoffice.org>2021-08-14 11:46:46 +0200
commitba89f161432962d76a45288eb7289ffb7e128db2 (patch)
tree7e856af630964d4e3ee6c3a88478c450b60ded92 /oox/README.md
parentecfc229b090473ad28d4b6947e2e0e0d9cd3ef4b (diff)
Fixed documentation references to the custom shape generate script
* Fixed references to the custom shape generation script in the oox/README.md to use generate.sh instead of README.md * Added README.md to oox/source/drawingml/customshapes folder * Moved documentation parts from the script to the README.md The README script was renamed to generate.sh before in the commit 59577dbb84fae18a3216d57ffec6008af157ce9b Change-Id: Id167b32c7a101806c33126ea1642a0194d693231 Reviewed-on: https://gerrit.libreoffice.org/c/core/+/119376 Tested-by: Ilmari Lauhakangas <ilmari.lauhakangas@libreoffice.org> Reviewed-by: Ilmari Lauhakangas <ilmari.lauhakangas@libreoffice.org>
Diffstat (limited to 'oox/README.md')
-rw-r--r--oox/README.md22
1 files changed, 14 insertions, 8 deletions
diff --git a/oox/README.md b/oox/README.md
index e3bae26f0a03..73e7449e5602 100644
--- a/oox/README.md
+++ b/oox/README.md
@@ -19,10 +19,11 @@ preset type and the adjustment values, the reset can
be taken from the shape definition.
example of drawingml preset:
-
+```xml
<a:prstGeom prst="star5">
<a:avLst/>
</a:prstGeom>
+```
example of drawingml custom shape (equal to star5 preset):
```xml
@@ -134,11 +135,11 @@ needed.
In order to convert preset shapes to LO's enhanced custom shape,
we need to load shape definition of preset shapes. The procedure
to convert the definition from OOXML spec for LO is documented
-(also a script) in `oox/source/drawingml/customshapes/README.md`.
-The scripts in `oox/source/drawingml/customshapes/` also generate pptx
+in `oox/source/drawingml/customshapes/README.md`.
+The `oox/source/drawingml/customshapes/generate.sh` script generate pptx
files for single presets and also for all presets
-`cshape-all.pptx`. The cshape-all.pptx file is then loaded into Impress
-build with debug enabled in oox and the command line output contains
+`cshape-all.pptx`. The `cshape-all.pptx` file is then loaded into Impress
+build with debug enabled in `oox` and the command line output contains
information. The generated definition is `oox-drawingml-cs-presets`.
Check `CustomShapeProperties::initializePresetDataMap()` to see how
@@ -152,9 +153,14 @@ the cshape-all.pptx can be used to test the round trips. there's small
problem with these pptx as they cannot be imported into powerpoint,
but that can be fixed quickly. when fixed, we can use it to
test powerpoint odp export and see how complete it is regarding
-custom shapes. OpenXML SDK tools might help when fixing
-`cshape-all.pptx`
-<http://www.microsoft.com/en-us/download/details.aspx?id=30425>
+custom shapes. OpenXML SDK might help when fixing `cshape-all.pptx`
+
+<https://github.com/OfficeDev/Open-XML-SDK>
+
+Also, "OOXML Viewer VSCode Extension" is a useful tool for debugging
+OOXML documents.
+
+<https://github.com/yuenm18/ooxml-viewer-vscode>
## Export
Here is how LO's enhanced custom shapes are exported: