如何在reStructuredText（reST）中创建清单？

Question

我正在使用reStructuredText制作简单的核对清单。为此，我使用bullet list，但我想用自定义标志替换标准项目符号，例如空复选框。最理想的是，复选框可以在HTML和/或PDF文档中单击。

如果在reST中不可能/无关紧要，你能推荐其他可能的基于文本的格式吗？

的Bartosz

Answer 1

昨天我遇到了这个并且伪造了它。如果您只是在用户打印文档时查找与复选框具有相同视觉效果的内容（例如，用户无法将我的文档作为HTML表单提交），那么这很容易做到：

- [ ] Checkbox item 1.

  - [ ] sub-item.

  - [ ] another sub-item.

    - [ ] a sub-sub-item.

- [X] an already filled in checkbox.

查看时，它看起来像：

• []复选框项目1。

  • []子项目。

  • []另一个子项目。

  • []子项目。

• [X]已填写的复选框。

Answer 2

6年后，ReST仍然不支持复选框。但是GitHub Flavored Markdown确实支持使用Nick建议的语法的任务列表项。这可以通过tasklist扩展名在GitHub上运行，但默认情况下不会出现在Markdown中。

语法可能在其他Markdown实现中或在其他在线平台上可用，也可能不在。例如，自2019年起，它在StackOverflow's Markdown syntax中不存在。

Answer 3

Unicode 2751适用于我（使用rst2pdf，默认为Helvetica字体）

样式表的相关部分：

base:
bulletFontName: stdFont
bulletFontSize: 10
bulletIndent: 0
bulletText: "\u2751"

Answer 4

我自己没有测试过，但我相信这是一种可行的方式。

首先使用css禁用默认项目符号char：

list-style-type: none;

然后您使用图像作为您的要点。

最后但并非最不重要，您可以使用此技巧在restrusturedtext文件中包含css。 https://stackoverflow.com/a/5815382/728675

Answer 5

第一个用于构建文本内容而不是表单，因此不适合。您可能需要做一些自定义的事情来解决这个问题，因为不可能有一个合适的产品或标记来覆盖这两者。有几种PDF形式的实现，好的旧HTML表单将为Web做。然而，PDF表格可能很昂贵且有问题，特别是如果您必须使用Adobe Lifecycle Designer或类似的东西。

Answer 6

静态

尝试使用Unicode字符。

比直接输入[]麻烦而麻烦。

☑U+2611

☐U+2610

动态

.. |check| raw:: html

    <input checked=""  type="checkbox">

.. |check_| raw:: html

    <input checked=""  disabled="" type="checkbox">

.. |uncheck| raw:: html

    <input type="checkbox">

.. |uncheck_| raw:: html

    <input disabled="" type="checkbox">

checkbox
=============

check to enable: |check|

check disable: |check_| 

uncheck enable: |uncheck|

uncheck disable: |uncheck_|

您可以在以下网站上运行以上代码：https://livesphinx.herokuapp.com/

，您将看到以下图片：