diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/README | 80 | ||||
| -rw-r--r-- | docs/README.html | 97 |
2 files changed, 15 insertions, 162 deletions
diff --git a/docs/README b/docs/README index b859924..d19a1ea 100644 --- a/docs/README +++ b/docs/README @@ -13,46 +13,12 @@ supported by the [Available Extensions][]. [Available Extensions]: http://www.freewisdom.org/projects/python-markdown/Available_Extensions -Installation ------------- +Documentation +------------- -To install Python Markdown [download][] the zip file and extract the -files. If you want to install markdown as a module into your python -tree, run `sudo python setup.py install` from a directory where you -unzip the files. - -[download]: http://sourceforge.net/project/showfiles.php?group_id=153041 - - -Command Line Usage ------------------- - -To use markdown.py from the command line, run it as - - python markdown.py <input_file> - -or - - python markdown.py <input_file> > <output_file> - -For more details, use the `-h` or `--help` options from the command line -or read the [Command Line Docs][] available online. - -[Command Line Docs]: http://www.freewisdom.org/projects/python-markdown/Command_Line - - - -Using as a Python Module ------------------------- - -To use markdown as a module: - - import markdown - html = markdown.markdown(your_text_string) - -For more details see the [Module Docs][]. - -[Module Docs]: http://www.freewisdom.org/projects/python-markdown/Using_as_a_Module +Installation and usage documentation is available in the `docs/` directory +of the distribution and on the project website at +<http://freewisdom.org/projects/python-markdown>. Support ------- @@ -60,39 +26,5 @@ Support You may ask for help and discuss various other issues on the [mailing list][] and report bugs on the [bug tracker][]. [mailing list]: http://lists.sourceforge.net/lists/listinfo/python-markdown-discuss -[bug tracker]: http://sourceforge.net/tracker/?func=add&group_id=153041&atid=790198 - - -Credits -------- - -* Most of the code currently in the module was written by [Yuri Takhteyev][] - while procrastinating from his Ph.D. -* The original version of this script was written by [Manfred Stienstra][], - who is responsible for about a quarter of the code. -* Many recent bugs are being fixed by [Waylan Limberg][]. - -Other contributions: - -* Daniel Krech provided the setup.py script. -* G. Clark Haynes submitted a patch for indented lists. -* Tiago Cogumbreiro submitted an email autolink fix. -* Sergej Chodarev submitted a patch for treatment of `<hr/>` tags. -* Chris Clark submitted a patch to handle `<mailto:...>` syntax and a reg ex - for "smart" emphasis (ignoring underscores within a word). -* Steward Midwinter wrote command-line parser and cleaned up comments. -* Many other people helped by reporting bugs. - -[Yuri Takhteyev]: http://www.freewisdom.org -[Manfred Stienstra]: http://www.dwerg.net/ -[Waylan Limberg]: http://achinghead.com/ - - -License -------- - -The code is dual-licensed under [GPL][] and [BSD License][]. Other -licensing arrangements can be discussed. +[bug tracker]: http://www.freewisdom.org/projects/python-markdown/Tickets -[GPL]: http://www.gnu.org/copyleft/gpl.html) -[BSD License]: http://www.opensource.org/licenses/bsd-license.php diff --git a/docs/README.html b/docs/README.html index 6d94e8e..49e3b07 100644 --- a/docs/README.html +++ b/docs/README.html @@ -1,91 +1,12 @@ <h1><a href="http://freewisdom.org/projects/python-markdown">Python-Markdown</a></h1> <p>This is a Python implementation of John Gruber's <a href="http://daringfireball.net/projects/markdown/">Markdown</a>. - It is almost completely compliant with the reference implementation, - though there are a few known issues. See <a href="http://www.freewisdom.org/projects/python-markdown/Features">Features</a> for information - on what exactly is supported and what is not. Additional features are - supported by the <a href="http://www.freewisdom.org/projects/python-markdown/Available_Extensions">Available Extensions</a>. -</p> - -<h2>Installation</h2> -<p>To install Python Markdown <a href="http://sourceforge.net/project/showfiles.php?group_id=153041">download</a> the zip file and extract the - files. If you want to install markdown as a module into your python - tree, run <code>sudo python setup.py install</code> from a directory where you - unzip the files. -</p> - -<h2>Command Line Usage</h2> -<p>To use markdown.py from the command line, run it as -</p> -<pre><code>python markdown.py <input_file> -</code></pre><p>or -</p> -<pre><code>python markdown.py <input_file> > <output_file> -</code></pre><p>For more details, use the <code>-h</code> or <code>--help</code> options from the command line - or read the <a href="http://www.freewisdom.org/projects/python-markdown/Command_Line">Command Line Docs</a> available online. -</p> - -<h2>Using as a Python Module</h2> -<p>To use markdown as a module: -</p> -<pre><code>import markdown -html = markdown.markdown(your_text_string) -</code></pre><p>For more details see the <a href="http://www.freewisdom.org/projects/python-markdown/Using_as_a_Module">Module Docs</a>. -</p> - +It is almost completely compliant with the reference implementation, +though there are a few known issues. See <a href="http://www.freewisdom.org/projects/python-markdown/Features">Features</a> for information +on what exactly is supported and what is not. Additional features are +supported by the <a href="http://www.freewisdom.org/projects/python-markdown/Available_Extensions">Available Extensions</a>.</p> +<h2>Documentation</h2> +<p>Installation and usage documentation is available in the <code>docs/</code> directory +of the distribution and on the project website at +<a href="http://freewisdom.org/projects/python-markdown">http://freewisdom.org/projects/python-markdown</a>.</p> <h2>Support</h2> -<p>You may ask for help and discuss various other issues on the <a href="http://lists.sourceforge.net/lists/listinfo/python-markdown-discuss">mailing list</a> and report bugs on the <a href="http://sourceforge.net/tracker/?func=add&group_id=153041&atid=790198">bug tracker</a>. -</p> - -<h2>Credits</h2> -<ul> - <li> - Most of the code currently in the module was written by <a href="http://www.freewisdom.org">Yuri Takhteyev</a> - while procrastinating from his Ph.D. - </li> - - <li> - The original version of this script was written by <a href="http://www.dwerg.net/">Manfred Stienstra</a>, - who is responsible for about a quarter of the code. - </li> - - <li> - Many recent bugs are being fixed by <a href="http://achinghead.com/">Waylan Limberg</a>. - </li> -</ul> -<p>Other contributions: -</p> -<ul> - <li> - Daniel Krech provided the setup.py script. - </li> - - <li> - G. Clark Haynes submitted a patch for indented lists. - </li> - - <li> - Tiago Cogumbreiro submitted an email autolink fix. - </li> - - <li> - Sergej Chodarev submitted a patch for treatment of <code><hr/></code> tags. - </li> - - <li> - Chris Clark submitted a patch to handle <code><mailto:...></code> syntax and a reg ex - for "smart" emphasis (ignoring underscores within a word). - </li> - - <li> - Steward Midwinter wrote command-line parser and cleaned up comments. - </li> - - <li> - Many other people helped by reporting bugs. - </li> -</ul> - -<h2>License</h2> -<p>The code is dual-licensed under <a href="http://www.gnu.org/copyleft/gpl.html)">GPL</a> and <a href="http://www.opensource.org/licenses/bsd-license.php">BSD License</a>. Other - licensing arrangements can be discussed. -</p>
\ No newline at end of file +<p>You may ask for help and discuss various other issues on the <a href="http://lists.sourceforge.net/lists/listinfo/python-markdown-discuss">mailing list</a> and report bugs on the <a href="http://www.freewisdom.org/projects/python-markdown/Tickets">bug tracker</a>.</p>
\ No newline at end of file |