tufte-jekyll边注与侧注使用教程:让你的文章更具学术范儿 tufte-jekyll边注与侧注使用教程让你的文章更具学术范儿【免费下载链接】tufte-jekyllMinimal Jekyll blog styled to resemble the look and layout of Edward Tuftes books项目地址: https://gitcode.com/gh_mirrors/tu/tufte-jekylltufte-jekyll是一款极简风格的Jekyll博客主题其设计灵感来源于Edward Tufte的书籍和讲义风格。该主题以广泛使用边注sidenote、侧注marginnote、图文紧密结合以及精致排版而闻名能帮助用户创建具有学术气息的文章。为什么选择tufte-jekyll的边注与侧注功能tufte-jekyll的边注和侧注功能是其最突出的特色之一。这些功能不仅能为文章提供额外的补充信息还能保持正文的流畅性和简洁性让读者可以根据自己的兴趣选择深入阅读细节还是快速浏览主要内容。在学术写作中边注和侧注常用于添加参考文献、解释专业术语或提供额外的背景信息。使用tufte-jekyll的这些功能可以让你的文章看起来更加专业、严谨同时也提升了阅读体验。边注sidenote的使用方法边注的基本语法边注会在正文中显示一个上标数字点击该数字可以查看边注内容。其基本语法如下{% sidenote sidenote-id 这是一个边注示例它会显示一个上标数字。 %}其中sidenote-id是边注的唯一标识符确保每个边注都有独特的ID非常重要。第二个参数是边注的内容可以包含Markdown格式。边注的实际应用示例以下是一个边注在列表中的应用示例Split Bregman iteration {% sidenote 1 Goldstein, T. and Osher, S. (2009). The split Bregman method for l1-regularized problems. SIAM J. Img. Sci., 2:323-343. %}Dykstras alternating projection algorithm {% sidenote 2 Dykstra, R. L. (1983). An algorithm for restricted least squares regression. J. Amer. Statist. Assoc., 78(384):837-842. %}这个示例展示了如何在列表项中使用边注来添加参考文献。在实际应用中边注可以用于各种需要补充说明的场景。边注在不同屏幕尺寸上的表现在大屏幕上边注会显示在页面右侧的空白区域而在小屏幕设备上边注会隐藏起来当用户点击上标数字时边注内容会显示在正文下方再次点击则会关闭。这种响应式设计确保了在各种设备上都能获得良好的阅读体验。侧注marginnote的使用方法侧注的基本语法侧注与边注类似但不会在正文中显示上标数字。其基本语法如下{% marginnote margin-note-id 这是一个侧注示例它不会显示上标数字。 %}同样margin-note-id是侧注的唯一标识符第二个参数是侧注内容。侧注的实际应用示例侧注可以用于添加一些不需要编号的补充信息例如对表格的说明{% marginnote table-1-id Table 1: A table with default style formatting %}在这个示例中侧注用于说明表格的样式。在小屏幕设备上侧注会隐藏取而代之的是一个符号⊕点击该符号可以显示侧注内容。边注与侧注的区别与适用场景边注和侧注虽然功能相似但在使用场景上有一些区别边注适合需要编号的补充信息如参考文献、重要的解释说明等。由于有编号读者可以很容易地将边注与正文内容对应起来。侧注适合不需要编号的补充信息如图表说明、额外的背景知识等。侧注不会打断正文的阅读节奏适合提供一些辅助性的信息。上图展示了tufte-jekyll中边注与正文结合的排版效果边注内容位于页面右侧既提供了额外信息又不影响正文的阅读。如何在tufte-jekyll中实现边注与侧注功能tufte-jekyll的边注和侧注功能是通过自定义的Liquid标签实现的。相关的代码文件位于_plugins/sidenote.rb和_plugins/marginnote.rb。例如sidenote.rb中的代码定义了边注标签的生成方式label for#{text[0]} classmargin-toggle sidenote-number/labelinput typecheckbox id#{text[0]} classmargin-toggle/span classsidenote#{text[1]} /span这段代码生成了边注所需的HTML结构包括用于切换显示的复选框和边注内容的容器。边注与侧注使用的注意事项确保ID的唯一性在使用边注和侧注时必须确保每个标签的ID是唯一的。建议使用有意义的ID名称如sidenote-ref-1或marginnote-table-1这样有助于代码的维护和调试。避免在列表中过度使用边注当在列表项中使用边注时可能会出现排版问题特别是当边注内容较多时。例如列表项一 {% sidenote 1 较长的边注内容... %}列表项二 {% sidenote 2 较长的边注内容... %}这种情况下边注可能会导致列表项之间的水平对齐出现问题。解决方法是在列表项之间添加空行或者考虑使用侧注代替边注。注意内容的简洁性边注和侧注的目的是提供补充信息而不是重复或扩展正文内容。因此应保持边注和侧注内容的简洁性避免包含过多无关信息。上图是tufte-jekyll中图片与侧注结合的示例展示了该主题在图文排版方面的优势。总结tufte-jekyll的边注和侧注功能为创建学术风格的文章提供了强大的支持。通过合理使用这些功能可以让你的文章更加专业、易读同时也能提升读者的阅读体验。无论是撰写学术论文、技术文档还是个人博客tufte-jekyll的边注和侧注功能都能帮助你更好地组织内容突出重点为读者提供更丰富的信息。希望本教程能帮助你掌握tufte-jekyll边注与侧注的使用方法让你的文章更具学术范儿【免费下载链接】tufte-jekyllMinimal Jekyll blog styled to resemble the look and layout of Edward Tuftes books项目地址: https://gitcode.com/gh_mirrors/tu/tufte-jekyll创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考