忽略带有Jekyll的标记文件中的一行

有没有办法忽略来自Jekyll引擎的标记文档中的文本行

在主README.md上，我有一个指向生成页面url的链接，

将[文档作为网站查看](https://gitpages.mycompany.com/myrepo/)

链接到我们的企业版github.io页面，由Jekyll读取/docs/文件夹提供支持

出于明显的原因，我不想在pages站点上显示这一点，因为查看器已经在那里了，如果用户继续单击它，它将以无休止的循环结束

有没有办法让它显示在代码视图readme.md上，而不是显示在呈现的jekyll版本上？

解决方案： 如果您想让Jekyll跳过处理行（甚至一个字符）进入烘焙站点/输出，请使用Liquid

{%comment%}

标记：

{% comment %} 

     Character or lines for Jekyll to skip.

{% endcomment %}

例子： 之前：

之后：

说明： 如果markdown.md页面的顶部有Jekyll

Front Matter

，那么它将由Jekyll处理为markdown.html页面（）

Jekyll处理的页面可以包含液体代码（特别是）

液体具有一个

{%comment%}

标记。这对杰基尔很有效

:

评论

允许您将未呈现的代码保留在液体模板中。任何 开始和结束注释块中的文本将不会显示 打印，并且不会执行其中的任何液体代码

如果Jekyll处理您的markdown.md页面，它将处理所有液态语句，并将完全忽略输出文件中的

{%comment%}

tag+

{%endcomment%}

tag+以及介于两者之间的所有内容

由

{%comment%}

标记包装的文本不需要包含液体，Jekyll就可以排除它。输出页面中的所有内容都将被忽略：例如元素、其他代码、纯文本等

警告： 如果您有不正确的液体语法，即使它在注释标记中，Jekyll仍会抛出错误

以下操作将导致错误，并且Jekyll将不会生成：

{% comment %} 

     Character or lines for Jekyll to skip.
     {% assign abc 

{% endcomment %}

要防止出现这种情况，请确保（1）注释标记中的所有代码都是有效的液体，或（2）通过将代码包装在

{%raw%}

标记中，防止Jekyll对代码进行求值：

{% comment %} 
     {% raw %}

     Character or lines for Jekyll to skip.
     {% assign abc 

     {% endraw %}
{% endcomment %}

然后，注释中的所有内容都将成功地从/u site/files Jekyll输出中排除

有关详细信息，请参阅

---

或者：

如果您只想从站点的GitHub存储库链接到Jekyll+GitHub页面生成的站点

登录

转到

用户或组织

/

存储库名称

单击“编辑”按钮（在“克隆或下载”上方和“设置”下方）

在提示“此存储库的网站（可选）”的第二个文本字段中将URL添加到GitHub Pages网站，然后单击“保存”

从README.md中删除URL

---

你为什么在最后一页上展示自述文件？这是一个通过Jekyll阅读repo的/docs文件夹自动发布的页面。我公司运行的企业版上几乎没有可用的配置。Readme.md实际上变成了index.html。因此，如果我在自述文件上键入，点击“漂亮的杰基尔化的漂亮版本”，它仍然会在“漂亮版本”上显示，这是一个没有意义的无休止的循环，所以如果可能的话，我想用唯一的标记代码隐藏它。