Jekyll Target Blank 插件常见问题解决方案

Jekyll Target Blank 插件常见问题解决方案

jekyll-target-blank Automatically opens external links in a new browser for Jekyll Pages, Posts and Docs. 项目地址: https://gitcode.com/gh_mirrors/je/jekyll-target-blank

1. 项目基础介绍和主要编程语言

项目介绍： Jekyll Target Blank 是一个开源项目，旨在为 Jekyll 静态网站生成器中的外部链接自动添加 target="_blank" 和 rel="noopener noreferrer" 属性。这样做可以让用户点击外部链接时在新标签页中打开，同时提高安全性。

主要编程语言： 该项目的代码主要使用 Ruby 编写，因为它是一个 Jekyll 插件，而 Jekyll 本身是一个使用 Ruby 编写的静态站点生成器。

2. 新手在使用这个项目时需要特别注意的3个问题和详细解决步骤

问题1：如何将 Jekyll Target Blank 集成到我的 Jekyll 项目中？

解决步骤：

1. 将以下代码添加到你的 Jekyll 网站项目的 Gemfile 文件中：

   gem 'jekyll-target-blank'
   

2. 在你的网站项目的 _config.yml 文件中，添加以下插件配置：

   plugins:
     - jekyll-target-blank
   

3. 运行 bundle install 命令来安装 Jekyll Target Blank 插件。
4. 重新构建你的 Jekyll 网站，外部链接将自动包含 target="_blank" 和 rel="noopener noreferrer" 属性。

问题2：如何自定义哪些链接应该在新标签页中打开？

解决步骤：

1. 在 _config.yml 文件中，你可以指定一个 CSS 类名，使得只有包含该类名的链接才会在新标签页中打开。例如：

   target-blank:
     css_class: ext-link
   

2. 然后，在你的 HTML 或 Markdown 链接中添加相应的类名：

   <a href="https://example.com" class="ext-link">Example</a>
   

   或者 Markdown：

   [Example](https://example.com){:class="ext-link"}
   

3. 重建你的网站，现在只有具有指定 CSS 类名的链接会在新标签页中打开。

问题3：如何解决在特定情况下外部链接没有在新标签页中打开的问题？

解决步骤：

1. 确认你的 _config.yml 文件中正确配置了 plugins 和 target-blank 相关设置。
2. 检查链接是否正确地标记为了外部链接。如果链接的域名与 _config.yml 中的 url 设置相同，那么它将被视为内部链接。
3. 确认链接没有错误地使用了 target="_self" 或其他 target 属性，这可能会覆盖 jekyll-target-blank 插件的设置。
4. 如果问题依然存在，检查你的 Jekyll 版本是否与 Jekyll Target Blank 插件兼容。如果版本不兼容，可能需要升级 Jekyll 或寻找相应的插件版本。

通过以上步骤，新手应该能够顺利集成和使用 Jekyll Target Blank 插件。

jekyll-target-blank Automatically opens external links in a new browser for Jekyll Pages, Posts and Docs. 项目地址: https://gitcode.com/gh_mirrors/je/jekyll-target-blank