Cleaner syntax

[kildom]

• Remove aliases, they are not very intuitive and can be replaces by: styles, groups, or templates
• Change syntax of Raw docx.js access to something like that:

<docx.js>
    <![CDATA[
    new docx.Paragraph({
        children: [
            new docx.TextRun("Hello World"),
            new docx.TextRun({
                text: "Foo Bar",
                bold: true,
            }),
            new docx.TextRun({
                text: "\tGithub is the best",
                bold: true,
            }),
            ]]>
                <img src="logo.png" />
            <![CDATA[
        ],
    })
    ]]>
</docx.js>

[kildom]

Or change aliases to macros that are more advanced, e.g.:

<MACRO:X>
    <p>
        <_CHILDREN_/>
    </p>
</MACRO:X>

<X>
    children
</X>


<MACRO:SECTION some="123">
    <h1 style="SectionHeader" _ATTRIBUTES_>
        * <_CHILDREN_/>
    </h1>
</MACRO:SECTION>

<SECTION>My first section</SECTION>

<p:SECTION>abc</p:SECTION>

<MACRO:P-BOLD>
    <p font-bold="1" _ATTRIBUTES_><_CHILDREN_/></p>
</MACRO:P-BOLD>

<P-BOLD>Bold paragraph</P-BOLD>

<table:SIMPLE>
</table:SIMPLE>

[kildom]

Different approach to macros:

<MACRO:MY_PARAGRAPH>
  <p style="my-paragraph" MACRO:ATTRIBUTES>
    <MACRO:CHILDREN/> <!-- if MACRO:CHILDREN tag has no children - put all children here -->
  </p>
</MACRO:MY_PARAGRAPH>

<MY_PARAGRAPH font.bold="1">Hello World!!!<MY_PARAGRAPH>

<MACRO:TABLE_FROM_P>
  <table MACRO:ATTRIBUTES>
    <MACRO:CHILDREN> <!-- if MACRO:CHILDREN tag has children - repeat it for each child -->
      <tr><td><MACRO:CHILD></td></tr> <!-- use MACRO:CHILD to put current child -->
    <MACRO:CHILDREN>
  </table>
</MACRO:X>

<TABLE_FROM_P width="10cm">
<p>First row</p>
<p>Second row</p>
</TABLE_FROM_P>

New ideas:

• Use MACRO: prefix inside macro for special tags
• Use <MACRO:CHILDREN> with child elements to create repeating fragments
• Don't use macro as a filter, e.g. <p:SECTION>

For future versions:

• Allow to filter attributes and children, e.g.
  • MACRO:ATTRIBUTES="p-.*" - match attributes that name starts with p-
  • <MACRO:CHILDREN filter="n-th-child(2 * n + 1)"> - filter only children with odd index