function HelpTopicTwigLoader::getSourceContext

File

core/modules/help/src/HelpTopicTwigLoader.php, line 70

Class

HelpTopicTwigLoader

Loads help topic Twig files from the filesystem.

Namespace

Code

public function getSourceContext(string $name) : Source {
  $path = $this->findTemplate($name);
  $contents = file_get_contents($path);
  try {
    // Note: always use \Drupal\Core\Serialization\Yaml here instead of the
    // "serializer.yaml" service. This allows the core serializer to utilize
    // core related functionality which isn't available as the standalone
    // component based serializer.
    $front_matter = new FrontMatter($contents, Yaml::class);
    // Reconstruct the content if there is front matter data detected. Prepend
    // the source with {% line \d+ %} to inform Twig that the source code
    // actually starts on a different line past the front matter data. This is
    // particularly useful when used in error reporting.
    if ($front_matter->getData() && ($line = $front_matter->getLine())) {
      $contents = "{% line {$line} %}" . $front_matter->getContent();
    }
  } catch (InvalidDataTypeException $e) {
    throw new LoaderError(sprintf('Malformed YAML in help topic "%s": %s.', $path, $e->getMessage()));
  }
  return new Source($contents, $name, $path);
}