<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/python-markdown.git/docs/extensions, branch issue712</title>
<subtitle>github.com: waylan/Python-Markdown.git
</subtitle>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/'/>
<entry>
<title>Support custom labels in TOC. (#700)</title>
<updated>2018-09-05T19:54:16+00:00</updated>
<author>
<name>Waylan Limberg</name>
<email>waylan.limberg@icloud.com</email>
</author>
<published>2018-09-05T19:54:16+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=f51125d01b88067d8523e9706cfa4558b3808222'/>
<id>f51125d01b88067d8523e9706cfa4558b3808222</id>
<content type='text'>
New `toc_tokens` attribute on Markdown class.
Contains the raw tokens used to build the Table of Contents. Users can 
use this to build their own custom Table of Contents rather than needing 
to parse the HTML available on the `toc` attribute of the Markdown 
class.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
New `toc_tokens` attribute on Markdown class.
Contains the raw tokens used to build the Table of Contents. Users can 
use this to build their own custom Table of Contents rather than needing 
to parse the HTML available on the `toc` attribute of the Markdown 
class.
</pre>
</div>
</content>
</entry>
<entry>
<title>Update 3.0 release notes</title>
<updated>2018-08-03T23:18:34+00:00</updated>
<author>
<name>Waylan Limberg</name>
<email>waylan.limberg@icloud.com</email>
</author>
<published>2018-08-02T18:51:16+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=833574a9da27874614f7184f85f7993a539f3df1'/>
<id>833574a9da27874614f7184f85f7993a539f3df1</id>
<content type='text'>
And other docs cleanup.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
And other docs cleanup.
</pre>
</div>
</content>
</entry>
<entry>
<title>Add toc_depth parameter to toc extension</title>
<updated>2018-07-24T19:07:14+00:00</updated>
<author>
<name>Jesús Fernández</name>
<email>fernandez.cuesta@gmail.com</email>
</author>
<published>2015-09-01T15:29:37+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=a9f1171d3bd7908fbcfd3df0b7b36c9dd7c4607c'/>
<id>a9f1171d3bd7908fbcfd3df0b7b36c9dd7c4607c</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Add the possibility to set additional classes</title>
<updated>2018-07-24T18:42:42+00:00</updated>
<author>
<name>WhiteWinterWolf</name>
<email>github@whitewinterwolf.com</email>
</author>
<published>2017-09-08T11:45:19+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=67bb12b3e508b389f18efb6a992cc390680a7235'/>
<id>67bb12b3e508b389f18efb6a992cc390680a7235</id>
<content type='text'>
Additional CSS classes names can be appended to the admonition name
using spaces as separators.

The following markdown:

    !!! note floatright
        This is a floating note.

Generates the following HTML code:

    &lt;div class="admonition note floatright"&gt;
        &lt;p class="admonition-title"&gt;Note&lt;/p&gt;
        &lt;p&gt;This is a floating note.&lt;/p&gt;
    &lt;/div&gt;
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Additional CSS classes names can be appended to the admonition name
using spaces as separators.

The following markdown:

    !!! note floatright
        This is a floating note.

Generates the following HTML code:

    &lt;div class="admonition note floatright"&gt;
        &lt;p class="admonition-title"&gt;Note&lt;/p&gt;
        &lt;p&gt;This is a floating note.&lt;/p&gt;
    &lt;/div&gt;
</pre>
</div>
</content>
</entry>
<entry>
<title>typo fix in nl2br.md (#673)</title>
<updated>2018-06-23T17:25:06+00:00</updated>
<author>
<name>Vyacheslav Matyukhin</name>
<email>me@berekuk.ru</email>
</author>
<published>2018-06-23T17:25:06+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=d54e09419990b9d96196eaca60f8b31aebeb0a45'/>
<id>d54e09419990b9d96196eaca60f8b31aebeb0a45</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Fix formatting in fenced code block example</title>
<updated>2018-06-05T13:02:39+00:00</updated>
<author>
<name>Dmitry Shachnev</name>
<email>mitya57@gmail.com</email>
</author>
<published>2018-06-05T13:02:39+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=d321e798228f6db61d0d477b756a34a8f1d5b8d0'/>
<id>d321e798228f6db61d0d477b756a34a8f1d5b8d0</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Fix typos</title>
<updated>2018-02-17T20:15:56+00:00</updated>
<author>
<name>Jakub Wilk</name>
<email>jwilk@jwilk.net</email>
</author>
<published>2018-02-17T09:58:49+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=b0e993a23ab96562d9e0e86fcba715c9d8b9ffcf'/>
<id>b0e993a23ab96562d9e0e86fcba715c9d8b9ffcf</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Flexible inline (#629)</title>
<updated>2018-01-18T01:36:34+00:00</updated>
<author>
<name>Isaac Muse</name>
<email>faceless.shop@gmail.com</email>
</author>
<published>2018-01-18T01:36:34+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=d18c3d0acab0e7469c3284c897afcb61f9dd1fea'/>
<id>d18c3d0acab0e7469c3284c897afcb61f9dd1fea</id>
<content type='text'>
Add new InlineProcessor class that handles inline processing much better and allows for more flexibility. This adds new InlineProcessors that no longer utilize unnecessary pretext and posttext captures. New class can accept the buffer that is being worked on and manually process the text without regex and return new replacement bounds. This helps us to handle links in a better way and handle nested brackets and logic that is too much for regular expression. The refactor also allows image links to have links/paths with spaces like links. Ref #551, #613, #590, #161.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Add new InlineProcessor class that handles inline processing much better and allows for more flexibility. This adds new InlineProcessors that no longer utilize unnecessary pretext and posttext captures. New class can accept the buffer that is being worked on and manually process the text without regex and return new replacement bounds. This helps us to handle links in a better way and handle nested brackets and logic that is too much for regular expression. The refactor also allows image links to have links/paths with spaces like links. Ref #551, #613, #590, #161.
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: Remove references to header_id.md page.</title>
<updated>2018-01-13T04:15:45+00:00</updated>
<author>
<name>Dmitry Shachnev</name>
<email>mitya57@gmail.com</email>
</author>
<published>2018-01-12T11:54:19+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=6d1537ac5e528db9e91cf905f507bb409e546d2c'/>
<id>6d1537ac5e528db9e91cf905f507bb409e546d2c</id>
<content type='text'>
The page was removed along with the extension in 1127013.

Also ensure any future MkDocs warnings cause the build to fail in the tests
so we don't introduce similar errors in the future.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
The page was removed along with the extension in 1127013.

Also ensure any future MkDocs warnings cause the build to fail in the tests
so we don't introduce similar errors in the future.
</pre>
</div>
</content>
</entry>
<entry>
<title>Refactor Extension loading (#627)</title>
<updated>2018-01-13T03:48:41+00:00</updated>
<author>
<name>Waylan Limberg</name>
<email>waylan.limberg@icloud.com</email>
</author>
<published>2018-01-13T03:48:41+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-markdown.git/commit/?id=cd7324333a995eeb62a3e6eacdb3b179c6256133'/>
<id>cd7324333a995eeb62a3e6eacdb3b179c6256133</id>
<content type='text'>
Deprecated naming support is removed:

* Removed special treatment for modules in `markdown.extensions`
* Removed support for `mdx_` prefixes.

Support for Entry Point names added:

Support for "short names" are now implemented with entry points. 
Therefore all the users who call extension names as `toc` will not 
get errors as the builtin extensions all have entry points defined 
which match the old "short names" for modules in 
`markdown.extensions`. The benefit is that any extension can offer
the same support without requiring the user to manually copy a file 
to that location on the file system (way to many extension authors 
have included such instructions in their installation documentation).

The one odd thing about this is that we have been issuing a 
DeprecationWarning for short names and now they are fully supported 
again. But I think it's the right thing to do.

Support for using dot notation is not removed. After all, it was never 
deprecated. And we shouldn't "force" entry points. There are plenty of 
reasons why users may not want that and not all of them can be 
resolved by using class instances instead.

All of the following ways to load an extension are valid:

    # Class instance
    from markdown.extensions.toc import TocExtension
    markdown.markdown(src, extensions=[TocExtension()]

    # Entry point name
    markdown.markdown(src, extensions=['toc'])

    # Dot notation with class
    markdown.markdown(src, extensions=['markdown.extensions.toc:TocExtension'])

    # Dot notation without class
    markdown.markdown(src, extensions=['markdown.extensions.toc'])

</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Deprecated naming support is removed:

* Removed special treatment for modules in `markdown.extensions`
* Removed support for `mdx_` prefixes.

Support for Entry Point names added:

Support for "short names" are now implemented with entry points. 
Therefore all the users who call extension names as `toc` will not 
get errors as the builtin extensions all have entry points defined 
which match the old "short names" for modules in 
`markdown.extensions`. The benefit is that any extension can offer
the same support without requiring the user to manually copy a file 
to that location on the file system (way to many extension authors 
have included such instructions in their installation documentation).

The one odd thing about this is that we have been issuing a 
DeprecationWarning for short names and now they are fully supported 
again. But I think it's the right thing to do.

Support for using dot notation is not removed. After all, it was never 
deprecated. And we shouldn't "force" entry points. There are plenty of 
reasons why users may not want that and not all of them can be 
resolved by using class instances instead.

All of the following ways to load an extension are valid:

    # Class instance
    from markdown.extensions.toc import TocExtension
    markdown.markdown(src, extensions=[TocExtension()]

    # Entry point name
    markdown.markdown(src, extensions=['toc'])

    # Dot notation with class
    markdown.markdown(src, extensions=['markdown.extensions.toc:TocExtension'])

    # Dot notation without class
    markdown.markdown(src, extensions=['markdown.extensions.toc'])

</pre>
</div>
</content>
</entry>
</feed>
