docs/src/assets/images/sponsors/adaures.svg

+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 261 50">
+<style>
+    @media (prefers-color-scheme: dark) {
+        svg { background-color: white; }
+    }
+</style>
+<g clip-path="url(#a)"><path fill="#2A2D7C" d="M96.9 15.975v22.95h-6.1l-.675-1.625a10.875 10.875 0 0 1-6.925 2.5 11.699 11.699 0 0 1-12.05-12.3A11.65 11.65 0 0 1 83.2 15.35c2.554-.01 5.03.874 7 2.5l.825-1.775 5.875-.1Zm-7.5 11.5a5.15 5.15 0 1 0-10.275 0 5.15 5.15 0 1 0 10.275 0Zm36.725-19.75V38.95h-5.85l-.75-1.7a10.549 10.549 0 0 1-6.925 2.5 11.702 11.702 0 0 1-12.1-12.25 11.699 11.699 0 0 1 12.1-12.25c2.013-.018 3.99.537 5.7 1.6V7.725h7.825ZM118.8 27.5a5.152 5.152 0 0 0-5.137-5.509 5.151 5.151 0 0 0-5.138 5.509 5.152 5.152 0 0 0 5.138 5.509A5.15 5.15 0 0 0 118.8 27.5Zm45.925-11.525v22.95h-6.1L158 37.3a10.823 10.823 0 0 1-6.925 2.5A11.677 11.677 0 0 1 139 27.5a11.61 11.61 0 0 1 .763-4.706 11.612 11.612 0 0 1 6.564-6.633 11.626 11.626 0 0 1 4.698-.811 10.87 10.87 0 0 1 7 2.5l.825-1.775 5.875-.1Zm-7.5 11.5a5.152 5.152 0 0 0-5.137-5.509 5.151 5.151 0 0 0-5.138 5.509 5.152 5.152 0 0 0 5.138 5.509 5.15 5.15 0 0 0 5.137-5.509Zm12.2 1.625V16h7.9v12.75c0 2.5 1.3 3.85 3.425 3.85s3.375-1.45 3.375-3.85V16h7.9v13.1c0 6.425-4.5 10.6-11.275 10.6s-11.325-4.175-11.325-10.6Zm42.225-13.2v7.225h-3.075c-2.8 0-3.975 1.225-3.975 4.15V38.95h-7.9V16h5.3l1.225 2.5a7.675 7.675 0 0 1 6.325-2.65l2.1.05ZM238 27.275a14.703 14.703 0 0 1-.15 2.075H220.7a4.476 4.476 0 0 0 4.8 4 4.628 4.628 0 0 0 4.15-2.15h7.85a12.497 12.497 0 0 1-13.868 8.866A12.5 12.5 0 0 1 213 27.5a12.5 12.5 0 1 1 25-.2v-.025ZM220.85 25h9.275a4.6 4.6 0 0 0-4.625-3.55 4.425 4.425 0 0 0-4.65 3.55Zm29.5 14.7c-6.25 0-10-3.3-10-8.275h7.5a2.347 2.347 0 0 0 1.638 2.415 2.35 2.35 0 0 0 1.037.085c1.15 0 2.25-.575 2.25-1.775s-1.725-1.7-3.925-2.05c-3.6-.625-8.35-1.7-8.35-7.275 0-4.6 3.925-7.5 9.8-7.5 5.875 0 9.65 3.125 9.725 7.775h-7.5c0-1.475-.975-2.15-2.5-2.15s-2.125.625-2.125 1.675 1.75 1.625 3.925 2c3.625.65 8.45 1.4 8.45 7.225 0 4.8-4.05 7.925-10.15 7.925l.225-.075ZM.5 0v50h50V0H.5Zm33.35 31.65a9.6 9.6 0 0 1-6.275 9 9.75 9.75 0 0 1-3.325.6 9.6 9.6 0 0 1-3.325-18.6 2.5 2.5 0 0 1 3.3 1.525A2.5 2.5 0 0 1 22.7 27.5a4.454 4.454 0 0 0 3.1 8.35 4.4 4.4 0 0 0 2.9-4.175v-13.7a4.1 4.1 0 0 0-8.2 0 2.5 2.5 0 0 1-5 0 9.225 9.225 0 0 1 18.45 0l-.1 13.675Z"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h260v50H0z" transform="translate(.5)"/></clipPath></defs></svg>
\ No newline at end of file

docs/src/assets/images/sponsors/nlnet.svg

+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 134 50">
+<style>
+    @media (prefers-color-scheme: dark) {
+        svg { background-color: white; }
+    }
+</style>
+<g clip-path="url(#a)"><path fill="#98BF00" d="m132.92 21.99.74-4.06h-3.84l1.12-5.98-4.6 1.8-.74 4.18h-2.8l-.74 4.06h2.75l-.94 5.15c-.04.28-.12.7-.19 1.23s-.12 1.01-.12 1.41c.02 1.86.46 3.4 1.34 4.6.88 1.23 2.3 1.96 4.3 2.19l1.92-3.96a3.42 3.42 0 0 1-2.35-1.22 4.13 4.13 0 0 1-.82-2.65 16.1 16.1 0 0 1 .2-1.89l.9-4.86h3.87Zm-40.45-.46a5.76 5.76 0 0 1 1.86-.39c.57 0 1.05.16 1.43.5.37.3.55.76.55 1.4 0 .18-.03.45-.09.82l-.15.93L95 29.8l-.22 1.2c-.08.44-.1.81-.1 1.12 0 1.2.32 2.22.99 3.02.64.8 1.79 1.28 3.44 1.42l1.89-3.83c-.65-.1-1.1-.34-1.39-.71a2.3 2.3 0 0 1-.44-1.5c0-.15.01-.33.04-.52l.06-.48 1.08-5.12a14.13 14.13 0 0 0 .32-2.53c0-1.47-.43-2.66-1.3-3.54a4.96 4.96 0 0 0-3.66-1.32c-.9 0-1.76.15-2.61.45-.84.28-1.85.75-3.02 1.46a5.16 5.16 0 0 0-.84-2.01l-3.98 1.7c.33.51.6 1.06.77 1.64.22.82.28 1.67.17 2.5-.03.34-.08.61-.12.8l-2.37 12.6H88l2.5-13.6c.6-.44 1.27-.8 1.97-1.03Z"/><path fill="#98BF00" fill-rule="evenodd" d="M104.39 23.83a13.59 13.59 0 0 0-.17 7.93 7.33 7.33 0 0 0 1.46 2.62c.61.7 1.38 1.26 2.25 1.62.93.38 1.92.58 2.93.57 1.3 0 2.57-.24 3.85-.72a9.01 9.01 0 0 0 3.4-2.21l-1.61-3.72a7.77 7.77 0 0 1-2.47 1.89c-.85.41-1.77.63-2.71.64a3.14 3.14 0 0 1-2.45-.99c-.6-.69-.9-1.57-.88-2.48v-.28c0-.12.01-.24.04-.36 1.92-.26 3.83-.6 5.71-1.04 1.03-.25 2.03-.54 3.01-.84.96-.3 1.83-.6 2.56-.92v-1.7a6.92 6.92 0 0 0-1.86-5 5.62 5.62 0 0 0-2.07-1.35 6.73 6.73 0 0 0-2.53-.47c-1.32 0-2.56.3-3.67.88a8.47 8.47 0 0 0-2.89 2.4 11.46 11.46 0 0 0-1.9 3.53Zm6.44-3a3.2 3.2 0 0 1 1.56-.37c.79 0 1.44.25 1.96.77.53.5.8 1.26.8 2.3-.44.12-.95.29-1.54.45-.61.15-1.22.3-1.84.43l-1.86.39-1.58.27c.07-.63.2-1.22.42-1.77a4.68 4.68 0 0 1 2.08-2.47Z" clip-rule="evenodd"/><path fill="#000" fill-rule="evenodd" d="M120.29 41.8a2.69 2.69 0 0 0-.66-1.79 2.1 2.1 0 0 0-.72-.47 2.96 2.96 0 0 0-3.1.8 3.4 3.4 0 0 0-.94 2.34c0 .37.06.7.18 1.01.1.3.27.55.48.76.2.22.45.39.73.5.28.1.6.17.93.17a2.94 2.94 0 0 0 2.18-.95 3.5 3.5 0 0 0 .92-2.37Zm-4.14-.01c.1-.27.21-.51.36-.72.16-.2.36-.37.58-.5.23-.14.48-.2.75-.2.42 0 .74.14.96.4.22.26.34.63.34 1.09a2.81 2.81 0 0 1-.48 1.55c-.16.21-.36.39-.59.52-.22.12-.47.18-.74.18-.43 0-.75-.14-.97-.39-.24-.3-.36-.7-.34-1.09 0-.28.05-.56.14-.84Z" clip-rule="evenodd"/><path fill="#000" d="M129.33 39.45h-1.06l-.56 3.29a.73.73 0 0 0-.03.22v.25h-.05l-1.9-3.76h-1l-1 5.58h1.08l.6-3.36v-.45h.05l1.95 3.85.95-.09.97-5.53Zm-17.9 0h-1.1l-.99 5.58h1.1l.99-5.58Z"/><path fill="#000" fill-rule="evenodd" d="M97.9 39.45h-1.26l-.78 1.36c-.28.48-.55.99-.82 1.5a30.55 30.55 0 0 0-1.26 2.72h1.15c.04-.1.08-.24.14-.37.06-.14.12-.29.2-.42l.18-.4.16-.36h1.93l.03.42.05.43.04.4c.02.14.02.24.02.34l1.1-.09c0-.2-.02-.44-.04-.72-.02-.29-.06-.58-.1-.9l-.16-1c-.04-.34-.1-.68-.18-1.02l-.19-1-.2-.89Zm-.7 1.65.1.54.07.52.06.38h-1.39a13.97 13.97 0 0 0 .5-.97l.28-.5.23-.42h.06l.1.45Z" clip-rule="evenodd"/><path fill="#000" d="m106.44 40.46.16-1h-3.8l-.17 1H104l-.8 4.57h1.1l.8-4.57h1.35Z"/><path fill="#000" fill-rule="evenodd" d="M88.53 39.38a8.2 8.2 0 0 0-1.83.21l-.94 5.3a7.6 7.6 0 0 0 1.95.23c.86.02 1.7-.3 2.34-.88a3.18 3.18 0 0 0 .96-2.4c0-.4-.05-.74-.17-1.05a2.2 2.2 0 0 0-1.31-1.25c-.32-.1-.66-.16-1-.16Zm-.24 1c.22 0 .43.04.63.08.19.05.35.14.49.25.15.12.27.27.34.47.07.18.12.4.12.68 0 .36-.05.67-.15.96a1.72 1.72 0 0 1-1.04 1.14c-.27.1-.55.16-.83.15-.14 0-.27 0-.44-.02a9.12 9.12 0 0 1-.41-.04l.64-3.6.34-.05.31-.01Z" clip-rule="evenodd"/><path fill="#000" d="M55.3 18.63a5.8 5.8 0 0 1 .94 4.13c-.03.34-.08.61-.12.8l-2.37 12.6h4.29l2.5-13.6c.6-.44 1.27-.8 1.97-1.03a5.76 5.76 0 0 1 1.86-.39c.57 0 1.04.16 1.43.5.37.3.55.76.55 1.4 0 .18-.03.45-.1.82l-.14.93-1.07 5.02-.22 1.2c-.08.44-.1.81-.1 1.12 0 1.2.32 2.22.99 3.02.64.8 1.78 1.28 3.44 1.42l1.89-3.83c-.64-.1-1.1-.34-1.39-.71a2.3 2.3 0 0 1-.44-1.5c0-.15.01-.33.04-.52.01-.2.04-.36.06-.48l1.09-5.12c.09-.43.16-.86.22-1.3.06-.4.09-.82.09-1.23 0-1.47-.43-2.66-1.3-3.54a4.96 4.96 0 0 0-3.66-1.32c-.9 0-1.76.15-2.62.45-.83.28-1.84.75-3.01 1.46a5.16 5.16 0 0 0-.84-2.01l-3.99 1.7Zm27.09-9.24h-4.21l-3.22 17.4a16.74 16.74 0 0 0-.43 3.57c0 1.73.33 3.14 1 4.24.67 1.1 1.8 1.76 3.4 1.97l1.93-3.96c-.3-.14-.57-.3-.84-.5a2.14 2.14 0 0 1-.62-.63 2.41 2.41 0 0 1-.39-.9 6.6 6.6 0 0 1-.07-2.17l.13-.95L82.4 9.4Zm-9.05 30.06h-1.08l-.72 4.08a1.7 1.7 0 0 1-1.28.58.98.98 0 0 1-.62-.18c-.16-.14-.24-.34-.24-.66l.03-.26.03-.3.6-3.26h-1.1l-.58 3.25-.05.4-.01.34c0 .3.04.55.13.77a1.35 1.35 0 0 0 .9.82 2.36 2.36 0 0 0 2.12-.42c0 .08 0 .17.02.26v.22l1.1-.08c-.02-.07-.02-.14-.02-.23-.02-.08-.02-.17-.02-.27l.03-.57c.02-.2.03-.4.08-.58l.68-3.9Zm8.99 0h-1.06l-.56 3.29a.72.72 0 0 0-.03.22v.25h-.05l-1.9-3.76h-1l-1 5.58h1.08l.6-3.36v-.45h.05l1.95 3.85.95-.09.97-5.53Z"/><path fill="#000" fill-rule="evenodd" d="M63.93 40.02a2 2 0 0 0-.73-.48 2.97 2.97 0 0 0-3.11.79 3.38 3.38 0 0 0-.74 3.36c.1.3.26.55.47.76.2.22.45.39.73.5a2.94 2.94 0 0 0 3.11-.79 3 3 0 0 0 .67-1.03c.16-.4.25-.85.25-1.33 0-.37-.06-.71-.18-1.01a2.7 2.7 0 0 0-.47-.78Zm-3.13 1.05c.17-.2.36-.37.58-.5.23-.14.49-.2.75-.2.43 0 .74.14.97.4.22.26.34.63.34 1.09 0 .28-.05.57-.14.85a2 2 0 0 1-.93 1.22 1.6 1.6 0 0 1-.75.18c-.43 0-.74-.14-.97-.39-.24-.3-.36-.7-.34-1.09 0-.56.17-1.1.5-1.56Z" clip-rule="evenodd"/><path fill="#000" d="M56.03 39.45h-3.07l-1 5.58h1.1l.38-2.13h2l.19-1.01h-2.01l.25-1.43h1.98l.18-1.01Z"/><path fill="#98BF00" d="M37.82 13.36a11.5 11.5 0 0 0-2.44-8.78 11.5 11.5 0 0 0-7.92-4.5 11.5 11.5 0 0 0-8.78 2.45 11.35 11.35 0 0 0-4.38 7.19c-.04.25-.09.49-.12.74l-.06.73a11.7 11.7 0 0 0 2.5 8.05 11.28 11.28 0 0 0 7.2 4.38l.73.1.4.05c.32-1.3.84-2.54 1.54-3.67-.46.01-.94 0-1.42-.05l-.06-.01a7.89 7.89 0 0 1-5.46-3.1 7.89 7.89 0 0 1-1.66-6.02v-.06a7.88 7.88 0 0 1 3.08-5.4A7.9 7.9 0 0 1 27 3.8a7.8 7.8 0 0 1 5.44 3.08 7.96 7.96 0 0 1 1.68 6.05c-.07.5-.16.98-.3 1.44a12.3 12.3 0 0 1 3.93-.6l.06-.4Z"/><path fill="#98BF00" d="M39.38 15.32c-.25-.03-.49-.06-.74-.07-1.37-.09-2.68.04-3.93.39-1.5.43-2.9 1.15-4.12 2.12a11.43 11.43 0 0 0-4.37 7.19c1.3.22 2.49.6 3.58 1.15a7.9 7.9 0 0 1 3.08-5.4 7.91 7.91 0 0 1 6.05-1.7h.04a7.9 7.9 0 0 1 5.4 3.1 7.8 7.8 0 0 1 1.68 6.02 7.97 7.97 0 0 1-3.08 5.46 7.86 7.86 0 0 1-6 1.67c.26 1.2.33 2.47.24 3.78a11.5 11.5 0 0 0 8.03-2.52 11.5 11.5 0 0 0 4.5-7.93c.4-3.25-.42-6.19-2.44-8.77a11.41 11.41 0 0 0-7.19-4.38l-.73-.12Z"/><path fill="#000" d="M38.37 23.43a3.61 3.61 0 0 0-2.75.78 3.54 3.54 0 0 0-1.4 2.47 3.54 3.54 0 0 0 .76 2.75 3.54 3.54 0 0 0 2.48 1.4 3.52 3.52 0 0 0 2.74-.76 3.6 3.6 0 0 0 1.41-2.49 3.59 3.59 0 0 0-.77-2.74 3.62 3.62 0 0 0-2.47-1.4Z"/><path fill="#98BF00" d="M3.82 21.91a7.9 7.9 0 0 1 3.1-5.45 7.77 7.77 0 0 1 5.97-1.67 13.2 13.2 0 0 1-.24-3.78 11.4 11.4 0 0 0-8.03 2.51 11.46 11.46 0 0 0-4.49 7.93c-.4 3.26.4 6.17 2.44 8.78a11.33 11.33 0 0 0 7.19 4.37c.23.05.47.08.73.12.25.03.49.06.74.07 1.37.1 2.68-.04 3.92-.38a12.43 12.43 0 0 0 7.17-5.61c.65-1.15 1.1-2.4 1.33-3.7a13.3 13.3 0 0 1-3.58-1.15 7.9 7.9 0 0 1-3.08 5.4 7.91 7.91 0 0 1-6.05 1.68l-.04-.01a7.87 7.87 0 0 1-5.4-3.08 7.83 7.83 0 0 1-1.68-6.03Z"/><path fill="#000" d="M9.66 19.98a3.58 3.58 0 0 0-1.41 2.48 3.57 3.57 0 0 0 .77 2.72 3.57 3.57 0 0 0 2.47 1.43 3.73 3.73 0 0 0 2.3-6.95c-.43-.24-.9-.4-1.4-.44a3.5 3.5 0 0 0-2.73.76Zm19.3-10.35a3.57 3.57 0 0 0-2.49-1.4 3.5 3.5 0 0 0-2.73.76 3.52 3.52 0 0 0-1.42 2.48 3.53 3.53 0 0 0 .78 2.74 3.6 3.6 0 0 0 2.47 1.41 3.72 3.72 0 0 0 3.69-1.86c.24-.43.4-.9.45-1.38a3.64 3.64 0 0 0-.75-2.75Z"/><path fill="#98BF00" d="m25.31 26.32-.4-.05c-.31 1.3-.83 2.54-1.53 3.68.46-.03.94-.02 1.43.04a7.8 7.8 0 0 1 5.5 3.11 7.8 7.8 0 0 1 1.67 6.03v.05a7.88 7.88 0 0 1-3.08 5.4 7.9 7.9 0 0 1-6.04 1.67 7.9 7.9 0 0 1-5.45-3.08 7.84 7.84 0 0 1-1.68-6.04c.06-.5.17-.98.31-1.44-1.27.4-2.6.6-3.94.6l-.06.4c-.4 3.25.4 6.17 2.44 8.77a11.5 11.5 0 0 0 7.93 4.5c3.26.4 6.17-.42 8.78-2.45a11.42 11.42 0 0 0 4.37-7.2l.12-.72c.01-.26.04-.5.06-.73a11.8 11.8 0 0 0-.39-3.93 12 12 0 0 0-2.1-4.12 11.88 11.88 0 0 0-3.5-3.07 11.53 11.53 0 0 0-3.71-1.3c-.24-.05-.48-.1-.73-.12Z"/><path fill="#000" d="M26.79 35.84a3.61 3.61 0 0 0-2.49-1.42 3.56 3.56 0 0 0-2.74.78 3.61 3.61 0 0 0-1.41 2.47 3.56 3.56 0 0 0 .77 2.75 3.48 3.48 0 0 0 2.47 1.4 3.54 3.54 0 0 0 2.76-.76 3.66 3.66 0 0 0 1.4-2.49 3.66 3.66 0 0 0-.76-2.73Z"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h133.63v50H0z"/></clipPath></defs></svg>
\ No newline at end of file

docs/src/components/DocsVersionSelect.astro

+---
+import Select from '@astrojs/starlight/components/Select.astro';
+import type { Props } from '@astrojs/starlight/props';
+---
+
+<docs-version-select>
+    <Select
+		icon="starlight"
+		label="version"
+		value="main"
+		options={[
+			{ label: 'latest', selected: import.meta.env.BASE_URL === '/main', value: 'main' },
+			{ label: 'develop', selected: import.meta.env.BASE_URL === '/develop', value: 'develop' },
+			{ label: 'next', selected: import.meta.env.BASE_URL === '/next', value: 'next' },
+		]}
+		width="7em"
+	/>
+</docs-version-select>
+
+<script>
+	class DocsVersionSelect extends HTMLElement {
+		constructor() {
+			super();
+			const select = this.querySelector('select');
+			if (select) {
+				select.addEventListener('change', (e) => {
+					if (e.currentTarget instanceof HTMLSelectElement) {
+						window.location.pathname = e.currentTarget.value;
+					}
+				});
+			}
+		}
+	}
+	customElements.define('docs-version-select', DocsVersionSelect);
+</script>
\ No newline at end of file

docs/src/components/Header.astro

+---
+import config from 'virtual:starlight/user-config';
+import type { Props } from '@astrojs/starlight/props';
+
+import LanguageSelect from '@astrojs/starlight/components/LanguageSelect.astro';
+import Search from '@astrojs/starlight/components/Search.astro';
+import SiteTitle from '@astrojs/starlight/components/SiteTitle.astro';
+import SocialIcons from '@astrojs/starlight/components/SocialIcons.astro';
+import ThemeSelect from '@astrojs/starlight/components/ThemeSelect.astro';
+import VersionSelect from './DocsVersionSelect.astro';
+
+
+/**
+ * Render the `Search` component if Pagefind is enabled or the default search component has been overridden.
+ */
+ const shouldRenderSearch =
+	config.pagefind || config.components.Search !== '@astrojs/starlight/components/Search.astro';
+---
+
+<div class="header sl-flex">
+	<div class="title-wrapper sl-flex">
+		<SiteTitle {...Astro.props} />
+	</div>
+	<div class="sl-flex">
+		{shouldRenderSearch && <Search {...Astro.props} />}
+	</div>
+	<div class="sl-hidden md:sl-flex right-group">
+		<div class="sl-flex social-icons">
+			<SocialIcons {...Astro.props} />
+		</div>
+		<ThemeSelect {...Astro.props} />
+		<VersionSelect {...Astro.props} />
+		<LanguageSelect {...Astro.props} />
+	</div>
+</div>
+
+<style>
+	.header {
+		gap: var(--sl-nav-gap);
+		justify-content: space-between;
+		align-items: center;
+		height: 100%;
+	}
+
+	.title-wrapper {
+		/* Prevent long titles overflowing and covering the search and menu buttons on narrow viewports. */
+		overflow: hidden;
+	}
+
+	.right-group,
+	.social-icons {
+		gap: 1rem;
+		align-items: center;
+	}
+	.social-icons::after {
+		content: '';
+		height: 2rem;
+		border-inline-end: 1px solid var(--sl-color-gray-5);
+	}
+
+	@media (min-width: 50rem) {
+		:global(:root[data-has-sidebar]) {
+			--__sidebar-pad: calc(2 * var(--sl-nav-pad-x));
+		}
+		:global(:root:not([data-has-toc])) {
+			--__toc-width: 0rem;
+		}
+		.header {
+			--__sidebar-width: max(0rem, var(--sl-content-inline-start, 0rem) - var(--sl-nav-pad-x));
+			--__main-column-fr: calc(
+				(
+						100% + var(--__sidebar-pad, 0rem) - var(--__toc-width, var(--sl-sidebar-width)) -
+							(2 * var(--__toc-width, var(--sl-nav-pad-x))) - var(--sl-content-inline-start, 0rem) -
+							var(--sl-content-width)
+					) / 2
+			);
+			display: grid;
+			grid-template-columns:
+        /* 1 (site title): runs up until the main content column’s left edge or the width of the title, whichever is the largest  */
+				minmax(
+					calc(var(--__sidebar-width) + max(0rem, var(--__main-column-fr) - var(--sl-nav-gap))),
+					auto
+				)
+				/* 2 (search box): all free space that is available. */
+				1fr
+				/* 3 (right items): use the space that these need. */
+				auto;
+			align-content: center;
+		}
+	}
+</style>
\ No newline at end of file

docs/src/components/MobileMenuFooter.astro

+---
+import LanguageSelect from '@astrojs/starlight/components/LanguageSelect.astro';
+import SocialIcons from '@astrojs/starlight/components/SocialIcons.astro';
+import ThemeSelect from '@astrojs/starlight/components/ThemeSelect.astro';
+import type { Props } from '@astrojs/starlight/props';
+import VersionSelect from './DocsVersionSelect.astro';
+---
+
+<div class="mobile-preferences sl-flex">
+	<div class="sl-flex social-icons">
+		<SocialIcons {...Astro.props} />
+	</div>
+	<ThemeSelect {...Astro.props} />
+    <VersionSelect {...Astro.props} />
+	<LanguageSelect {...Astro.props} />
+</div>
+
+<style>
+	.social-icons {
+		margin-inline-end: auto;
+		gap: 1rem;
+		align-items: center;
+		padding-block: 1rem;
+	}
+	.social-icons:empty {
+		display: none;
+	}
+	.mobile-preferences {
+		justify-content: space-between;
+		flex-wrap: wrap;
+		border-top: 1px solid var(--sl-color-gray-6);
+		column-gap: 1rem;
+		padding: 0.5rem 0;
+	}
+</style>
\ No newline at end of file

docs/src/content.config.ts

+import { defineCollection } from "astro:content";
+import { docsLoader, i18nLoader } from "@astrojs/starlight/loaders";
+import { docsSchema, i18nSchema } from "@astrojs/starlight/schema";
+
+export const collections = {
+  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+  i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }),
+};

docs/src/content/docs/ar/getting-started/auth.mdx

+---
+title: Autenticação & Autorização
+---
+
+Castopod lida com autenticação e autorização usando `codeigniter/shield`
+juntamente com regras personalizadas. Papéis e permissões são definidos em dois
+níveis:
+
+1. [toda instância](#1-instance-wide-roles-and-permissions)
+2. [por podcast](#2-per-podcast-roles-and-permissions)
+
+## 2. Por funções de podcast e permissões
+
+### Instance roles
+
+{/* AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section */}
+
+| role        | description                         | permissions                                                                                            |
+| ----------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Super admin | Has complete control over Castopod. | admin.\*, plugins.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
+| Manager     | Manages Castopod's content.         | podcasts.create, podcasts.import, persons.manage, pages.manage                                         |
+| Podcaster   | General users of Castopod.          | admin.access                                                                                           |
+
+{/* AUTH-INSTANCE-ROLES-LIST:END */}
+
+### Instance permissions
+
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section */}
+
+| permission              | description                                                        |
+| ----------------------- | ------------------------------------------------------------------ |
+| admin.access            | Can access the Castopod admin area.                                |
+| admin.settings          | Can access the Castopod settings.                                  |
+| plugins.manage          | Auth.instance_permissions.plugins.manage                           |
+| users.manage            | Can manage Castopod users.                                         |
+| persons.manage          | Can manage persons.                                                |
+| pages.manage            | Can manage pages.                                                  |
+| podcasts.view           | Can view all podcasts.                                             |
+| podcasts.create         | Can create new podcasts.                                           |
+| podcasts.import         | Can import podcasts.                                               |
+| fediverse.manage-blocks | Can block fediverse actors/domains from interacting with Castopod. |
+
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:END */}
+
+## 2. Per podcast roles and permissions
+
+### Por cargos de podcast
+
+{/* AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section */}
+
+| role   | description                                                 | permissions                                                                                                                                                                                                                                                                                 |
+| ------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Admin  | Has complete control of podcast #\{id\}.                    | \*                                                                                                                                                                                                                                                                                          |
+| Editor | Manages content and publications of podcast #\{id\}.        | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, manage-notifications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments |
+| Author | Manages content of podcast #\{id\} but cannot publish them. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                         |
+| Guest  | General contributor of the podcast #\{id\}.                 | view, episodes.view                                                                                                                                                                                                                                                                         |
+
+{/* AUTH-PODCAST-ROLES-LIST:END */}
+
+### Por permissões de podcast
+
+{/* AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section */}
+
+| permission                   | description                                                                |
+| ---------------------------- | -------------------------------------------------------------------------- |
+| view                         | Can view dashboard and analytics of podcast #\{id\}.                       |
+| edit                         | Can edit podcast #\{id\}.                                                  |
+| delete                       | Can delete podcast #\{id\}.                                                |
+| manage-import                | Can synchronize imported podcast #\{id\}.                                  |
+| manage-persons               | Can manage subscriptions of podcast #\{id\}.                               |
+| manage-subscriptions         | Can manage subscriptions of podcast #\{id\}.                               |
+| manage-contributors          | Can manage contributors of podcast #\{id\}.                                |
+| manage-platforms             | Can set/remove platform links of podcast #\{id\}.                          |
+| manage-publications          | Can publish podcast #\{id\}.                                               |
+| manage-notifications         | Can view and mark notifications as read for podcast #\{id\}.               |
+| interact-as                  | Can interact as the podcast #\{id\} to favourite, share or reply to posts. |
+| episodes.view                | Can view dashboards and analytics of podcast #\{id\}'s episodes.           |
+| episodes.create              | Can create episodes for podcast #\{id\}.                                   |
+| episodes.edit                | Can edit episodes of podcast #\{id\}.                                      |
+| episodes.delete              | Can delete episodes of podcast #\{id\}.                                    |
+| episodes.manage-persons      | Can manage episode persons of podcast #\{id\}.                             |
+| episodes.manage-clips        | Can manage video clips or soundbites of podcast #\{id\}.                   |
+| episodes.manage-publications | Can publish/unpublish episodes and posts of podcast #\{id\}.               |
+| episodes.manage-comments     | Can create/remove episode comments of podcast #\{id\}.                     |
+
+{/* AUTH-PODCAST-PERMISSIONS-LIST:END */}

docs/src/content/docs/ar/getting-started/docker.mdx

+---
+title: Official Docker images
+---
+
+Castopod pushes 3 Docker images to the Docker Hub during its automated build
+process:
+
+- [**`castopod/castopod`**](https://hub.docker.com/r/castopod/castopod): an all
+  in one castopod image using nginx unit
+- [**`castopod/app`**](https://hub.docker.com/r/castopod/app): the app bundle
+  with all of Castopod dependencies
+- [**`castopod/web-server`**](https://hub.docker.com/r/castopod/web-server): an
+  Nginx configuration for Castopod
+
+Additionally, Castopod requires a MySQL-compatible database. A Redis database
+can be added as a cache handler.
+
+## Supported tags
+
+- `develop` [unstable], latest development branch build
+- `beta` [stable], latest beta version build
+- `latest` [stable], latest version build
+- `1.x.x` [stable], specific version build (since `1.0.0`)
+
+## Example usage
+
+1. Install [docker](https://docs.docker.com/get-docker/) and
+   [docker-compose](https://docs.docker.com/compose/install/)
+
+2. Create a `docker-compose.yml` file with the following:
+
+   ```yml
+   version: "3.7"
+
+   services:
+     app:
+       image: castopod/castopod:latest
+       container_name: "castopod-app"
+       volumes:
+         - castopod-media:/var/www/castopod/public/media
+       environment:
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+         CP_BASEURL: "https://castopod.example.com"
+         CP_ANALYTICS_SALT: changeme
+         CP_CACHE_HANDLER: redis
+         CP_REDIS_HOST: redis
+         CP_REDIS_PASSWORD: changeme
+       networks:
+         - castopod-app
+         - castopod-db
+       ports:
+         - 8000:8000
+       restart: unless-stopped
+
+     mariadb:
+       image: mariadb:10.5
+       container_name: "castopod-mariadb"
+       networks:
+         - castopod-db
+       volumes:
+         - castopod-db:/var/lib/mysql
+       environment:
+         MYSQL_ROOT_PASSWORD: changeme
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+       restart: unless-stopped
+
+     redis:
+       image: redis:7.0-alpine
+       container_name: "castopod-redis"
+       command: --requirepass changeme
+       volumes:
+         - castopod-cache:/data
+       networks:
+         - castopod-app
+
+   volumes:
+     castopod-media:
+     castopod-db:
+     castopod-cache:
+
+   networks:
+     castopod-app:
+     castopod-db:
+   ```
+
+   You have to adapt some variables to your needs (e.g. `CP_BASEURL`,
+   `MYSQL_ROOT_PASSWORD`, `MYSQL_PASSWORD` and `CP_ANALYTICS_SALT`).
+
+3. Setup a reverse proxy for TLS (SSL/HTTPS)
+
+   TLS is mandatory for ActivityPub to work. This job can easily be handled by a
+   reverse proxy, for example with [Caddy](https://caddyserver.com/):
+
+   ```
+   #castopod
+   castopod.example.com {
+       reverse_proxy localhost:8000
+   }
+   ```
+
+4. Run `docker-compose up -d`, wait for it to initialize and head on to
+   `https://castopod.example.com/cp-install` to finish setting up Castopod!
+
+5. You're all set, start podcasting! 🎙️🚀
+
+## Environment Variables
+
+- **castopod/castopod** and **castopod/app**
+
+  | Variable name                         | Type (`default`)        | Default          |
+  | ------------------------------------- | ----------------------- | ---------------- |
+  | **`CP_BASEURL`**                      | string                  | `undefined`      |
+  | **`CP_MEDIA_BASEURL`**                | ?string                 | `CP_BASEURL`     |
+  | **`CP_ADMIN_GATEWAY`**                | ?string                 | `"cp-admin"`     |
+  | **`CP_AUTH_GATEWAY`**                 | ?string                 | `"cp-auth"`      |
+  | **`CP_ANALYTICS_SALT`**               | string                  | `undefined`      |
+  | **`CP_DATABASE_HOSTNAME`**            | ?string                 | `"mariadb"`      |
+  | **`CP_DATABASE_NAME`**                | ?string                 | `MYSQL_DATABASE` |
+  | **`CP_DATABASE_USERNAME`**            | ?string                 | `MYSQL_USER`     |
+  | **`CP_DATABASE_PASSWORD`**            | ?string                 | `MYSQL_PASSWORD` |
+  | **`CP_DATABASE_PREFIX`**              | ?string                 | `"cp_"`          |
+  | **`CP_CACHE_HANDLER`**                | [`"file"` or `"redis"`] | `"file"`         |
+  | **`CP_REDIS_HOST`**                   | ?string                 | `"localhost"`    |
+  | **`CP_REDIS_PASSWORD`**               | ?string                 | `null`           |
+  | **`CP_REDIS_PORT`**                   | ?number                 | `6379`           |
+  | **`CP_REDIS_DATABASE`**               | ?number                 | `0`              |
+  | **`CP_EMAIL_SMTP_HOST`**              | ?string                 | `undefined`      |
+  | **`CP_EMAIL_FROM`**                   | ?string                 | `undefined`      |
+  | **`CP_EMAIL_SMTP_USERNAME`**          | ?string                 | `"localhost"`    |
+  | **`CP_EMAIL_SMTP_PASSWORD`**          | ?string                 | `null`           |
+  | **`CP_EMAIL_SMTP_PORT`**              | ?number                 | `25`             |
+  | **`CP_EMAIL_SMTP_CRYPTO`**            | [`"tls"` or `"ssl"`]    | `"tls"`          |
+  | **`CP_ENABLE_2FA`**                   | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_FILE_MANAGER`**           | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_ENDPOINT`**            | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_KEY`**                 | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_SECRET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_REGION`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_BUCKET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_PROTOCOL`**            | ?number                 | `undefined`      |
+  | **`CP_MEDIA_S3_PATH_STYLE_ENDPOINT`** | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_S3_KEY_PREFIX`**          | ?string                 | `undefined`      |
+  | **`CP_DISABLE_HTTPS`**                | ?[`0` or `1`]           | `undefined`      |
+  | **`CP_MAX_BODY_SIZE`**                | ?number (with suffix)   | `512M`           |
+  | **`CP_PHP_MEMORY_LIMIT`**             | ?number (with suffix)   | `512M`           |
+  | **`CP_TIMEOUT`**                      | ?number                 | `900`            |
+
+- **castopod/web-server**
+
+  | Variable name          | Type                  | Default |
+  | ---------------------- | --------------------- | ------- |
+  | **`CP_APP_HOSTNAME`**  | ?string               | `"app"` |
+  | **`CP_MAX_BODY_SIZE`** | ?number (with suffix) | `512M`  |
+  | **`CP_TIMEOUT`**       | ?number               | `900`   |

docs/src/content/docs/ar/getting-started/install.mdx

+---
+title: How to install Castopod?
+---
+
+import { Aside } from "@astrojs/starlight/components";
+
+Castopod was thought-out to be easy to install. Whether using dedicated or
+shared hosting, you can install it on most PHP-MySQL compatible web servers.
+
+## Requirements
+
+- PHP v8.4 or higher
+- MySQL version 8.4 or higher or MariaDB version 11.4 or higher
+- HTTPS support
+- An [ntp-synced clock](https://wiki.debian.org/NTP) to validate federation's
+  incoming requests
+
+### PHP v8.4 or higher
+
+PHP version 8.4 or higher is required, with the following extensions installed:
+
+- [intl](https://php.net/manual/en/intl.requirements.php)
+- [libcurl](https://php.net/manual/en/curl.requirements.php)
+- [mbstring](https://php.net/manual/en/mbstring.installation.php)
+- [gd](https://www.php.net/manual/en/image.installation.php) with **JPEG**,
+  **PNG** and **WEBP** libraries.
+- [exif](https://www.php.net/manual/en/exif.installation.php)
+
+Additionally, make sure that the following extensions are enabled in your PHP:
+
+- json (enabled by default - don't turn it off)
+- xml (enabled by default - don't turn it off)
+- [mysqlnd](https://php.net/manual/en/mysqlnd.install.php)
+
+### MySQL compatible database
+
+> We recommend using [MariaDB](https://mariadb.org).
+
+You will need the server hostname, database name, username and password to
+complete the installation process. If you do not have these, please contact your
+server administrator.
+
+#### Privileges
+
+User must have at least these privileges on the database for Castopod to work:
+`CREATE`, `ALTER`, `DELETE`, `EXECUTE`, `INDEX`, `INSERT`, `SELECT`, `UPDATE`,
+`REFERENCES`, `CREATE VIEW`.
+
+### (Optional) FFmpeg v4.1.8 or higher for Video Clips
+
+[FFmpeg](https://www.ffmpeg.org/) version 4.1.8 or higher is required if you
+want to generate Video Clips. The following extensions must be installed:
+
+- **FreeType 2** library for
+  [gd](https://www.php.net/manual/en/image.installation.php).
+
+### (Optional) Other recommendations
+
+- Redis for better cache performances.
+- CDN for static files caching and better performances.
+- e-mail gateway for lost passwords.
+
+## Install instructions
+
+### Pre-requisites
+
+0. Get a Web Server with [requirements](#requirements) installed
+1. Create a MySQL database for Castopod with a user having access and
+   modification privileges (for more info, see
+   [MySQL compatible database](#mysql-compatible-database)).
+2. Activate HTTPS on your domain with an _SSL certificate_.
+3. Download and unzip the latest [Castopod Package](https://castopod.org/) onto
+   the web server if you haven’t already.
+   - ⚠️ Set the web server document root to the `public/` sub-folder within the
+     `castopod` folder.
+4. Add **cron tasks** on your web server for various background processes
+   (replace the paths accordingly):
+
+   ```bash
+      * * * * * /path/to/php /path/to/castopod/spark tasks:run >> /dev/null 2>&1
+   ```
+
+   **Note** - If you do not add this cron task, the following Castopod features
+   will not work:
+
+   - Importing a podcast from an existing RSS feed
+   - Broadcasting social activities to your followers in the fediverse
+   - Broadcasting episodes to open hubs using
+     [WebSub](https://en.wikipedia.org/wiki/WebSub)
+   - Generating video clips -
+     [requires FFmpeg](#optional-ffmpeg-v418-or-higher-for-video-clips)
+
+### (recommended) Install Wizard
+
+1. Run the Castopod install script by going to the install wizard page
+   (`https://your_domain_name.com/cp-install`) in your favorite web browser.
+2. Follow the instructions on your screen.
+3. Začať podcastovať!
+
+<Aside>
+
+The install script writes a `.env` file in the package root. If you cannot go
+through the install wizard, you can create and edit the `.env` file manually
+based on the `.env.example` file.
+
+</Aside>
+
+### Using CLI
+
+1. Create a `.env` file in the package root based on the `.env.example` file.
+
+2. Initialize the database using:
+
+   ```sh
+   php spark install:init-database
+   ```
+
+3. Create the superadmin user using:
+
+   ```sh
+   php spark install:create-superadmin
+   ```
+
+4. Head on to your admin gateway to start podcasting!
+
+### Email/SMTP setup
+
+Email configuration is required for some features to work properly (eg.
+retrieving your forgotten password, sending instructions to premium subscribers,
+…)
+
+You may add your email configuration in your instance's `.env` like so:
+
+```ini
+# […]
+
+email.fromEmail="your_email_address"
+email.SMTPHost="your_smtp_host"
+email.SMTPUser="your_smtp_user"
+email.SMTPPass="your_smtp_password"
+```
+
+#### Email config options
+
+| Variable name    | Type                 | Default      |
+| ---------------- | -------------------- | ------------ |
+| **`fromEmail`**  | string               | `undefined`  |
+| **`fromName`**   | string               | `"Castopod"` |
+| **`SMTPHost`**   | string               | `undefined`  |
+| **`SMTPUser`**   | string               | `undefined`  |
+| **`SMTPPass`**   | string               | `undefined`  |
+| **`SMTPPort`**   | number               | `25`         |
+| **`SMTPCrypto`** | [`"tls"` or `"ssl"`] | `"tls"`      |
+
+### Media storage
+
+By default, files are saved to the `public/media` folder using the file system.
+If you need to relocate the `media` folder to a different location, you can
+specify it in your `.env` file as shown below:
+
+```ini
+# […]
+
+media.root="media"
+media.storage="/mnt/storage"
+```
+
+In this example, the files will be saved to the /mnt/storage/media folder. Make
+sure to also update your web server configuration to reflect this change.
+
+### S3
+
+If you prefer storing your media files on an S3 compatible storage, you may
+specify it in your `.env`:
+
+```ini
+# […]
+
+media.fileManager="s3"
+media.s3.endpoint="your_s3_host"
+media.s3.key="your_s3_key"
+media.s3.secret="your_s3_secret"
+media.s3.region="your_s3_region"
+```
+
+#### S3 config options
+
+| Variable name           | Type    | Default     |
+| ----------------------- | ------- | ----------- |
+| **`endpoint`**          | string  | `undefined` |
+| **`key`**               | string  | `undefined` |
+| **`secret`**            | string  | `undefined` |
+| **`region`**            | string  | `undefined` |
+| **`bucket`**            | string  | `castopod`  |
+| **`protocol`**          | number  | `undefined` |
+| **`pathStyleEndpoint`** | boolean | `false`     |
+| **`keyPrefix`**         | string  | `undefined` |
+
+## Community packages
+
+If you don't want to bother with installing Castopod manually, you may use one
+of the packages created and maintained by the open-source community.
+
+### Install with YunoHost
+
+[YunoHost](https://yunohost.org/) is a distribution based on Debian GNU/Linux
+made up of free and open-source software packages. It manages the hardships of
+self-hosting for you.
+
+<div class="flex flex-wrap items-center gap-4">
+
+<a
+  href="https://install-app.yunohost.org/?app=castopod"
+  target="_blank"
+  rel="noopener noreferrer"
+>
+  <img
+    src="https://install-app.yunohost.org/install-with-yunohost.svg"
+    alt="Install Castopod with YunoHost"
+    class="align-middle"
+  />
+</a>
+
+<a
+  href="https://github.com/YunoHost-Apps/castopod_ynh"
+  target="_blank"
+  rel="noopener noreferrer"
+  class="inline-flex items-center px-4 py-[.3rem] mx-auto font-semibold text-center text-black rounded-md gap-x-1 border-2 border-solid border-[#333] hover:no-underline hover:bg-gray-100"
+>
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 24 24"
+    width="1em"
+    height="1em"
+    class="text-xl"
+  >
+    <path fill="none" d="M0 0h24v24H0z" />
+    <path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 6.84 9.49c.5.09.69-.21.69-.48l-.02-1.86c-2.51.46-3.16-.61-3.36-1.18-.11-.28-.6-1.17-1.02-1.4-.35-.2-.85-.66-.02-.67.79-.01 1.35.72 1.54 1.02.9 1.52 2.34 1.1 2.91.83a2.1 2.1 0 0 1 .64-1.34c-2.22-.25-4.55-1.11-4.55-4.94A3.9 3.9 0 0 1 6.68 8.8a3.6 3.6 0 0 1 .1-2.65s.83-.27 2.75 1.02a9.28 9.28 0 0 1 2.5-.34c.85 0 1.7.12 2.5.34 1.9-1.3 2.75-1.02 2.75-1.02.54 1.37.2 2.4.1 2.65.63.7 1.02 1.58 1.02 2.68 0 3.84-2.34 4.7-4.56 4.94.36.31.67.91.67 1.85l-.01 2.75c0 .26.19.58.69.48A10.02 10.02 0 0 0 22 12 10 10 0 0 0 12 2z" />
+  </svg>
+  Github Repo
+</a>
+
+</div>

docs/src/content/docs/ar/getting-started/security.mdx

+---
+title: Security concerns
+---
+
+Castopod is built on top of [CodeIgniter4](https://codeigniter.com/), a PHP
+framework that encourages
+[good security practices](https://codeigniter.com/user_guide/concepts/security.html).
+
+To maximize your instance's safety and prevent any malicious attack, we
+recommend you update all your Castopod files permissions after installation or
+updates (to avoid any prior permission error):
+
+- `writable/` folder must be **readable** and **writable**.
+- `public/media/` folder must be **readable** and **writable**.
+- any other file must be set to **readonly**.
+
+For instance, if you are using Apache or NGINX with Ubuntu you may do the
+following:
+
+```bash
+sudo chown -R root:root /path/to/castopod
+sudo chown -R www-data:www-data /path/to/castopod/writable
+sudo chown -R www-data:www-data /path/to/castopod/public/media
+```