... | ... | @@ -36,16 +36,18 @@ XSweet produces a variety of HTML typescript in its "snapshot" of a Word .docx ( |
|
|
|
|
|
Also, other XSweet components are designed to provide various services in processing HTML Typescript, enabling it to be tweaked, tuned, and improved in ways custom-fit to particular documents and content types. For example the HTMLTweak module provides for simple logic-based renaming of `class` and `style` assignments supporting global cleanup/enhancement of HTML Typescript documents.
|
|
|
|
|
|
### Syntactic requirements (these preserve interoperability with the XML transformation/query stack)
|
|
|
### Syntactic requirements
|
|
|
|
|
|
These preserve interoperability with the XML (XSLT) transformation/query stack in which XSweet is implemented.
|
|
|
|
|
|
* XML syntax w/ no tag minimization. Everything in XHTML namespace; otherwise avoid namespace complications
|
|
|
* Implicitly (X)HTML5 w/ no XML declaration and no DOCTYPE declaration (thus serializable using XML serializers)
|
|
|
|
|
|
### Validation
|
|
|
|
|
|
Ideally any HTML Typescript document will be valid to the HTML5 Rec and all relevant specs. However we can't practically require all tools to be valid all the time to anything, so formal validation to an external model is not in scope for HTML Typescript - even the HTML model.
|
|
|
Ideally any HTML Typescript document will be valid to the HTML5 Rec and/or any or all relevant specs. However we can't practically require all tools to be valid all the time to anything, so formal validation to an external model is not in scope for HTML Typescript. (Not only is the Code More in the Way of Guidelines -- this is more a case of you know it by how it looks and tastes.)
|
|
|
|
|
|
This is because validation is so important and sensitive, it requires a toolkit of its own, with no interference here!
|
|
|
This is because validation is so important and sensitive, it requires a toolkit of its own, with no interference when it comes to just sloshing data around before it's really ready.
|
|
|
|
|
|
### High-level structure / scaffolding
|
|
|
|
... | ... | @@ -55,7 +57,7 @@ xsweet-footnotes and xsweet-endnotes sections |
|
|
|
|
|
### "Paragraph level", @class and @style
|
|
|
|
|
|
Overloading class.
|
|
|
Overloading @class.
|
|
|
|
|
|
### Inline markup
|
|
|
|
... | ... | |