From c7e599e7c3c8ccc8bdc875435388e03a465c860d Mon Sep 17 00:00:00 2001 From: Stathis Sideris Date: Thu, 11 Feb 2016 09:26:19 +0000 Subject: [PATCH] doc: limitations --- README.md | 1 + doc/limitations.md | 22 ++++++++++++++++++++++ 2 files changed, 23 insertions(+) create mode 100644 doc/limitations.md diff --git a/README.md b/README.md index 8a1afda..21db410 100644 --- a/README.md +++ b/README.md @@ -60,6 +60,7 @@ change. Just add this to the dependencies of your `project.clj`: * [Pre-fabricated elements](doc/prefab.md) * [How-to](doc/howto.md) -- Task-driven documentation, recipes for common tasks. +* [Limitations](doc/limitations.md) ## Roadmap diff --git a/doc/limitations.md b/doc/limitations.md new file mode 100644 index 0000000..2c6315b --- /dev/null +++ b/doc/limitations.md @@ -0,0 +1,22 @@ +# Limitations + +Too many libraries leave the nasty bits out of the documentation, but +it's preferable to be upfront with your users. Here is a list of +limitations of the dali library that you should be aware of: + +* **Fonts and the web:** dali cannot magically fix the normal problems + that you encounter when using various fonts on the web -- if you + have used a fancy font, but the computer displaying does not have + it, the size/position will look wrong. This could be solved by + turning all text into curves (sometimes called "baking") but: +* **dali cannot bake text:** currently there is no way to bake the + text into curves to avoid the missing font problems. Baking would + have certain disadvantages (it increases the size of the document). +* **Batik rasterization is buggy:** I have found that in certain + sizes, shapes with filters will not render when you rasterize the + document. This is a Batik bug, and I found that changing the size by + a single unit seems to fix it. If you have a fully automated + pipeline that produces PNGs from SVGs, you may want to try using + Inkscape instead + [to rasterize your SVGs](http://tavmjong.free.fr/INKSCAPE/MANUAL/html/CommandLine-Export.html). +* **No ClojureScript version:** But hopefully there will be one soon.