Confused about Images nested within a Text element

[cgaaf]

Within the GridExamples page, I'm confused as to why the Image element is nested within a Text element. Could this be explained or elaborated further within the documentation?

https://github.com/twostraws/IgniteSamples/blob/1004b1326a99ec7190d458462cb38c8f124b2383/Sources/Pages/Concepts/GridExamples.swift#L30

[twostraws]

Happy to! I've been working on this alone for quite some time, so I was mentally flip-flopping between two competing ideas:

• "Ignite should permit only valid HTML to be written."
• "Ignite should make it easy to write websites."

I changed my mind on this a lot during development, and I suspect the result is somewhat inconsistent. In this precise case, images are technically inline elements rather than block elements, but I suspect the real answer here is "no one cares" 🙂 I might switch them over to being a PageElement, which would allow them to be placed anywhere.

[cgaaf]

Thanks for explaining the image nesting! While I understand the desire to support valid HTML, I think the early stages of this project would benefit most from prioritizing ease of use, especially for Swift developers who may be less familiar with HTML's nuances.

Focusing on making website creation intuitive for Swift programmers would reduce the mental context switching required. Have you considered a solution that would allow images to be embedded with a more natural Swift syntax, while still ultimately generating valid inline HTML elements?

I've never contributed to an open source project before so I'm hopeful to contribute a solution but I've not found success yet.

I had explored something that looks a bit like this but haven't had a successful implementation yet:

extension Image {
    enum ElementType {
        case inline
        case page
    }

    init(_ name: String? = nil, description: String? = nil, type: ElementType = .inline) { ... }
}

[twostraws]

Yes, I agree with you; I'll correct this now.