显示Jekyll中的文件名，突出显示Pygments代码

Question

当在已知位置突出显示标准文件时，我希望将文件名放在代码块中；优选在顶部。一个假设的例子是

{% highlight apache show_filename=/etc/httpd/conf/httpd.conf %}
.... the file contents ....
{% endhighlight %}

然后将呈现带有前缀文件名的代码块。有办法做到这一点吗？

Answer 1

您可以简单地使用漂亮的html5figure标记。

"HTML元素表示自包含的内容，通常带有标题（figcaption），并且通常被称为单个单元。虽然它与主流有关，但它的位置与主流无关。通常，这是正文中引用的图像、插图、图表、代码片段或模式，但可以在不影响主流的情况下移动到另一页或附录"MDN>html>图形

<figure>
  <figcaption>File: folderName/fileName.rb</figcaption>
  {% highlight ruby %}
  def print_hi(name)
    puts "Hi, #{name}"
  end
  {% endhighlight %}
</figure>

Answer 2

另一个更好的解决方案，可以与kramdown一起使用：

>Some/test/xml/file.xml
{:.filename}
{% highlight xml %}
.... the file content ....
{% endhighlight %}

在.css文件中，您可以使用代码片段使其看起来很漂亮，例如：

.fileName{
  padding: 0px;
  margin: 0px;
  background-color: #292929;
  color: lightgrey;
  border-top-left-radius: 3px;
  border-top-right-radius: 3px;
  margin-bottom: 0px;
  padding-left: 1em;
  font-family: Menlo,Monaco,Consolas,"Courier New",monospace;
  border-left: 0px;    
}

在这里你可以找到更多关于这个kramdown功能的信息。