【问题标题】:Github Jekyll how to make real page format same as previewGithub Jekyll 如何使真实页面格式与预览相同
【发布时间】:2018-06-24 02:29:40
【问题描述】:

我的 github jekyll 结构如下所示:

在我输入_posts 并创建.md 文件后,它看起来像:

对应的代码是:

 Generics were introduced to the Java language to provide tighter type checks at compile time and to support generic programming. 
 The generics looks like:    
 ```Java    
 List<String> list = new ArrayList<>();    
 //add item to list    
 String s = list.get(0);   
 ```    
 or    
 ```Java   
 public class Box<T> {
        // T stands for "Type"
        private T t;
        //other code    
 }    
 ```
 The most commonly used type parameter names are:    
 ```    
 E - Element (used extensively by the Java Collections Framework)    
 K - Key  

 ```

我们可以看到格式很好,比如有语法高亮。

我称之为预览页面

但是,当我通过输入我的 github 页面 url 进入我的页面时,它喜欢:

我称之为真实页面

我们可以看到真实页面看起来很糟糕,例如没有语法高亮,引用代码语法等有多个边框。

那么,如何使真实页面格式与预览页面相同?

【问题讨论】:

  • 你为什么使用图片?请包含我们可以测试的代码。
  • @antfuentes87 因为相同的代码具有不同的外观,所以我使用图像来显示差异。我添加了我的帖子源代码,请检查。
  • 感谢任何带有评论的反对票,以便我可以改进我的问题。只是投反对票会让人们感到困惑。
  • 投反对票是因为您的问题没有意义。但我认为如果你不知道为什么它没有意义,这不是你的错。看看我的问题。希望对您有所帮助。

标签: jekyll github-pages


【解决方案1】:

我想你对Jekyll 比较陌生,所以我必须对你做一些澄清。

你称之为“预览”的结果是你的 Markdown 被 GitHub 解析的结果。所有降价都有一些共同点,所以即使你的解析器不同,几乎所有的东西都会被类似地解析。您可以在“预览”的开头看到不同之处:yaml 内容显示为表格。

让我们回到杰基尔。如果您使用默认设置,则代码的解析器是 kramdown(您可以在 _config.yml 文件中更改它)。当您执行 Jekyll 时,它会构建您的网站。这意味着它会解析您的降价并将其转换为 HTML。它如何转换为 HTML 取决于您的配置和安装的插件。

默认情况下,您没有突出显示。如果您想更改它,请查看jekyll documentation。默认情况下,它使用Rogue,但您也可以使用Pigments 或您选择的其他荧光笔。

我认为这个答案不能涵盖您的所有疑问,当然也不能涵盖您的所有问题,但它是为了让您了解您的问题,正如它所发布的那样,因为您的“预览页面”和您的“真实页面”是两个完全不同的东西。所以谷歌一下,找到你想要实现的目标并提出一个新问题(你肯定会在不久的将来有一个问题)。

编码愉快!

【讨论】:

  • 感谢您的回复。您说得对,我对 Jekyll 比较陌生,您的帖子让我理解了我的问题。实际上我用“github jekyll page different format”之类的关键字搜索了很多,但没有找到结果。也许这是因为我不知道如何准确地用英语描述问题(所以我称它们为预览页面和真实页面)。所以预览页面是我的Github解析的markdown结果,而真实页面是我的kramdown解析的markdown结果,对吧?
  • @frank 是的。更准确地说,您的“真实页面”可能是不同解析器一个接一个(不仅是 kramdown)的结果。这取决于你的 jekill 项目中有哪些插件。
  • Jekyll 3 和 GitHub Pages 现在只支持 rouge 进行语法高亮,所以为了高亮代码,只需将代码放在 ```java 和 ``` 之间,代码来自@987654326 @。注意,应该是 ```java 而不是 ```Java,后者在 github jekyll 编辑器页面上也可以解析,但是输入网站 url 时无法解析。
  • @frank 我不知道 GitHub 页面,但根据Jekyll template documentation rouge 是 默认 荧光笔。您也可以使用其他荧光笔。
  • @frank 由于 Jekyll 使用的是液体,你可以用 {% highlight &lt;language&gt; %}{% endhighlight %} 标记要突出显示的内容。
猜你喜欢
  • 1970-01-01
  • 2020-10-11
  • 1970-01-01
  • 2013-06-26
  • 2017-11-12
  • 1970-01-01
  • 1970-01-01
  • 2021-08-11
  • 2014-07-19
相关资源
最近更新 更多