Documentazione

Utilizzo di collegamenti nella documentazione

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Questo articolo descrive l’utilizzo dei collegamenti ipertestuali nelle pagine della documentazione. In Markdown è facile aggiungere collegamenti con poche diverse convenzioni. I collegamenti indicano agli utenti contenuti nella stessa pagina, conducono ad altre pagine o indirizzano a siti e URL esterni.

IMPORTANT
Tutti i collegamenti dovrebbero, idealmente, essere collegamenti protetti (https anziché http) ogni volta che viene supportato dal target (dovrebbe trattarsi della stragrande maggioranza dei casi).

Collegamento a URL

Le parole incluse nel testo del collegamento devono essere il titolo della pagina oggetto del collegamento oppure un testo specifico e descrittivo.

Esempi:

  • For more information, see the [overview article](https://github.com/AdobeDocs/target.en/help/overview.md).

  • For more details, see [Adobe Legal Concerns](https://www.adobe.com/legal).

Collegamento da un articolo a un altro

Per creare un collegamento in linea da un articolo a un altro articolo all’interno dello stesso archivio, utilizza la seguente sintassi di collegamento:

  • Un articolo in una directory effettua un collegamento a un altro articolo nella stessa directory:

    [link text](article-name.md)

  • Un articolo effettua un collegamento da una sottodirectory a un articolo nella directory principale:

    [link text](../article-name.md)

  • Un articolo effettua un collegamento da una sottodirectory a un articolo nella directory principale:

    [link text](../../article-name.md)

  • Un articolo nella directory principale effettua un collegamento a un articolo in una sottodirectory:

    [link text](./directory/article-name.md)

  • Un articolo in una sottodirectory effettua un collegamento a un articolo in un’altra sottodirectory:

    [link text](../directory/article-name.md)

  • Un articolo in una sottodirectory effettua un collegamento a un articolo in un’altra sottodirectory:

    [link text](../../directory/article-name.md)

Collegamento ad ancoraggi

Non è necessario creare ancoraggi. Vengono generati automaticamente in fase di pubblicazione per tutte le intestazioni H2. L’unica cosa da fare è creare collegamenti alle sezioni H2 (##).

  • Per effettuare un collegamento a un’intestazione all’interno dello stesso articolo:

    [link](#the-text-of-the-level2-section-separated-by-hyphens)

    [Link to anchors](#links-to-anchors)

  • Per effettuare un collegamento a un ancoraggio in un altro articolo nella stessa sottodirectory:

    [link text](article-name.md#anchor-name)

    [Configure your profile](overview.md#getting-started)

  • Per effettuare un collegamento a un ancoraggio in un’altra sottodirectory del servizio:

    [link text](../directory/article-name.md#anchor-name)

    [Configure your profile](../overview.md#configure-your-profile)

Collegamento a immagini

Come procedura ottimale, le immagini e i file vengono archiviati in una directory assets allo stesso livello del file Markdown che vi è collegato.

  • Un articolo effettua un collegamento a un’immagine nella assets sottodirectory:

    ![alt text](assets/image-name.png)

  • Un articolo effettua un collegamento a un’immagine nella assets/no-localize sottodirectory:

    ![alt text](assets/no-localize/image-name.png)

recommendation-more-help
f0a0e44c-5d56-45af-ac98-47677caca18f