aboutsummaryrefslogtreecommitdiffstats
path: root/docs/extensions
diff options
context:
space:
mode:
Diffstat (limited to 'docs/extensions')
-rw-r--r--docs/extensions/wikilinks.txt52
1 files changed, 26 insertions, 26 deletions
diff --git a/docs/extensions/wikilinks.txt b/docs/extensions/wikilinks.txt
index ed191e3..5cfdb77 100644
--- a/docs/extensions/wikilinks.txt
+++ b/docs/extensions/wikilinks.txt
@@ -1,7 +1,7 @@
title: Wikilinks Extension
prev_title: Table of Contents Extension
prev_url: toc.html
-next_title: Extension API
+next_title: Extension API
next_url: api.html
WikiLinks
@@ -10,7 +10,7 @@ WikiLinks
Summary
-------
-An extension to Python-Markdown that adds [WikiLinks][]. Specifically, any
+An extension to Python-Markdown that adds [WikiLinks][]. Specifically, any
``[[bracketed]]`` word is converted to a link.
[WikiLinks]: http://en.wikipedia.org/wiki/Wikilink
@@ -21,7 +21,7 @@ Syntax
------
A ``[[bracketed]]`` word is any combination of upper or lower case letters,
-number, dashes, underscores and spaces surrounded by double brackets. Therefore
+number, dashes, underscores and spaces surrounded by double brackets. Therefore
[[Bracketed]]
@@ -29,12 +29,12 @@ Would produce the following html:
<a href="/Bracketed/" class="wikilink">Bracketed</a>
-Note that wikilinks are automatically assigned `class="wikilink"` making it
-easy to style wikilinks differently from other links on a page if one so
+Note that wikilinks are automatically assigned `class="wikilink"` making it
+easy to style wikilinks differently from other links on a page if one so
desires. See below for ways to alter the class.
You should also note that when a space is used, the space is converted to an
-underscore in the link but left as-is in the label. Perhaps an example
+underscore in the link but left as-is in the label. Perhaps an example
would illustrate this best:
[[Wiki Link]]
@@ -51,13 +51,13 @@ From the Python interpreter:
>>> text = "Some text with a [[WikiLink]]."
>>> html = markdown.markdown(text, ['wikilink'])
-The default behavior is to point each link to the document root of the current
-domain and close with a trailing slash. Additionally, each link is assigned to
+The default behavior is to point each link to the document root of the current
+domain and close with a trailing slash. Additionally, each link is assigned to
the html class `wikilink`. This may not always be desirable. Therefore, one can
-customize that behavior within Python code. Four settings are provided to
+customize that behavior within Python code. Four settings are provided to
change the default behavior:
-1. **base_url**: String to append to beginning of URL.
+1. **base_url**: String to append to beginning of URL.
Default: `'/'`
@@ -71,19 +71,19 @@ change the default behavior:
4. **build_url**: Callable which formats the URL from it's parts.
-For an example, let us suppose links should always point to the subdirectory
+For an example, let us suppose links should always point to the subdirectory
`/wiki/` and end with `.html`
- >>> html = markdown.markdown(text,
- ... ['wikilink(base_url=/wiki/,end_url=.html)']
+ >>> html = markdown.markdown(text,
+ ... ['wikilinks(base_url=/wiki/,end_url=.html)']
... )
The above would result in the following link for `[[WikiLink]]`.
<a href="/wiki/WikiLink.html" class="wikilink">WikiLink</a>
-If you want to do more that just alter the base and/or end of the URL, you
-could also pass in a callable which must accept three arguments (``label``,
+If you want to do more that just alter the base and/or end of the URL, you
+could also pass in a callable which must accept three arguments (``label``,
``base``, and ``end``). The callable must return the URL in it's entirety.
def my_url_builder(label, base, end):
@@ -91,15 +91,15 @@ could also pass in a callable which must accept three arguments (``label``,
return url
md = markdown.Markdown(
- extensions=['wikilinks],
+ extensions=['wikilinks'],
extension_configs={'wikilinks' : [('build_url', my_url_builder)]}
)
The option is also provided to change or remove the class attribute.
- >>> html = markdown.markdown(text,
- ... ['wikilink(html_class=myclass)']
+ >>> html = markdown.markdown(text,
+ ... ['wikilinks(html_class=myclass)']
... )
Would cause all wikilinks to be assigned to the class `myclass`.
@@ -108,14 +108,14 @@ Would cause all wikilinks to be assigned to the class `myclass`.
The same options can be used on the command line as well:
- python -m markdown -x wikilink(base_url=http://example.com/,end_url=.html,html_class=foo) src.txt
+ python -m markdown -x wikilinks(base_url=http://example.com/,end_url=.html,html_class=foo) src.txt
Some may prefer the more complex format when calling the `Markdown` class directly:
- >>> md = markdown.Markdown(
- ... extensions = ['wikilink'],
- ... extension_configs = {'wikilink': [
- ... ('base_url', 'http://example.com/'),
+ >>> md = markdown.Markdown(
+ ... extensions = ['wikilinks'],
+ ... extension_configs = {'wikilinks': [
+ ... ('base_url', 'http://example.com/'),
... ('end_url', '.html'),
... ('html_class', '') ]},
... safe_mode = True
@@ -126,7 +126,7 @@ Using with Meta-Data
--------------------
The WikiLink Extension also supports the [Meta-Data](meta_data.html) Extension.
-Please see the documentation for that extension for specifics. The supported
+Please see the documentation for that extension for specifics. The supported
meta-data keywords are:
* `wiki_base_url`
@@ -134,13 +134,13 @@ meta-data keywords are:
* `wiki_html_class`
When used, the meta-data will override the settings provided through the
-`extension_configs` interface.
+`extension_configs` interface.
This document:
wiki_base_url: http://example.com/
wiki_end_url: .html
- wiki_html_class:
+ wiki_html_class:
A [[WikiLink]] in the first paragraph.