☰

关于使用 Latex 创建在线测验的新软件包的反馈

tag-icon • tag-icon tex4ht package-writing ctan webquiz
关于使用 Latex 创建在线测验的新软件包的反馈

网上测验现已作为 ctan 上的软件包发布。它将包含在 TeXLive 2019 中。因此，下面的链接已更新为指向 ctan，或已禁用。

如果您想从 ctan zipfile 安装 WebQuiz，请运行：

webquiz --tex-install

从管理员帐户，或使用

 sudo webquiz --tex-install

在类 unix 系统（包括 macosx）上。这会将包安装到 TeXLive 树中的“标准”位置。（可执行文件webquiz位于webquiz/scriptszipfile 目录中。）我不确定这会在 Windows PC 上做什么。

可以说，这个问题要么太宽泛，要么超出了 TeX.SX 的范围，所以我接受关闭它。因为我只想要反馈，所以如果能把它做成社区 wiki，我也会很高兴。

我有一个接近完成的乳胶包，WebQuiz，文档，可用于从“普通” latex 文件开始编写在线测验。该软件包基本上已准备好上传到 ctan，但在我这样做之前，我非常感谢 TeX.SX 的反馈，无论是来自 TeX 专家还是可能使用此类软件包的人。我希望解决任何现有问题前该软件包会出现在 ctan 上，而不必在代码首次出现后不久就发布新的版本。

使用来自“真实”测验的示例，该包的想法是使用如下乳胶文件：

\documentclass{webquiz}
\title{Quiz 1: Numbers and sets}
\begin{document}

    \begin{question}
    Which of the following are correct ways of writing the set
    \[ A=\{x \in \mathbb{R} \mid -3 < x \leq -1 \text{ or } x\geq 0\} ?\]
    \begin{choice}
    \incorrect $(-3,\infty)$
    The interval \response $(-3,\infty)$ includes the real numbers between $-1$ and $0$,
    which do not belong to $A$.

    \incorrect $[-3,\infty)$
    \response The interval $[-3,\infty)$ includes $-3$, as well as
    the real numbers between $-1$ and $0$, none of which belong to $A$.

    \incorrect $[-3,-1]\cap[0,\infty)$
    \response The interval $[-3,-1]\cap[0,\infty)$ is the empty set $\emptyset$. As $A$ is not empty (for example, $A$ includes $-1$), this option cannot be correct.

    \incorrect $(-3,-1)\cup[0,\infty)$
    \response The interval $-1$ is not in $(-3,-1)\cup[0,\infty)$, but $-1$ is in $A$.

    \correct $(-3,-1]\cup[0,\infty)$
    \end{choice}
    \end{question}

    ...more questions...
\end{document}

你可以制作一个类似这样的在线测验（在一些不明智的回答选项之后b）：

在此处输入图片描述

WebQuiz 每次显示一个问题。它形成性评估工具。它不收集评估数据，也不担心由此引起的任何相关“安全问题”。使用该软件包制作的测验非常适合用作复习资源。一个关键功能是，测验编写者可以根据学生对问题给出的每个可能答案向他们提供反馈。

要使用 WebQuiz 编写测验，你只需要具备 LaTeX 的工作知识。仅此而已。在后台，测验从 LaTeX 到 HTML 的转换是使用tex4ht（和 制作4小时) 和一些 python 代码。更详细地说，tex4ht、make4ht、xml、python、HTML、mathjax、css 和 javascript 都发挥了作用，但 LaTeX 用户只需要了解 LaTeX。

作为tex4ht是底层引擎，肯定存在 WebQuiz 无法处理的 LaTeX 代码。话虽如此，该系统已经被用来编写数千道测验题，没有任何问题。特别是，它可以使用蒂克兹和普斯特里克在 WebQuiz 测验中，尽管使用这些包进行（非常？）复杂的绘图可能会失败。

我对大家愿意给我的任何反馈都很感兴趣。我特别想知道以下内容：

  • 该 zip 文件是否针对 ctan 正确打包？
  • 安装过程是否清晰并且有效？（安装过程对我来说有效，但对其他人来说可能会失败。一旦软件包在 ctan 上，这将变得更容易）
  • 是否存在任何错误或者明显的改进？
  • 文档中是否缺少什么或者有什么不清楚的地方？
  • 是否存在字体编码问题？也许不明智地将所有内容都处理为 UTF-8
  • 为了在 tex 系统更新时保留设置，该软件包将系统配置文件保存在 中$TEXMFLOCAL/scripts/webquiz/webquizrc。这是合适的地方吗？它可以在 Windows 和 MikTeX 下工作吗？
  • 在 Windows 下有问题吗？最好能修复，因为我没有 Windows 电脑，所以无法测试此类问题。

WebQuiz 的第一个完整版本写于 2004 年左右。今年我几乎完全重写了它，同时使其与 HRML5 兼容，更重要的是，将其从内部代码更改为功能更全面的软件包。大部分代码已被广泛使用，因此经过了充分测试。一些新的较少功能，例如“可编程”命令\BreadCrumbs和安装程序，相对未经测试。如果我在打包时对许多最近更改的内容造成破坏，我不会感到太惊讶。这就是为什么我希望在将软件包放到 ctan 上之前得到一些反馈。

WebQuiz 需要最新版本的 LaTeX，包括 TeX4ht 和 make4ht、最新版本的 Python 3，当然还需要一个 Web 服务器。手册的第 5 页（即 zip 文件的 doc 目录中的 webquiz.pdf 文件）描述了使代码正常运行所需的步骤。简短版本如下：

  • 目录中的文件latex需要放入 LaTeX 搜索路径（之后您必须运行 texhash 或同等程序）
  • MathQuiz 程序位于scripts目录中。在类 Unix 系统上，最好的选择是创建如下链接 ls -s webquiz.py /usr/local/bin/webquiz
  • 理想情况下，目录中的文件scripts/www需要放在 Web 服务器上的某个位置，可以使用命令 完成webquiz --initialise。事实上，即使你不这样做，WebQuiz 仍会工作，但每次运行程序时，你都会收到有关初始化的（无害的）警告消息，并且在你创建的每个网页上都会收到类似的警告消息
  • 可以在doc目录中找到文档，并在目录中找到手册中的示例代码scripts/www/examples。

安装 WebQuiz 后，您可以测试您的测验文件测验.tex首先使用 (pdf)LaTeX 创建 DVI 或 PDf 文件，然后使用

webquiz quiz.tex

从命令行生成文件quiz.html，您可以使用 Web 浏览器查看该文件。

我曾在 Linux 和 Mac 操作系统上使用过 WebQuiz。有几个小组在 Windows 下也用过，但我没有 Windows 机器，所以我自己没有做过。

最后，我对这篇文章的长度、软件包中的任何错误以及这里和我确信存在的文档中的许多错别字表示歉意......

答案1

自从我发布这个问题以来已经有一段时间了，所以我很高兴地说，这个包终于在 ctan 上可用了。正如上面的评论所建议的，包的名称已更改为网上测验自从我发布这个问题以来，这个软件包已经扩展了一些。特别是，它现在包括对 11 种语言的支持（原则上，对其他语言的支持很容易添加）和不同的颜色主题（其中一些可以说是很糟糕——抱歉！）。

除了询问软件包的功能之外，我在帖子中提出的主要问题是如何最好地打包代码ctan（和 TeXLive）。ctan 和 TeXLive 维护者告诉我，他们强烈倾向于使用 zip 文件（和不是TDS 文件），其中包含：

  • 顶层目录中的 README 文件
  • 为包的 和 组件latex创建doc单独的目录script
  • TeXLive 要求提供 UNIX 手册页，因为该包包含一个独立的可执行文件
  • 我最初将所有需要在程序初始化时安装的 Web 文件都放在目录中scripts。TeXLive 要求将这些文件移动到目录中，doc因为目录中的文件位于scripts运行时搜索树中
  • 如果一个文件需要在不同的目录中包含两次，那么第二个副本应该是符号链接

相关内容