calligra:fill-style-name and friends

[Jos van den Oever]

On Wednesday 16 May 2012 10:42:38 AM Jos van den Oever wrote:
> Hi all,
> 
> Calligra uses quite some attributes that are not part of the ODF
> specification but unique to Calligra. These are prefixed with the
> 'calligra:' prefix which points to the http://www.calligra.org/2005/
> namespace.
> 
> Currently the build server flags these attributes as errors. Here is list
> of the attributes encountered by the build server:
> 
>   calligra:fill-style-name
>   calligra:nodeTypes
>   calligra:vertical-distributed
>   calligra:specialborder-top
>   calligra:specialborder-bottom
>   calligra:specialborder-right
>   calligra:specialborder-left
>   calligra:number-length
> 
> Could the people that know about these attributes (or others that read in
> the code about them), mail some documentation on these attributes as well
> as where they may occur on ODF documents? A motivation about why they are
> needed is welcome too.

The use of non-odf or foreign elements in Calligra can be discussed more 
generically.

Calligra should discuss whether it save documents as OpenDocument document or 
as OpenDocument Extended document. An OpenDocument Extended document may 
contain foreign elements and attributes, whereas an OpenDocument document may 
not. OpenDocument document and OpenDocument Extended document are defined in 
section 2.2.1 and 2.2.2 of the OpenDocument Format 1.2 part 1 standard. 

According to the specification, an ODF consumer *shall* be able to parse and 
interpret OpenDocument documents and *should* be able to parse and interpret 
conforming OpenDocument extended documents.

If the Calligra community chooses to write OpenDocument Extended documents, 
the current situation is fine. If the Calligra community, chooses to write 
OpenDocument documents, the foreign calligra:* attributes are not fine. 
However there is a workaround: currently the calligra:* attributes are used on 
draw:path and on styles. Both these elements have identfiers by which they can 
be referenced and annotated with RDF. We could choose to write additional 
information as RDF instead of foreign elements. By doing so we can claim to 
write OpenDocument documents instead of OpenDocument Extended documents.

I think that for now, we can stay with writing OpenDocument Extended 
documents. This mail is mainly to bring you awareness of the difference 
between OpenDocument documents and OpenDocument Extended documents that is 
written in the 854 pages of the ODF 1.2 part 1 specifcation.

Cheers,
Jos