[FEATURE] Support emphasize-lines in code-block directive

linawolf · linawolf · commit 24237ead7060 · 2023-11-20T16:16:23.000+01:00
diff --git a/packages/guides-restructured-text/src/RestructuredText/Directives/CodeBlockDirective.php b/packages/guides-restructured-text/src/RestructuredText/Directives/CodeBlockDirective.php
@@ -58,6 +58,7 @@ public function process(
 
         $this->setStartingLineNumberBasedOnOptions($directive->getOptions(), $node);
         $this->setCaptionBasedOnOptions($directive->getOptions(), $node);
+        $this->setEmphasizeLinesBasedOnOptions($directive->getOptions(), $node);
         $this->codeNodeOptionMapper->apply($node, $directive->getOptions());
 
         if ($directive->getVariable() !== '') {
@@ -101,4 +102,15 @@ private function setCaptionBasedOnOptions(array $options, CodeNode $node): void
 
         $node->setCaption($caption);
     }
+
+    /** @param DirectiveOption[] $options */
+    private function setEmphasizeLinesBasedOnOptions(array $options, CodeNode $node): void
+    {
+        $emphasizeLines = null;
+        if (isset($options['emphasize-lines'])) {
+            $emphasizeLines = (string) $options['emphasize-lines']->getValue();
+        }
+
+        $node->setEmphasizeLines($emphasizeLines);
+    }
 }
diff --git a/packages/guides/resources/template/html/body/code.html.twig b/packages/guides/resources/template/html/body/code.html.twig
@@ -7,5 +7,7 @@
             <span class="caption-text">{{ node.caption }}</span>
         </div>
     {%- endif -%}
-    <pre{% if node.classes %} class="{{ node.classesString }}"{% endif %}><code class="language-{{ node.language }}{{ node.startingLineNumber ? ' line-numbers' }}" {%- if node.startingLineNumber %} data-start="{{ node.startingLineNumber }}"{% endif %}>{{ node.value }}</code></pre>
+    <pre{% if node.classes %} class="{{ node.classesString }}"{% endif %}><code class="language-{{ node.language }}{{ node.startingLineNumber ? ' line-numbers' }}"
+                {%- if node.startingLineNumber %} data-start="{{ node.startingLineNumber }}"{% endif -%}
+                {%- if node.emphasizeLines %} data-emphasize-lines="{{ node.emphasizeLines }}"{% endif -%}>{{ node.value }}</code></pre>
 {%- endif -%}
diff --git a/packages/guides/src/Nodes/CodeNode.php b/packages/guides/src/Nodes/CodeNode.php
@@ -22,6 +22,8 @@ class CodeNode extends TextNode
 
     private string|null $caption = null;
 
+    private string|null $emphasizeLines = null;
+
     /** @param string[] $lines */
     public function __construct(array $lines, protected string|null $language = null)
     {
@@ -57,4 +59,14 @@ public function setCaption(string|null $caption): void
     {
         $this->caption = $caption;
     }
+
+    public function getEmphasizeLines(): string|null
+    {
+        return $this->emphasizeLines;
+    }
+
+    public function setEmphasizeLines(string|null $emphasizeLines): void
+    {
+        $this->emphasizeLines = $emphasizeLines;
+    }
 }
diff --git a/tests/Integration/tests/code/code-block-emphasize/expected/index.html b/tests/Integration/tests/code/code-block-emphasize/expected/index.html
@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <title>Title</title>
+
+</head>
+<body>
+    <div class="section" id="title">
+    <h1>Title</h1>
+
+            <pre><code class="language-python" data-emphasize-lines="3,5">def some_function():
+    interesting = False
+    print(&#039;This line is highlighted.&#039;)
+    print(&#039;This one is not...&#039;)
+    print(&#039;...but this one is.&#039;)</code></pre>
+    </div>
+
+</body>
+</html>
diff --git a/tests/Integration/tests/code/code-block-emphasize/input/index.rst b/tests/Integration/tests/code/code-block-emphasize/input/index.rst
@@ -0,0 +1,11 @@
+Title
+=====
+
+..  code-block:: python
+    :emphasize-lines: 3,5
+
+    def some_function():
+        interesting = False
+        print('This line is highlighted.')
+        print('This one is not...')
+        print('...but this one is.')

Original file line number	Diff line number	Diff line change
`@@ -22,6 +22,8 @@ class CodeNode extends TextNode`
`22`	`22`
`23`	`23`	`private string\|null $caption = null;`
`24`	`24`
	`25`	`+ private string\|null $emphasizeLines = null;`
	`26`	`+`
`25`	`27`	`/** @param string[] $lines */`
`26`	`28`	`public function __construct(array $lines, protected string\|null $language = null)`
`27`	`29`	`{`
`@@ -57,4 +59,14 @@ public function setCaption(string\|null $caption): void`
`57`	`59`	`{`
`58`	`60`	`$this->caption = $caption;`
`59`	`61`	`}`
	`62`	`+`
	`63`	`+ public function getEmphasizeLines(): string\|null`
	`64`	`+ {`
	`65`	`+ return $this->emphasizeLines;`
	`66`	`+ }`
	`67`	`+`
	`68`	`+ public function setEmphasizeLines(string\|null $emphasizeLines): void`
	`69`	`+ {`
	`70`	`+ $this->emphasizeLines = $emphasizeLines;`
	`71`	`+ }`
`60`	`72`	`}`