feat: Override link text for code blocks

docs/content/docs/guide/syntax-highlighting.md

@@ -58,6 +58,26 @@ go 1.20
 go 1.20
 ```
 
+### Overriding Link Text
+
+For links that do not contain the desired filename of the code snippet, you can use `name_override` to provide an overridden name for your link.
+
+````markdown {filename="name_override"}
+```c++ {base_url="https://godbolt.org/z/6Y7v7e19f", name_override="default godbolt"}
+// Type your code here, or load an example.
+int square(int num) {
+    return num * num;
+}
+```
+````
+
+```c++ {base_url="https://godbolt.org/z/6Y7v7e19f", name_override="default godbolt"}
+// Type your code here, or load an example.
+int square(int num) {
+    return num * num;
+}
+```
+
 ### Line Numbers
 
 To set line numbers, set attribute `linenos` to `table` and optionally set `linenostart` to the starting line number:

layouts/_markup/render-codeblock.html

@@ -1,11 +1,12 @@
 {{- $class := .Attributes.class | default "" -}}
 {{- $filename := .Attributes.filename | default "" -}}
 {{- $base_url := .Attributes.base_url | default "" -}}
+{{- $name_override := .Attributes.name_override | default "" -}}
 {{- $lang := .Attributes.lang | default .Type -}}
 
 
 <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code">
-  {{- partial "components/codeblock" (dict "filename" $filename "lang" $lang "base_url" $base_url "content" .Inner "options" .Options) -}}
+  {{- partial "components/codeblock" (dict "filename" $filename "lang" $lang "base_url" $base_url "name_override" $name_override "content" .Inner "options" .Options) -}}
 
   {{- if or (eq site.Params.highlight.copy.enable nil) (site.Params.highlight.copy.enable) -}}
     {{- partialCached "components/codeblock-copy-button" (dict "filename" $filename) $filename -}}

layouts/_partials/components/codeblock.html

@@ -1,10 +1,11 @@
 {{ $filename := .filename | default "" -}}
 {{ $base_url := .base_url | default "" -}}
+{{ $name_override := .name_override | default $filename -}}
 {{ $lang := .lang | default "" }}
 {{ $content := .content }}
 {{ $options := .options | default (dict) }}
 
-{{- if $filename -}}
+{{- if $name_override -}}
   <div class="hextra-code-filename not-prose" dir="auto">
     {{- if $base_url -}}
 
@@ -13,11 +14,11 @@
       {{- $file_url := urls.JoinPath $base_url $filename -}}
 
       <a class="hx:no-underline hx:inline-flex hx:items-center hx:gap-1" href="{{ $file_url }}" target="_blank" rel="noopener noreferrer">
-          <span>{{- $filename -}}</span>
+          <span>{{- $name_override -}}</span>
           {{- partial "utils/icon" (dict "name" "external-link" "attributes" "height=1em") -}}
       </a>
     {{- else -}}
-      {{- $filename -}}
+      {{- $name_override -}}
     {{- end -}}
   </div>
 {{- end -}}
@@ -26,4 +27,4 @@
   <div>{{- highlight $content $lang $options -}}</div>
 {{- else -}}
   <div><pre><code>{{ $content }}</code></pre></div>
-{{- end -}}
+{{- end -}}