Skip to content

Commit 7778b73

Browse files
authored
Delete Inky Email Templating Language documentation
The Inky framework has not been actively developed for about three years (last release in March 2022). In addition to Sass deprecations and other bugs, the project is generally no longer up to date when it comes to implementing email templates. In my opinion, it no longer makes sense to list the project as the only solution for designed emails.
1 parent 304c77a commit 7778b73

File tree

1 file changed

+0
-57
lines changed

1 file changed

+0
-57
lines changed

mailer.rst

Lines changed: 0 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1255,62 +1255,6 @@ the entire email contents from Markdown to HTML:
12551255
[Activate your account]({{ url('...') }})
12561256
{% endapply %}
12571257
1258-
.. _mailer-inky:
1259-
1260-
Inky Email Templating Language
1261-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1262-
1263-
Creating beautifully designed emails that work on every email client is so
1264-
complex that there are HTML/CSS frameworks dedicated to that. One of the most
1265-
popular frameworks is called `Inky`_. It defines a syntax based on some HTML-like
1266-
tags which are later transformed into the real HTML code sent to users:
1267-
1268-
.. code-block:: html
1269-
1270-
<!-- a simplified example of the Inky syntax -->
1271-
<container>
1272-
<row>
1273-
<columns>This is a column.</columns>
1274-
</row>
1275-
</container>
1276-
1277-
Twig provides integration with Inky via the ``InkyExtension``. First, install
1278-
the extension in your application:
1279-
1280-
.. code-block:: terminal
1281-
1282-
$ composer require twig/extra-bundle twig/inky-extra
1283-
1284-
The extension adds an ``inky_to_html`` filter, which can be used to convert
1285-
parts or the entire email contents from Inky to HTML:
1286-
1287-
.. code-block:: html+twig
1288-
1289-
{% apply inky_to_html %}
1290-
<container>
1291-
<row class="header">
1292-
<columns>
1293-
<spacer size="16"></spacer>
1294-
<h1 class="text-center">Welcome {{ email.toName }}!</h1>
1295-
</columns>
1296-
1297-
{# ... #}
1298-
</row>
1299-
</container>
1300-
{% endapply %}
1301-
1302-
You can combine all filters to create complex email messages:
1303-
1304-
.. code-block:: twig
1305-
1306-
{% apply inky_to_html|inline_css(source('@styles/foundation-emails.css')) %}
1307-
{# ... #}
1308-
{% endapply %}
1309-
1310-
This makes use of the :ref:`styles Twig namespace <mailer-css-namespace>` we created
1311-
earlier. You could, for example, `download the foundation-emails.css file`_
1312-
directly from GitHub and save it in ``assets/styles``.
1313-
13141258
.. _signing-and-encrypting-messages:
13151259

13161260
Signing and Encrypting Messages
@@ -2279,7 +2223,6 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
22792223
.. _`Google Gmail`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Google/README.md
22802224
.. _`high availability`: https://en.wikipedia.org/wiki/High_availability
22812225
.. _`Infobip`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Infobip/README.md
2282-
.. _`Inky`: https://get.foundation/emails/docs/inky.html
22832226
.. _`league/html-to-markdown`: https://github.com/thephpleague/html-to-markdown
22842227
.. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
22852228
.. _`MailerSend`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/MailerSend/README.md

0 commit comments

Comments
 (0)