Add a way to edit fluid files

[cognifloyd]

I want to make editing/creating TYPO3.Fluid files scriptable in a semantic fashion. I do not want line based editing. It's got to be able to insert elements (html, fluid, etc) at particular positions without mangling the syntax/semantics and spacing of the file.

This is my design for the "script" on the backend:

• The script will be a DSL (TYPO3.Eel and FlowQuery strings stored in YAML files).
• The TYPO3.Eel objects will map to
  • querypath/QueryPath functions (see also http://querypath.org)
  • lambda/callback functions won't be accessible from within Eel.
  • additional Fluid creation/editing functions
  • additional functions to find/load/select files (possibly a selection of files from a boilerplate package like zurb foundation or html5bp+bootstrap)
• I will use a version of QueryPath that uses masterminds/html5 (QueryPath 3.x includes this)
  • I expect most fluid templates to produce html5 documents, so an html4 or xhtml parser is not enough.
  • html5 parser support: technosophos/querypath#114
  • Since Fluid uses xml-like namespacing (even using xmlns on body tags in some templates), I will need namespace support, which is not technically part of the html5 spec. For this, I need:
  • Implicit Namespace support: Masterminds/html5-php#43, Masterminds/html5-php#44
  • Explicit namespaces support drafted in my fork cognifloyd/html5-php:
    • cognifloyd/html5-php@9287135e7133e7f78a7831e495e8ece750cc89d1, cognifloyd/html5-php@a06d501f242282107da5b751478a9dc4d31a5682
    • Explicit Namespaces shouldn't get added to the nsRoot or nsStack in the DOMTreeBuilder because the elements can occur anywhere and aren't dependent on being in any particular contextual root element (like svg, or mathml)
    • I could probably use AOP to inject the Fluid namespaces (retrieved from fluid files by using the Fluid parser as a kind of Pre-processor) but, that means html5-php has to already have support for explicit namespaces (esp in DomTreeBuilder->startTag()), and it needs a way to register additional namespaces from outside the DomTreeBuilder.
  • Note that mastermind/html5 already recognizes tags with ":" in them

Once I've got this down, then I'll extend my app to edit other filetypes, including php, typoscript, stylesheets (css, sass, less, etc), javascript, yaml, and whatever else people might want to edit. All they have to do is add a library that understands the semantics of the filetype and provides a fluent interface (or at least uses method chaining) for searching/editing the file in a jquery-like manner. It'll use the same DSL (FlowQuery in Eel in YAML). Hopefully, I'll be able to jump from editing one kind of document to editing another, as different documenttypes are embedded in each other (eg SVG, MathML, CSS, and JavaScript are all easily embedded in HTML)

[cognifloyd]

I'd like to make my approach generic enough (repeatable) so that I can reuse as much as possible and allow editing Twig and Twital templates as well. Twital uses namespaced attributes on regular html tags. Twig uses something like Fluid's inline syntax with curly braces.

I wonder how I'm going to detect and edit the curly brace syntax in Fluid, Twig and Twital?

[cognifloyd]

If masterminds/html5 doesn't include some kind of explicit namespace support we can (as suggested by @goetas) post-process the DOMDocument to add the namespaces like Twital does.

[cognifloyd]

https://github.com/cognifloyd/Cognifire.BuilderFoundation/issues/18#issuecomment-21960059

This is the original issue where I decided to use QueryPath.