Commits (1)
......@@ -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
-----------
......
......@@ -112,8 +112,9 @@
<li class="toctree-l3"><a class="reference internal" href="#id3">Discussion</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#id4"># 3</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id5">Discussion</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id4"># 3</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id5"># 4</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id6">Discussion</a></li>
</ul>
</li>
</ul>
......@@ -187,11 +188,12 @@
<h1>SLA’s enhancement suggestions<a class="headerlink" href="#sla-s-enhancement-suggestions" title="Permalink to this headline"></a></h1>
<div class="section" id="id1">
<h2># 1<a class="headerlink" href="#id1" title="Permalink to this headline"></a></h2>
<p>The case used of element names and attributes should be clearly defined and homogeneous.</p>
<p>The case used of element names and attributes should be clearly defined and
homogeneous.</p>
<div class="section" id="discussion">
<h3>Discussion<a class="headerlink" href="#discussion" title="Permalink to this headline"></a></h3>
<p>Almost every text case is used for element’s names attributes. But XML/XSL tools
are case sensitive by default.</p>
<p>Almost every text case is used for element’s names attributes. But XML / XSL
tools are case sensitive by default.</p>
<p>Why <code class="docutils literal notranslate"><span class="pre">DOCUMENT/MASTERPAGE</span></code>, <code class="docutils literal notranslate"><span class="pre">DOCUMENT/PAGEOBJECT/LATEX/PROPERTY</span></code>,
<code class="docutils literal notranslate"><span class="pre">DOCUMENT/Sections/Section</span></code> ?</p>
</div>
......@@ -207,10 +209,15 @@ as they link to a configuration file and they no more render only LaTeX code.</p
</div>
<div class="section" id="id4">
<h2># 3<a class="headerlink" href="#id4" title="Permalink to this headline"></a></h2>
<p>Percentages in attributes should have the same format, instead of mixed
decimal (0 -&gt; 1) / integer (0 -&gt; 100) format.</p>
</div>
<div class="section" id="id5">
<h2># 4<a class="headerlink" href="#id5" title="Permalink to this headline"></a></h2>
<p>Attribute names should be in only one language, so the remaining german
attributes should be translated.</p>
<div class="section" id="id5">
<h3>Discussion<a class="headerlink" href="#id5" title="Permalink to this headline"></a></h3>
<div class="section" id="id6">
<h3>Discussion<a class="headerlink" href="#id6" title="Permalink to this headline"></a></h3>
<p><code class="docutils literal notranslate"><span class="pre">&lt;LAYERS</span> <span class="pre">NUMMER=&quot;0&quot;</span> <span class="pre">LEVEL=&quot;0&quot;</span> <span class="pre">NAME=&quot;Fond</span> <span class="pre">de</span> <span class="pre">page&quot;</span> <span class="pre">SICHTBAR=&quot;1&quot;</span> <span class="pre">DRUCKEN=&quot;1&quot;</span> <span class="pre">EDIT=&quot;1&quot;</span> <span class="pre">SELECT=&quot;0&quot;</span> <span class="pre">FLOW=&quot;1&quot;</span> <span class="pre">TRANS=&quot;1&quot;</span> <span class="pre">BLEND=&quot;0&quot;</span> <span class="pre">OUTL=&quot;0&quot;</span> <span class="pre">LAYERC=&quot;#000000&quot;/&gt;</span></code></p>
</div>
</div>
......
......@@ -103,6 +103,7 @@
</ul>
<ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">[EN] SLA document-able attributes</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#notes">Notes</a></li>
<li class="toctree-l2"><a class="reference internal" href="#corrections">Corrections</a></li>
<li class="toctree-l2"><a class="reference internal" href="#notable-things">Notable things</a></li>
</ul>
......@@ -178,11 +179,11 @@
<p>In all XPath location path listed here, we omit <code class="docutils literal notranslate"><span class="pre">/SCRIBUSUTF8NEW/DOCUMENT</span></code>.</p>
<table border="1" class="docutils">
<colgroup>
<col width="25%" />
<col width="16%" />
<col width="39%" />
<col width="13%" />
<col width="7%" />
<col width="33%" />
<col width="22%" />
<col width="19%" />
<col width="17%" />
<col width="9%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">XML
......@@ -255,6 +256,20 @@ not documented</td>
<td>&#160;</td>
<td>&#160;</td>
</tr>
<tr class="row-odd"><td><code class="docutils literal notranslate"><span class="pre">/CHARSTYLE/&#64;wordTrack</span></code></td>
<td>Space width</td>
<td>Percentage
0 -&gt; 1</td>
<td>&#160;</td>
<td>&#160;</td>
</tr>
<tr class="row-even"><td><code class="docutils literal notranslate"><span class="pre">/CHARSTYLE/&#64;KERN</span></code></td>
<td>Kerning</td>
<td>Percentage
0 -&gt; 100</td>
<td>&#160;</td>
<td>&#160;</td>
</tr>
<tr class="row-odd"><td><code class="docutils literal notranslate"><span class="pre">/Sections/Section/&#64;FillChar</span></code></td>
<td>&#160;</td>
<td>Unicode code
......@@ -271,7 +286,7 @@ point of character</td>
</tr>
<tr class="row-odd"><td><code class="docutils literal notranslate"><span class="pre">/PAGEOBJECT/&#64;path</span></code></td>
<td>Path data</td>
<td><a class="reference external" href="https://www.w3.org/TR/SVG/paths.html#TheDProperty">SVG path/&#64;d string</a></td>
<td>SVG path/&#64;d string</td>
<td><code class="docutils literal notranslate"><span class="pre">0</span></code></td>
<td>&#160;</td>
</tr>
......@@ -283,6 +298,11 @@ point of character</td>
</tr>
</tbody>
</table>
<div class="section" id="notes">
<h2>Notes<a class="headerlink" href="#notes" title="Permalink to this headline"></a></h2>
<p><code class="docutils literal notranslate"><span class="pre">/PAGEOBJECT/&#64;path</span></code> and <code class="docutils literal notranslate"><span class="pre">/PAGEOBJECT/&#64;copath</span></code> format specifications are
<a class="reference external" href="https://www.w3.org/TR/SVG/paths.html#TheDProperty">available on W3C</a>.</p>
</div>
<div class="section" id="corrections">
<h2>Corrections<a class="headerlink" href="#corrections" title="Permalink to this headline"></a></h2>
<p>For <code class="docutils literal notranslate"><span class="pre">Sections/Section/&#64;Type</span></code>, the possible values are incomplete in the wiki.</p>
......
This diff is collapsed.