Add the possibility to have a title on code block

```hint:title
Lorem ipsum
``

Author: jcamiel

sites/build.sh

@@ -24,14 +24,12 @@ echo_step 'Second pass static build'
 # Second pass to take the rebuilt search index into account.
 jekyll build --source hurl.dev --destination hurl.dev/_site --future
 
-echo_step 'Highlight code snippets'
-# Second pass to take the rebuilt search index into account.
-# Highlight Hurl snippet.
-python3 highlight.py
-
 echo_step 'Replace home samples'
 python3 build_home_samples.py
 
+echo_step 'Highlight code snippets'
+python3 highlight.py
+
 echo_step 'Add title anchors'
 python3 build_anchors.py
 

sites/build_home_samples.py

@@ -2,8 +2,6 @@
 import re
 from pathlib import Path
 
-import highlight
-
 
 class Sample:
     name: str
@@ -12,15 +10,15 @@ class Sample:
 
     def __init__(self, name: str, src: str):
         self.name = name
-        src_padding = src
+        src_padded = src
         # Count number of line in src, add padding if necessary
-        nl = src_padding.count("\n")
+        nl = src_padded.count("\n")
         max_line = 14
         if nl < max_line:
-            src_padding += "\n" * (max_line - nl)
-        self.src = src_padding
+            src_padded += "\n" * (max_line - nl)
+        self.src = src_padded
         html = '<pre><code class="language-hurl">'
-        html += highlight.hurl_to_html(src_padding)
+        html += src_padded
         html += "</code></pre>\n"
         self.html = html
 
@@ -375,9 +373,9 @@ def make_home_samples():
     select_html = ""
     select_html += '<div class="home-picker">\n'
     select_html += (
-        '<label class="home-picker-label" for="samples">Choose example</label>\n'
+        '<label class="home-picker-label" for="home-samples">Choose example</label>\n'
     )
-    select_html += '<select id="home-samples" names="samples"">\n'
+    select_html += '<select id="home-samples" name="samples">\n'
     for idx, sample in enumerate(samples):
         if idx == feature_sample:
             select = " selected"
@@ -386,7 +384,7 @@ def make_home_samples():
         select_html += (
             f'    <option value="home-sample-{idx}"{select}>{sample.name}</option>\n'
         )
-    select_html += "/<select>\n"
+    select_html += "</select>\n"
     select_html += "</div>\n"
     select_html += '<div class="home-sample">\n'
     select_html += samples[feature_sample].html

sites/highlight.py

@@ -2,6 +2,7 @@
 import subprocess
 from subprocess import CalledProcessError
 import re
+from dataclasses import dataclass
 from pathlib import Path
 from typing import List, Callable
 import platform
@@ -17,6 +18,15 @@ def main():
     highlight_code(language="rust", to_html_func=rust_to_html)
 
 
+@dataclass
+class Snippet:
+    """Represents a code snippet."""
+
+    content: str
+    title: str | None
+    language: str
+
+
 def get_os() -> str:
     """Return linux, macos or windows."""
     if platform.system() == "Linux":
@@ -42,18 +52,17 @@ def highlight_code(language: str, to_html_func: Callable[[str], str]) -> None:
         print(f"    Highlighting {filename}")
         dst = src
         for snippet in snippets:
-            unescaped_snippet = unescape_html(snippet)
-            colored_snippet = to_html_func(unescaped_snippet.strip())
-            dst = dst.replace(
-                f'<pre><code class="language-{language}">{snippet}</code></pre>',
-                f'<pre><code class="language-{language}">{colored_snippet}</code></pre>',
-            )
-
-            # Patch for <https://github.com/Orange-OpenSource/hurl/issues/4117> to delete with 7.0.0
-            dst = dst.replace(
-                '<span class="line"><span class="multiline">variable {',
-                '<span class="line"><span class="multiline">variables {',
-            )
+            title = snippet.title
+            content = snippet.content
+            unescaped_content = unescape_html(content)
+            colored_content = to_html_func(unescaped_content)
+            if title:
+                old = f'<pre><code class="language-{language}:{title}">{content}</code></pre>'
+                new = f'<div class="code-block"><div class="code-title">{title}</div>\n<pre><code class="language-{language}">{colored_content}</code></pre></div>'
+            else:
+                old = f'<pre><code class="language-{language}">{content}</code></pre>'
+                new = f'<div class="code-block"><pre><code class="language-{language}">{colored_content}</code></pre></div>'
+            dst = dst.replace(old, new)
         Path(filename).write_text(dst)
 
 
@@ -91,6 +100,7 @@ def hurl_to_html(snippet: str) -> str:
 
     # PATCH: https://github.com/Orange-OpenSource/hurl/issues/3242
     output = output.replace("cert.pem\\", "cert.pem")
+    # To be uniform with other snippets, we're removing the <pre><code> tag
     return extract(output, '<pre><code class="language-hurl">', "</code></pre>")
 
 
@@ -164,24 +174,29 @@ def shell_to_html(snippet: str) -> str:
     return output
 
 
-def extract_snippet(language: str, text: str) -> List[str]:
-    prefix = f'<pre><code class="language-{language}">'
+def extract_snippet(language: str, text: str) -> List[Snippet]:
+    prefix = re.compile(f'<pre><code class="language\\-{language}(?P<title>:.*)?">')
     suffix = "</code></pre>"
     index = 0
 
-    snippets: List[str] = []
+    snippets: List[Snippet] = []
     while True:
-        begin = text.find(prefix, index)
-        if begin == -1:
+        match = prefix.search(text, index)
+        if not match:
             break
-        end = text.find(suffix, begin)
+        prefix_end = match.end(0)
+        title = match.group("title")
+        if title:
+            title = title[1:]
+        end = text.find(suffix, prefix_end)
         index = end
-        snippet = text[begin + len(prefix) : end]
+        content = text[prefix_end:end]
+        snippet = Snippet(content=content, title=title, language=language)
         snippets.append(snippet)
     return snippets
 
 
-def extract(text, prefix, suffix):
+def extract(text: str, prefix: str, suffix: str) -> str | None:
     reg = re.compile(f"""{prefix}(.+?){suffix}""", re.DOTALL)
     match = reg.search(text)
     if match: