风格指南

除了手稿的一般说明，我们要求所有提交的文件都使用LaTeX和JSS样式的文件进行格式化（与模板一起链接在下面）。建议尽可能简化LaTeX代码，即避免包含不必要的包/命令。我们要求您特别注意常见问题（FAQ）.

为了方便以JSS风格创作手稿，我们在这个页面上提供了几个模板。具体来说，一个简短的演示文章可使用普通LaTeX或组合R/LaTeX。为了概述JSS文章的典型结构，我们使用了一些简短的文本片段，这些片段的灵感来源于doi:10.18637/jss.v027.i08（Zeileis等人，2008），讨论了R。

对于R软件的作者，我们建议编写R/LaTeX文档(.Rnw（右）)使用Sweave公司或针织物。由此得出LaTeX文件(.tex码)可以通过编织/编织以及R复制代码获得(右)通过纠缠。

乳胶

使用纯LaTeX时，可以从以下文章模板开始：jss-article-tex.zip（包括所有必要的样式文件）。源文件商品交易所可以在任何文本编辑器或专用LaTeX编辑器（包括RStudio）中进行编辑。为了制作手稿，应该使用pdfLaTeX，专门的编辑通常有一个“编译PDF”按钮或类似的按钮。在命令行上texi2pdf格式方便：

texi2pdf文章.tex

相应的参考文献见BibTeX参考书目参考bib.复制代码文章。R（右）必须单独准备，最好包括注释，以便与手稿匹配。

代码段

代码段贡献的生成方式与文章相同。您只需从\文档类[文章]{jss}到\文档类[代码段]{jss}在LaTeX文档的第一行。

软件和书评

对于软件和书籍评论，LaTeX模板在jss-review-tex.zip（包括所有必要的样式文件）。生成PDF输出的过程与上述相同LaTeX段.

R/LaTeX通过Sweave公司或针织物

要使用R/Latex生成JSS文章，请从以下模板开始：jss-article-rnw.zip（包括所有必要的样式文件）。JSS贡献的源文件是文章。雷诺手稿和参考bibBibTeX格式的参考书目。要制作PDF手稿，文章必须首先进行编织：

Swave（“article.Rnw”）

顺从的商品交易所以及图形文件（此处文章可视化.pdf). 此LaTeX文件可以使用pdfLaTeX以“通常”的方式编译为PDF，即使用shell、某些LaTeX编辑器（另请参阅上文）或简单地使用R：

库（“工具”）texi2pdf（“article.tex”）

RStudio用户的另一种方法是直接使用“编译PDF”按钮文章。雷诺数但是，请确保不要使用协调模式：工具>全局选项>扫描>取消选中：始终启用Rnw协调。

复制代码可以通过缠结获得：

斯坦格尔（“article.Rnw”）

屈服，屈服文章。R（右）。但是，编辑此的注释。R文件通常使读者/审阅者更容易访问。

如果针织物用于准备文章。雷诺文件渲染_扫描（）应该使用钩子来确保JSS样式的代码格式。编织和缠结可以通过以下方式完成针织（）和purl（）分别是。

常见问题

JSS中最重要的风格指南是什么？

下面的项目提供了JSS中最重要的样式指南的快速样式检查表。有关更多详细信息，请参阅JSS风格手册（JSS.pdf）以及其他常见问题解答。

  • 手稿可以由pdfLaTeX编辑。
  • \程序语言,\包装和\代码除明确转义的地方外，在整个论文（包括标题和参考文献）中都被用来突出显示。
  • 参考文献在.bib BibTeX数据库中提供，并包含在文本中\引用,\心脏,\citet公司等。
  • 标题和标题的格式如JSS手册所述：
    • \标题样式中的标题，
    • BibTeX文件中标题样式的所有标题。
    • \截面,\分段等，
    • 用句子形式标注图表（包括标题）
  • 图、表和方程式用\标签并由提及\参考例如。，图~\ref{…}.
  • 软件包包括\引用{}d正确。

JSS中的大写规则是什么？标题风格和句子风格是什么？

在英语中，标题的大小写基本上有两种风格，通常被称为“句子风格”（或“句子大小写”）和“标题风格”（或者“标题大小写””）。尽管没有什么严格的规则，但随后的一套指南应该会有所帮助。

句子风格：只有标题中的第一个单词是大写的，冒号或连字符后面的第一个词也是大写的。当然，专有名称仍然是大写的。一个简单的例子是
一个有趣的主题：Java实现

标题样式：所有主要单词都应大写。这包括标题的第一个和最后一个单词，以及所有名词、代词、形容词、动词、副词和从属连词（if、because、as、that等）。冒号后的第一个单词一定要大写。冠词（a，an，the）、并列连词（and，but，or，nor，for）和任何长度的介词都应保持小写。然而，如果其中任何一个是标题的第一个或最后一个单词，则应大写。如果你的标题中有一个缩写通常是小写的，那么它应该保持小写，尤其是度量单位的缩写。由连字符分隔的两部分单词应将两个单词都大写。示例：

来参加我们的庆祝活动
照顾你的家庭用植物
我们正在为早春做好准备
夏季天气预报：炎热！
随着风的吹拂
张贴在办公室备注板上的喷涂计划
记住遵守所有停车规则
他们在为什么而战？
新纪录：积雪37英寸
滴答滴答：又到夏令时了！

如何引用软件？

许多软件包告诉用户他们希望如何被引用，即在网页或手册中可能有指向合适出版物（书籍、期刊文章、技术报告等）的指针。如果没有推荐的引文，请引用相应的手册或网页。下面给出了SAS/STAT 9.1的示例。

@手册{SAS-STAT，author={{\proglang{SAS}Institute Inc.}}，title={\proglang{SAS/STAT}软件，9.1}版，年份={2003}，地址={Cary，NC}，url={https://www.sas.com/}}

如何引用R包？

请检查是否有该软件包的官方引用。如果是这样，可以在相关CRAN网页上看到，即。，https://CRAN.R-project.org/package=foo或通过在R中查询（如果安装了软件包）引文（“foo”）。如果没有引文，请使用CRAN风格的参考文献作为rJava软件下面的包。

无论如何，请确保BibTeX有效，标题为标题样式，并且\程序语言/\包装/\代码在适当的地方使用。

@手册{rJava，title={\pkg{rJava}:Low-Level\proglang{R}to\progland{Java}Interface}，author={Simon Urbanek}，年份={2009}，注意={\proglang{R}~包版本~0.8-1}，url={https://CRAN.R-project.org/package=rJava},}

\cite、\citet和\citep命令有什么不同？

BibTeX可以以不同的方式处理引文，并为此提供不同的命令。特别是，如果应该在括号中添加诸如页面引用等注释，则这些注释是必要的。

\引用{…}和\城市{…}照常屈服作者（年份）.\城市{…}产量（作者年份）.

可以对其进行修改，以纳入更多文本，例如：。，\citet（第123页）{…}产量作者（年份，第123页）.\citep[参见][了解更多详细信息]{…}产量（详见作者年份）.

\citealp公司可能有助于进一步提高灵活性，有关详细信息，请参阅标准LaTeX/BibTeX手册。

不要使用括号-括号内的结构如（引用{…}）.

缩写应该如何格式化？

缩写词应以大写字母拼写，无其他格式（即无句点、无小写、斜体等）。所有缩写都应与其扩展一起引入，其中扩展应不资本化。（当然，例外情况是扩展名包含专有名称或第一个单词是句子的第一个单词。）示例包括：

支持向量机
MCMC（马尔可夫链蒙特卡罗）

如何设置图形/表格标题的格式？

所有标题应出现在相应的图/表下方。标题应为句子风格，并以句号结尾。没有其他格式（例如\电磁脉冲,\高炉或\它)应用于标题。

所有表格行/列标题也应采用句子样式。表中不应再出现脚注式注释；这些都应该放在标题中。

手稿中的代码应该如何格式化？

代码最好以通常的文本流表示。它应该有足够的空间来方便阅读。请在运算符前后和逗号后加上空格（除非空格具有语法意义）。一个例子是使用

y=a+b*x

和不

y=a+b*x

对于文本中内联显示的代码和逐字代码块中的代码，应该使用间距。

手稿中的代码不应包含逐字代码中的注释。相反，注释应该以正常的LaTeX文本进行。

\代码{…}可用于内联显示的代码块。各种选项可用于逐字代码块：

  • 这个{代码}环境。
  • 这个{代码输入}/{代码输出}环境。
  • 对于R包装，可以使用通常的Sweave环境。有关更多详细信息和示例，请参阅样式手册（jss.pdf）中的第2.4节。

在所有情况下，代码输入/输出必须适合手稿的正常文本宽度。因此，代码输入应该有适当的换行符，代码输出最好使用适当的宽度生成（或编辑）。

对于我的图形来说，什么是良好的笔纸比？

JSS论文的制作方式应确保不仅打印在纸上时易于阅读，而且在屏幕上也易于阅读。因此，图形应该具有笔对纸的比率，以便在两种媒体中都能轻松阅读。特别是，这意味着注释不应该太大或太小。作为一个粗略的指导，图形注释应该大约是图形标题的大小或稍小一些。

在矢量图形（如.pdf）中模拟增大/减小字体大小的一种简单方法是只在较小/较大的绘图设备上绘图。当字体大小保持不变，LaTeX中包含的图形大小保持不变时，这将使字体相对较大/较小。（请注意更大的设备将导致相对较小的注释。）

我的一些图形文件非常大，我该怎么办？

当矢量图形（通常为.pdf）用于具有大量点或线的图形时，例如，在具有大量点的地图、热图或散点图中，通常会发生这种情况。如果矢量图形太大（例如，大于数百KB，并且在PDF查看器中加载需要一些时间），则还应提供其光栅图形版本（.jpg或.png）。应确保光栅图形中的所有注释仍然足够容易阅读（而不是“像素化”）。

在R中，这通常可以通过使用png（）设备而不是pdf（）设备。假设原始图形由创建

pdf（…，高度=H，宽度=W）

那么png（）版本的一个有用的起点是

png（…，高度=H，宽度=W，单位=“in”，res=144）

尽管某些图形可能需要更高的分辨率。

我的R包应该如何反映有关它的手稿是在JSS上发布的？

您应该通过三种方式增强R包：

  • 在\引用{}相关章节。Rd页面。
  • 包括一个引用中的文件说明/引用在包中。当最后的手稿准备出版时，JSS编辑会提供一个合适的文件。
  • 把JSS手稿变成一个包装小品。有关详细信息，请参阅下一个常见问题解答项目。

如何将我的JSS论文转换为R包小品？

对于在JSS中发布R包的作者，我们建议：

  • 使用JSS文件作为包渐晕图的基础。如果您还没有这样做，请对所有输入/输出和图形使用Sweave-style代码块。有关更多详细信息，请参阅Swave手册。
  • 使用无选项\文档类[nojss]{jss}
  • 在小插曲中引用JSS论文（在摘要或导言中）。

通过这样做，小插曲也明显不同于JSS论文，您可以在未来轻松扩展/改进/更正小插曲，使其保持最新。有关示例，请参见

vignette（“三明治”，package=“三明治”）

注意，您不需要在包中包含JSS LaTeX样式的文件。它们与R一起装运，并安装在所有相关的R服务器上（CRAN、R-Forge等）。

通过设置可以获得首选布局

选项（prompt=“R>”，continue=“+”，width=70，useFancyQuotes=FALSE）

在代码块的开头不可见。（然而，请注意，尽管宽度已设置，输入/输出可能仍会被修改，因为宽度不是所有R函数都考虑的。）

JSS中的软件、期刊和出版商名称使用了哪些命名约定？

软件：

  • Fortran（不是：Fortran）
  • Java（不是：Java、Java）
  • MATLAB（非：MATLAB、MATLAB）
  • S-PLUS（非：Splus、S-PLUS）

日记账：

  • 美国统计学家（不是：美国统计员）
  • 统计年鉴（非：统计年鉴）
  • 皇家统计学会杂志B（非：皇家统计学会期刊B辑）

出版商：

  • Springer-Verlag（非：Springer）
  • John Wiley&Sons（非：Wiley，John Wiley&Sons Inc.）

当章节标题中有JSS标记时，我的LaTeX论文无法编译，我该怎么办？

如果要在节标题中使用标记，通常必须通过显式地为书签提供文本而不使用标记来对PDF书签进行转义，例如。，

\节[从R调用C++]{从\proglang{R}}调用\progland{C++}

编译我的LaTeX论文失败，出现错误\开始{文档}，出了什么问题？

原因几乎可以肯定的是，标题中的一些声明没有正确地进行。例如，\原作者,\平原所有权或\纯关键字可能丢失或仍包含标记。

其他

以下是JSS中使用的各种样式约定的列表：

  • 要参考小节，请执行以下操作不使用第x.y小节，只是第x.y节.
  • 使用时例如和即在句点后加一个逗号，以避免LaTeX将其解释为句子的结尾，即：例如。，和即。，.
  • 房屋风格是要使用的$p$~价值,$t$~统计$等（不带连字符）。
  • \顶部应该用作转置符号，例如。，X^\顶部.
  • 对于与R相关的手稿：数据（）和库（）应始终引用，例如。，库（“foo”）.
  • 对于有版本的书籍，应注明为第二版、第三版等。
  • 要引用方程式，可以使用公式~\ref{…}（大写）或（参考{…}）如果方程引用的数量不太多，则首选前者。