Github Jekyll如何使真实页面格式与预览相同

时间:2018-06-24 02:29:40

标签: jekyll github-pages

我的github jekyll结构如下所示:

enter image description here

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

enter image description here

相应的代码是:

 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进入页面以查看时,它就像:

enter image description here

我称其为真实页面

我们可以看到真实页面看起来很糟糕,例如没有语法突出显示,引号代码语法等有多个边界。

因此,真实页面的格式与预览页面相同吗?

1 个答案:

答案 0 :(得分:1)

我想您是Jekyll的新手,所以我必须给您一些澄清。

您称为“预览”的结果是GitHub解析markdown的结果。所有的降价促销都有一个共同点,因此很有可能即使解析器不同,几乎所有东西都被类似地解析。您可能会在“预览”开始时看到不同之处:yaml内容显示为表格。

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

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

我认为此答案不会涵盖您的所有疑问,当然也不能涵盖您的所有问题,而是让您了解,自您的“预览页面”和“真实页面”是两个完全不同的东西。因此,请在Google上找到一点,找到您想要实现的目标并提出一个新问题(不久的将来您肯定会遇到一个问题)。

编码愉快!