.. include:: /Includes.rst.txt .. _InterlinkRepositories: ===================== Interlink Inventories ===================== Sections in other manuals than the current one can be linked during rendering by prefixing an anchor link or page link with the name of the manual. Interlinks to official manuals ============================== By using suffixes the version of the manual to be linked can be specified: .. code-block:: rst * :ref:`TYPO3 Explained, preferred version ` * :ref:`TYPO3 Explained, main version (development) ` * :ref:`TYPO3 Explained, stable version (for example 12.4) ` * :ref:`TYPO3 Explained, old stable version (for example 11.5) ` * :ref:`TYPO3 Explained 12 LTS ` * :ref:`TYPO3 Explained 12.4 ` This would output: * :ref:`TYPO3 Explained, preferred version ` * :ref:`TYPO3 Explained, main version (development) ` * :ref:`TYPO3 Explained, stable version (for example 12.4) ` * :ref:`TYPO3 Explained, old stable version (for example 11.5) ` * :ref:`TYPO3 Explained 12 LTS ` * :ref:`TYPO3 Explained 12.4 ` .. _typo3-version: Setting the preferred TYPO3 version ----------------------------------- The preferred version can be set in the guides.xml to `dev`, `stable`, `oldstable` or a specific minor version, for example `8.7` or `v8`. .. code-block:: xml :caption: Documentation/guides.xml or .. code-block:: xml :caption: Documentation/guides.xml, excerpt The following link: .. code-block:: rst * :ref:`TYPO3 Explained, always version 8.7 ` * :ref:`TYPO3 Explained, always version 8.7 ` Adding a new TYPO3 version or manual ------------------------------------ In the event of a change in long-term support, adjustments to the corresponding TYPO3 versions can be made directly in the theme within the enum :php:`\T3Docs\Typo3DocsTheme\Inventory\Typo3VersionMapping`. The default manuals to be supported can be managed in enum :php:`\T3Docs\Typo3DocsTheme\Inventory\DefaultInventories`. Interlinks to system extensions =============================== You can link to the manual of a system extension: Use the extension's Composer name as interlink domain: .. code-block:: rst * :doc:`Adminpanel ` * :ref:`RTE ` This will be rendered as: * :doc:`Adminpanel ` * :ref:`RTE ` By default they will link to :ref:`your preferred TYPO3 version `. You can link to another version by using the same prefixes as for official manuals: .. code-block:: rst * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` This will be rendered as: * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` * :ref:`RTE ` For your convenience the changelog, situated in system extension `typo3/cms-core` can also be linked with the prefix `changelog`: .. code-block:: rst * :ref:`Changelog: Remove jquery-ui ` This will be rendered as: * :ref:`Changelog: Remove jquery-ui ` Interlinks to third-party extensions ==================================== You can link to the manual of a third-party extension if that extension's manual has been rendered on https://docs.typo3.org. To create an interlink to a third-party extension, use the extension's Composer name as interlink domain: .. code-block:: rst * :doc:`News ` * :ref:`External Imports ` This will be rendered as: * :doc:`News ` * :ref:`External Imports ` By default this will link to the main version of the manual. If you desire to link a specific version, you can attach the minor version (for example "11.3") separated by a slash: .. code-block:: rst * :doc:`News ` * :doc:`External Imports ` * :doc:`News ` * :doc:`External Imports ` If an extension author needs to link to a specific version of an extension's manual, they can define that version manually in the manual's :file:`guides.xml`: .. code-block:: xml :caption: Documentation/guides.xml .. code-block:: rst * :doc:`News ` * :doc:`External Imports ` This will be rendered as: * :doc:`News ` * :doc:`External Imports `