👌 Add myst_enable_checkboxes config (#686)

Author: chrisjsewell

docs/conf.py

@@ -106,6 +106,7 @@
 myst_heading_anchors = 2
 myst_footnote_transition = True
 myst_dmath_double_inline = True
+myst_enable_checkboxes = True
 
 # -- HTML output -------------------------------------------------
 

myst_parser/config/main.py

@@ -300,6 +300,15 @@ class MdParserConfig:
         },
     )
 
+    enable_checkboxes: bool = dc.field(
+        default=False,
+        metadata={
+            "validator": instance_of(bool),
+            "help": "Enable checkboxes",
+            "extension": "tasklist",
+        },
+    )
+
     # docutils only (replicating aspects of sphinx config)
 
     suppress_warnings: Sequence[str] = dc.field(

myst_parser/parsers/mdit.py

@@ -48,7 +48,7 @@ def create_md_parser(
             # note, strikethrough currently only supported tentatively for HTML
             .enable("strikethrough")
             .enable("table")
-            .use(tasklists_plugin)
+            .use(tasklists_plugin, enabled=config.enable_checkboxes)
             .enable("linkify")
             .use(wordcount_plugin, per_minute=config.words_per_minute)
         )
@@ -98,7 +98,7 @@ def create_md_parser(
     if "fieldlist" in config.enable_extensions:
         md.use(fieldlist_plugin)
     if "tasklist" in config.enable_extensions:
-        md.use(tasklists_plugin)
+        md.use(tasklists_plugin, enabled=config.enable_checkboxes)
     if "substitution" in config.enable_extensions:
         md.use(substitution_plugin, *config.sub_delimiters)
     if "attrs_inline" in config.enable_extensions:

tests/test_renderers/fixtures/myst-config.txt

@@ -156,6 +156,25 @@ www.commonmark.org/he<lp
         <lp
 .
 
+[tasklist] --myst-enable-extensions=tasklist --myst-enable-checkboxes="true"
+.
+- [ ] a
+- [x] b
+.
+<document source="<string>">
+    <bullet_list bullet="-" classes="contains-task-list">
+        <list_item classes="task-list-item enabled">
+            <paragraph>
+                <raw format="html" xml:space="preserve">
+                    <input class="task-list-item-checkbox"  type="checkbox">
+                 a
+        <list_item classes="task-list-item enabled">
+            <paragraph>
+                <raw format="html" xml:space="preserve">
+                    <input class="task-list-item-checkbox" checked="checked"  type="checkbox">
+                 b
+.
+
 [heading_anchors] --myst-heading-anchors=1
 .
 # My title