Merge pull request #70 from TheDragonCode/1.x

Added `@mixed` directive to docs

Author: andrey-helldar

docs/snippets/advanced-directive-mixed.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Feeds\Items;
+
+use DragonCode\LaravelFeed\Feeds\Items\FeedItem;
+
+class UserFeedItem extends FeedItem
+{
+    protected ?string $name = 'users';
+
+    public function toArray(): array
+    {
+        return [
+            'foo' => 'bar',
+
+            'some' => [
+                '@mixed' => <<<XML
+                    <first>value</first>
+                    <second>value</second>
+                    XML,
+            ],
+        ];
+    }
+}

docs/snippets/advanced-directive-mixed.xml

@@ -0,0 +1,7 @@
+<user>
+    <foo>bar</foo>
+    <some>
+        <first>value</first>
+        <second>value</second>
+    </some>
+</user>

docs/topics/advanced-usage.topic

@@ -106,6 +106,22 @@
         </chapter>
     </chapter>
 
+    <chapter title="Directives" id="directives">
+        <chapter title="Mixed" id="mixed">
+            <p>
+                To insert XML fragments “as is”, use the <code>@mixed</code> directive:
+            </p>
+
+            <code-block lang="php" src="advanced-directive-mixed.php" include-lines="5-" />
+
+            <p>
+                Result:
+            </p>
+
+            <code-block lang="xml" src="advanced-directive-mixed.xml" />
+        </chapter>
+    </chapter>
+
     <chapter title="Location &amp; filename" id="location_and_filename">
         <p>
             By default, feeds will be stored in the <code>public</code> storage,