Skip to content

crosslink Inline code chapters#509

Open
franzholz wants to merge 2 commits intoTYPO3-Documentation:mainfrom
franzholz:patch-5
Open

crosslink Inline code chapters#509
franzholz wants to merge 2 commits intoTYPO3-Documentation:mainfrom
franzholz:patch-5

Conversation

@franzholz
Copy link
Contributor

It is not evident starting from chapter "Inline code with or without overlays" that a more detailed chapter "Inline code" already exists.

It is not evident starting from chapter "Inline code with or without overlays" that a more detailed chapter "Inline code" already exists.
================================================

You can also use text roles with one of the predefined languages to display more
You can also use `text roles <https://docs.typo3.org/permalink/h2document:text-roles>`_ with one of the predefined languages to display more
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not too deep into it, but shouldn't it be a different link notation?
At least without the domain, and as it's a permalink perhaps a completely different internal notation should be used.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But I have copied this link directly from the destination page. If this is wrong, then you should contact someone from the Docs Team.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

that's a surprising proposition.

Copy link
Contributor

@DavidBruchmann DavidBruchmann Feb 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you can have a look at intersphinx_mapping.

When you search for "typo3 intersphinx_mapping" in google it's quite good explained. I don't know all the mappings but an example I found in eventnews: https://github.com/georgringer/eventnews/blob/main/Documentation/Settings.cfg#L25.

Here I still found more, so the cfg are older and xml is rather preferred:
https://github.com/TYPO3-Documentation/TYPO3CMS-Guide-HowToDocument/blob/main/Documentation/Reference/GuidesXml.rst

So you've to find which docs are mapped and how the keys are named.

this is the mapping file for this repository's documentation:
https://github.com/TYPO3-Documentation/TYPO3CMS-Guide-HowToDocument/blob/main/Documentation/guides.xml

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I get this: 2 "`" (added for code view) at both ends.

``Supported named inline text roles https://docs.typo3.org/permalink/h2document:text-roles_

Copy link
Contributor

@DavidBruchmann DavidBruchmann Feb 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can also use `text roles <https://docs.typo3.org/permalink/h2document:text-roles>`_ with one of the predefined languages to display more
You can also use :ref:`text roles <h2document:text-roles>`_ with one of the predefined languages to display more

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See my change. I have removed the [interlink]: part.

@DavidBruchmann
Copy link
Contributor

you could try how it's working by rendering it locally

@franzholz
Copy link
Contributor Author

Do you have a link with documentation about this?

@DavidBruchmann
Copy link
Contributor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants