¿Cuál es la mejor práctica para escribir un enlace a la pantalla a través de t ()?

En Drupal 7, se podría hacer la siguiente línea:

t('Visit !mylink', ['!mylink' => l('my website', 'http://example.com')]);

Pero eso ya no funciona en Drupal 8 o 9 😞. Hasta ahora, he probado esto:

Primero creo un enlace, estilo Drupal 8:

$mylink = Link::fromTextAndUrl('my website', Url::fromUri('http://example.com'));

Luego intente crear una cadena que pueda imprimirse. He intentado toString():

t('Visit @mylink', ['@mylink' => $mylink->toString()]);

Sin embargo, se supone que no debemos hacer esto. Los documentos de la API dicen:

No utilice este método para representar un enlace en un contexto HTML. En un contexto HTML, debe usarse self :: toRenderable () para que se mantenga la información de la caché de procesamiento.

Entonces trato de usar toRenderable():

t('Visit @mylink', ['@mylink' => render($mylink->toRenderable()]);

Pero a PHP 7.2 no le gusta. La llamada a t()produce el siguiente Aviso:

Aviso: Solo las variables deben pasarse por referencia ...

Bastante justo, pero ¿cómo se hace esto?

No pude encontrar cómo hacer esto descrito en ninguno de los documentos obvios, como:

• https://www.drupal.org/docs/security-in-drupal/sanitizing-output
• https://www.drupal.org/docs/security-in-drupal/writing-secure-code-for-drupal

Entonces mi pregunta es:
¿Cuál es la mejor práctica para escribir un enlace a la pantalla en Drupal 8?

(Entorno: Ubuntu 20.04 LTS, Drupal 8.8.6 (core + devel), código de procedimiento, por ejemplo hook_help()).

Para un enlace incluido en texto traducible, el núcleo de Drupal sugiere usar t()e incrustar la etiqueta de anclaje HTML directamente en la cadena traducida. En LinkGeneratorInterface::generate(), el código de ejemplo para este caso es el siguiente.

$text = t('Visit the <a href=":url">content types</a> page', array(
  ':url' => Url::fromRoute('entity.node_type.collection')->toString(),
));

Al buscar : url en el código central de Drupal se encuentra un código como el siguiente.

BlockContentController::add()

if (count($types) === 0) {
  return [
    '#markup' => $this
      ->t('You have not created any block types yet. Go to the <a href=":url">block type creation page</a> to add a new block type.', [
      ':url' => Url::fromRoute('block_content.type_add')->toString(),
    ]),
  ];
}

ListingEmpty::render()

  $element = [
    '#markup' => $this->t('Add a <a href=":url">custom block</a>.', [ ':url' => Url::fromRoute('block_content.add_page')->toString(), ]), '#access' => $access_result->isAllowed(),
    '#cache' => [
      'contexts' => $access_result->getCacheContexts(), 'tags' => $access_result->getCacheTags(),
      'max-age' => $access_result->getCacheMaxAge(),
    ],
  ];

Alternativamente, el núcleo de Drupal usa el siguiente código.

block_help()

$themes = \Drupal::service('theme_handler')->listInfo();
$output = '<p>' . t('Block placement is specific to each theme on your site. Changes will not be saved until you click <em>Save blocks</em> at the bottom of the page.') . '</p>'; $output .= '<p>' . Link::fromTextAndUrl(t('Demonstrate block regions (@theme)', [
  '@theme' => $themes[$demo_theme]->info['name'],
]), Url::fromRoute('block.admin_demo', ['theme' => $demo_theme]))->toString() . '</p>';

template_preprocess_forums()

    if ($variables['tid'] != $topic->forum_tid) { $variables['topics'][$id]->moved = TRUE; $variables['topics'][$id]->title = $topic->getTitle();
      $variables['topics'][$id]->message = Link::fromTextAndUrl(t('This topic has been moved'), Url::fromRoute('forum.page', ['taxonomy_term' => $topic->forum_tid]))->toString();
    }

Será fácil si convierte el enlace a la URL y usa traducir como este.

$url = Url::fromUri('http://example.com')->toString(); t('Visit <a href=":href">link</a>', array(':href' => $url));

Ejemplo de traducción de uso de núcleo de drupal con enlace.

$requirements['online'] = array( 'title' => t('Internet'), 'value' => t('The translation server is offline.'), 'severity' => REQUIREMENT_ERROR, 'description' => t('The installer requires to contact the translation server to download a translation file. Check your internet connection and verify that your website can reach the translation server at <a href=":server_url">@server_url</a>.', array( ':server_url' => $server_url,
        '@server_url' => $server_url,
      )),
    );