diff --git a/docs/change_log/index.md b/docs/change_log/index.md index fc7808732..87d57eb17 100644 --- a/docs/change_log/index.md +++ b/docs/change_log/index.md @@ -3,7 +3,7 @@ title: Change Log Python-Markdown Change Log ========================= -Under development: version 3.4.0 ([Notes](release-3.4.md)). +July 15, 2022: version 3.4 ([Notes](release-3.4.md)). May 5, 2022: version 3.3.7 (a bug-fix release). diff --git a/docs/change_log/release-3.4.md b/docs/change_log/release-3.4.md index 9db6707d0..bfa807560 100644 --- a/docs/change_log/release-3.4.md +++ b/docs/change_log/release-3.4.md @@ -7,18 +7,19 @@ PyPy3. ## Backwards-incompatible changes -### The `table` extension now uses a `style` attribute instead of `align` attribute for alignment. +### The `tables` extension now uses a `style` attribute instead of an `align` attribute for alignment. -The [HTML4 spec][spec4] specifically -deprecates the use of the `align` attribute and it does not appear at all in the -[HTML5 spec][spec5]. Therefore, by default, the [table] extension will now use the `style` -attribute (setting just the `text-align` property) in `td` and `th` blocks. +The [HTML4 spec][spec4] specifically deprecates the use of the `align` attribute +and it does not appear at all in the [HTML5 spec][spec5]. Therefore, by default, +the [tables] extension will now use the `style` attribute (setting just the +`text-align` property) in `td` and `th` blocks. [spec4]: https://www.w3.org/TR/html4/present/graphics.html#h-15.1.2 [spec5]: https://www.w3.org/TR/html53/tabular-data.html#attributes-common-to-td-and-th-elements +[tables]: ../extensions/tables.md -The former behavior is available by setting the setting `use_align_attribute` configuration -option to `True` when adding the extension. +The former behavior is available by setting the `use_align_attribute` +configuration option to `True` when enabling the extension. For example, to configure the old `align` behavior: @@ -28,12 +29,11 @@ from markdown.extensions.tables import TableExtension markdown.markdown(src, extensions=[TableExtension(use_align_attribute=True)]) ``` -In addition, tests were moved to the modern test environment. - ### Backslash unescaping moved to Treeprocessor (#1131). -Unescaping backslash escapes has been moved to a Treeprocessor. However, it is -recognized that various third-party extensions may be calling the old class at +Unescaping backslash escapes has been moved to a Treeprocessor, which enables +proper HTML escaping during serialization. However, it is recognized that +various third-party extensions may be calling the old class at `postprocessors.UnescapePostprocessor`. Therefore, the old class remains in the code base, but has been deprecated and will be removed in a future release. The new class `treeprocessors.UnescapeTreeprocessor` should be used instead. @@ -43,7 +43,7 @@ new class `treeprocessors.UnescapeTreeprocessor` should be used instead. Various objects were deprecated in version 3.0 and began raising deprecation warnings (see the [version 3.0 release notes] for details). Any of those objects which remained in version 3.3 have been removed from the code base in version 3.4 -and will now raise errors. A summary of the objects are provided below. +and will now raise errors. The relevant objects are listed below. [version 3.0 release notes]: release-3.0.md @@ -56,7 +56,7 @@ and will now raise errors. A summary of the objects are provided below. | `markdown.util.text_type` | `str` | | `markdown.util.int2str` | `chr` | | `markdown.util.iterrange` | `range` | -| `markdown.util.isBlockLevel` | `markdown.Markdown.is_block_level` | +| `markdown.util.isBlockLevel` | `markdown.Markdown().is_block_level`| | `markdown.util.Processor().markdown` | `markdown.util.Processor().md` | | `markdown.util.Registry().__setitem__` | `markdown.util.Registry().register` | | `markdown.util.Registry().__delitem__` |`markdown.util.Registry().deregister`| @@ -70,38 +70,44 @@ valid parameter and will raise an error if provided. The following new features have been included in the 3.4 release: -* Use `style` attribute in tables for alignment instead of `align` for better CSS - inter-operation. The old behavior is available by setting `use_align_attribute=True` when - adding the extension. -* Some new configuration options have been added to the [footnotes](../extensions/footnotes.md) - extension (#1218): +* Some new configuration options have been added to the + [footnotes](../extensions/footnotes.md) extension (#1218): + + * Small refactor of the `BACKLINK_TITLE` option; The use of `format()` + instead of "old" `%d` formatter allows one to specify text without the + need to have the number of the footnote in it (like footnotes on + Wikipedia for example). The modification is backward compatible so no + configuration change is required. + + * Addition of a new option `SUPERSCRIPT_TEXT` that allows one to specify a + custom placeholder for the footnote itself in the text. + Ex: `[{}]` will give `[1]`, `({})` will give `(1)`, + or by default, the current behavior: `1`. - * Small refactor of the `BACKLINK_TITLE` option; The use of `format()` instead - of "old" `%d` formatter allows to specify text without the need to have the - number of the footnote in it (like footnotes on Wikipedia for example). - The modification is backward compatible so no configuration change is required. +* The [Table of Contents](../extensions/toc.md) extension now accepts a + `toc_class` parameter which can be used to set the CSS class(es) on the + `
` handling of `PrettifyTreeprocessor` (#1261, #1263).
+* Added additional checks to the `` handling of
+ `PrettifyTreeprocessor` (#1261, #1263).
diff --git a/docs/extensions/code_hilite.md b/docs/extensions/code_hilite.md
index 5179d0a6f..19b9d526d 100644
--- a/docs/extensions/code_hilite.md
+++ b/docs/extensions/code_hilite.md
@@ -232,7 +232,7 @@ The following options are provided to configure the output:
The prefix prepended to the language class assigned to the HTML `` tag. Default: `language-`.
* **`pygments_formatter`**{ #pygments_formatter }:
- This option can be used to change the Pygments formatter used for highlighting the code blocks. By default, this
+ This option can be used to change the Pygments formatter used for highlighting code blocks. By default, this
is set to the string `'html'`, which means it'll use the default `HtmlFormatter` provided by Pygments.
This can be set to a string representing any of the other default formatters, or set to a formatter class (or
@@ -290,7 +290,7 @@ markdown.markdown(
)
```
-The formatter above will output the following HTML structure for the code block:
+The formatter above will output the following HTML structure for a code block:
```html
diff --git a/markdown/__meta__.py b/markdown/__meta__.py
index 92dd5cf40..1c6c44155 100644
--- a/markdown/__meta__.py
+++ b/markdown/__meta__.py
@@ -26,7 +26,7 @@
# (1, 2, 0, 'beta', 2) => "1.2b2"
# (1, 2, 0, 'rc', 4) => "1.2rc4"
# (1, 2, 0, 'final', 0) => "1.2"
-__version_info__ = (3, 4, 0, 'dev', 0)
+__version_info__ = (3, 4, 0, 'final', 0)
def _get_version(version_info):