Commit bc3543db authored by Etienne Nadji's avatar Etienne Nadji
Browse files

Documentation : Missing spec doc & suggestions

	modifié :         source/articles/en/spec-suggestions.rst
	modifié :         source/articles/en/spec.rst
parent 2836effb
......@@ -5,13 +5,14 @@ SLA's enhancement suggestions
# 1
===
The case used of element names and attributes should be clearly defined and homogeneous.
The case used of element names and attributes should be clearly defined and
homogeneous.
Discussion
----------
Almost every text case is used for element's names attributes. But XML/XSL tools
are case sensitive by default.
Almost every text case is used for element's names attributes. But XML / XSL
tools are case sensitive by default.
Why ``DOCUMENT/MASTERPAGE``, ``DOCUMENT/PAGEOBJECT/LATEX/PROPERTY``,
``DOCUMENT/Sections/Section`` ?
......@@ -30,6 +31,12 @@ It makes no sense to have a LATEX element with GnuPlot instructions.
# 3
===
Percentages in attributes should have the same format, instead of mixed
decimal (0 -> 1) / integer (0 -> 100) format.
# 4
===
Attribute names should be in only one language, so the remaining german
attributes should be translated.
......@@ -37,3 +44,4 @@ Discussion
----------
``<LAYERS NUMMER="0" LEVEL="0" NAME="Fond de page" SICHTBAR="1" DRUCKEN="1" EDIT="1" SELECT="0" FLOW="1" TRANS="1" BLEND="0" OUTL="0" LAYERC="#000000"/>``
......@@ -3,45 +3,56 @@
In all XPath location path listed here, we omit ``/SCRIBUSUTF8NEW/DOCUMENT``.
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| XML | Explanation | Value | Default | Optional |
| element/attribute | | | | |
+===================================+=======================+=======================================================+==================+==========+
| ``/@DPInCMYK`` | ICC profile for CMYK | string | | Yes |
| | images | | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/@DPIn3`` | ICC profile for CMYK | string | | Yes |
| | colors | | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/@PAGEC`` | Scribus GUI page | hexadecimal color | ``#ffffff`` | |
| | background | | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/LAYERS/@FLOW`` | | integer as boolean | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/LAYERS/@TRANS`` | Layer’s opacity | percentage | ``1`` | |
| | | 0 -> 1 | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/LAYERS/@BLEND`` | Layer blend mode | | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/LAYERS/@OUTL`` | Flag for wireframe | integer as boolean | ``0`` | |
| | view | | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/LAYERS/@LAYERS`` | Color outline of the | hexadecimal color | | |
| | layer’s frames | | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/CHARSTYLE/@DefaultStyle`` | Same as STYLE, but | string | | |
| | not documented | | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/Sections/Section/@FillChar`` | | Unicode code | ``0`` | |
| | | point of character | (NULL character) | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/Sections/Section/@FieldWidth`` | | | ``0`` | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/PAGEOBJECT/@path`` | Path data | `SVG path/@d string | | |
| | | <https://www.w3.org/TR/SVG/paths.html#TheDProperty>`_ | ``0`` | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
| ``/PAGEOBJECT/@copath`` | Path data | Same as @path | | |
+-----------------------------------+-----------------------+-------------------------------------------------------+------------------+----------+
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| XML | Explanation | Value | Default | Optional |
| element/attribute | | | | |
+===================================+=======================+====================+==================+==========+
| ``/@DPInCMYK`` | ICC profile for CMYK | string | | Yes |
| | images | | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/@DPIn3`` | ICC profile for CMYK | string | | Yes |
| | colors | | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/@PAGEC`` | Scribus GUI page | hexadecimal color | ``#ffffff`` | |
| | background | | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/LAYERS/@FLOW`` | | integer as boolean | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/LAYERS/@TRANS`` | Layer’s opacity | percentage | ``1`` | |
| | | 0 -> 1 | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/LAYERS/@BLEND`` | Layer blend mode | | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/LAYERS/@OUTL`` | Flag for wireframe | integer as boolean | ``0`` | |
| | view | | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/LAYERS/@LAYERS`` | Color outline of the | hexadecimal color | | |
| | layer’s frames | | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/CHARSTYLE/@DefaultStyle`` | Same as STYLE, but | string | | |
| | not documented | | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/CHARSTYLE/@wordTrack`` | Space width | Percentage | | |
| | | 0 -> 1 | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/CHARSTYLE/@KERN`` | Kerning | Percentage | | |
| | | 0 -> 100 | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/Sections/Section/@FillChar`` | | Unicode code | ``0`` | |
| | | point of character | (NULL character) | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/Sections/Section/@FieldWidth`` | | | ``0`` | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/PAGEOBJECT/@path`` | Path data | SVG path/@d string | ``0`` | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
| ``/PAGEOBJECT/@copath`` | Path data | Same as @path | | |
+-----------------------------------+-----------------------+--------------------+------------------+----------+
Notes
-----
``/PAGEOBJECT/@path`` and ``/PAGEOBJECT/@copath`` format specifications are
`available on W3C <https://www.w3.org/TR/SVG/paths.html#TheDProperty>`_.
Corrections
-----------
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment