kramdown 0.12.0 → 0.13.1

data/CONTRIBUTERS

@@ -1,5 +1,6 @@
   Count Name
 ======= ====
-    427 Thomas Leitner <t_leitner@gmx.at>
+    451 Thomas Leitner <t_leitner@gmx.at>
       3 Ben Armston <ben.armston@googlemail.com>
       3 Alex Marandon <contact@alexmarandon.com>
+      1 Damien Pollet <damien.pollet@gmail.com>

data/ChangeLog

@@ -1,3 +1,281 @@
+commit 8d2618b7ca8871043dfc2d99a3a34a82cad53ab4
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sat Jan 22 08:44:45 2011 +0100
+
+    Updated version to 0.13.1 after bad push to Rubygems
+
+doc/index.page
+doc/news/release_0_13_0.page
+doc/news/release_0_13_1.page
+lib/kramdown/version.rb
+
+commit 0d077806da1ff2bc7de767392c5df48610a744c9
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sat Jan 22 08:36:35 2011 +0100
+
+    Updated test graphs
+
+doc/img/graph-jruby-1.5.3-249.png
+doc/img/graph-ruby-1.8.5-231.png
+doc/img/graph-ruby-1.8.6-399.png
+doc/img/graph-ruby-1.8.7-249.png
+doc/img/graph-ruby-1.8.7-302.png
+doc/img/graph-ruby-1.9.2p0-0.png
+doc/img/graph-ruby-1.9.2p136-136.png
+doc/tests.page
+
+commit 301446b945eab51498271da03b3b4b135bca514d
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sat Jan 22 08:35:36 2011 +0100
+
+    Minor benchmark script enhancement
+    
+    One can now provide a nicer name for the master version
+
+benchmark/benchmark.sh
+
+commit 24946119e95ce14654ee9de62e44217e251c2e40
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sat Jan 22 08:06:56 2011 +0100
+
+    Fixed problem when running on Ruby 1.8.6
+
+lib/kramdown/parser/html.rb
+
+commit a8f4051f20cfdf6f7ebc0cc6b71abb93d30ed2d1
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sat Jan 22 07:54:02 2011 +0100
+
+    Updated homepage for release
+
+doc/index.page
+doc/news/release_0_13_0.page
+
+commit c86b42ca9f43796c75d7ef9654e21456e56dbb74
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sat Jan 22 07:53:25 2011 +0100
+
+    Updated documentation
+
+doc/documentation.page
+doc/index.page
+doc/installation.page
+
+commit e9dcf1d940cc4e717a314e5b265da87df8ac8c02
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Wed Jan 19 09:20:36 2011 +0100
+
+    Any character except a closing bracket is now valid inside a link identifier
+
+doc/news/release_0_13_0.page
+doc/syntax.page
+lib/kramdown/parser/kramdown.rb
+lib/kramdown/parser/kramdown/link.rb
+test/testcases/span/01_link/reference.html
+test/testcases/span/01_link/reference.html.19
+test/testcases/span/01_link/reference.text
+
+commit b62c176252d13eacb3d1eafa02449aa125c30782
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Wed Jan 19 08:25:42 2011 +0100
+
+    New option smart_quotes for customizing smart quotes output
+    
+    This is needed because quotation marks are not the same in every
+    language.
+
+doc/converter/html.page
+doc/converter/latex.page
+doc/news/release_0_13_0.page
+lib/kramdown/converter/base.rb
+lib/kramdown/converter/html.rb
+lib/kramdown/converter/latex.rb
+lib/kramdown/options.rb
+
+commit edbd1fdfec7a6bb7fdcaddac52b4db09aa3b081f
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Jan 18 17:24:27 2011 +0100
+
+    Three fixes regarding entities in LaTeX converter
+    
+    - Fixed unnecessary string creation while constructing converstion table
+    - Added helper method for converting an entity to LaTeX
+    - Removed unnecessary braces from two entity definitions
+
+lib/kramdown/converter/latex.rb
+
+commit fdc8360159f671502298af27c70f8bb3213e0f30
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Jan 18 16:37:35 2011 +0100
+
+    HTML tables are now only converted to natives ones if all rows have the same number of columns
+
+doc/news/release_0_13_0.page
+lib/kramdown/parser/html.rb
+
+commit 1d9ae8ae4beaa9300d16879e7d328debdbc4922f
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Tue Jan 18 16:30:13 2011 +0100
+
+    Now also using <col/> tags when converting HTML tables to native ones
+
+doc/news/release_0_13_0.page
+lib/kramdown/parser/html.rb
+
+commit f9f7716bec6c938e058212dc9ee2edd478cf860a
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Mon Jan 17 18:39:53 2011 +0100
+
+    Updated Rakefile so that the rdoc task documents the available options
+    
+    The RDoc::RDoc#parse_files method is overridden so that the available
+    options are automatically added to the description of the
+    Kramdown::Options module.
+
+README
+Rakefile
+
+commit 8a8b71f39bd8d966db94ee73f8e9743c8b510c64
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Mon Jan 17 17:48:26 2011 +0100
+
+    LaTeX converter now outputs \hypertarget for all elements with an ID
+
+doc/converter/latex.page
+doc/news/release_0_13_0.page
+lib/kramdown/converter/latex.rb
+
+commit 0a8171eefe35a195fbce8f06a6a1dbfad2dda459
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Mon Jan 17 09:47:01 2011 +0100
+
+    Fixed bug in converting <em>/<strong> tags to native elements
+    
+    The tags may not be converted to native tags if the inner text begins
+    or ends with whitespace because that would result in invalid output
+    using the kramdown converter.
+
+doc/news/release_0_13_0.page
+lib/kramdown/parser/html.rb
+test/testcases/block/09_html/html_to_native/emphasis.html
+test/testcases/block/09_html/html_to_native/emphasis.text
+
+commit 927c39d0d486a9017a501eadbbcd8c7f6ee4f95b
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Mon Jan 17 09:25:04 2011 +0100
+
+    Fixed parsing of table rows with <code> elements
+    
+    As it is done with the native code span syntax, pipes inside HTML code
+    tags are not used as cell separators anymore.
+
+doc/news/release_0_13_0.page
+doc/syntax.page
+lib/kramdown/parser/kramdown/table.rb
+test/testcases/block/14_table/simple.html
+test/testcases/block/14_table/simple.html.19
+test/testcases/block/14_table/simple.text
+
+commit 161c7fb8c6738f2887190f873db704f95ffe25b1
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sun Jan 16 18:43:06 2011 +0100
+
+    Fixed bug RF#28769: span extension in list item wrongly triggered list item IAL parser
+
+doc/news/release_0_13_0.page
+lib/kramdown/parser/kramdown/list.rb
+test/testcases/block/08_list/item_ial.html
+test/testcases/block/08_list/item_ial.text
+
+commit eaabeb86c29145c9984cf725743ce3e0c9862dc4
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sun Jan 16 16:42:04 2011 +0100
+
+    Documented how one can use a reference style link and text that together look like a link definition line
+
+doc/syntax.page
+
+commit fb55e6af273f9c10412511e8a10e96d7b44cd7b5
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sun Jan 16 16:25:07 2011 +0100
+
+    Removed deprecated option toc_depth
+
+doc/news/release_0_13_0.page
+lib/kramdown/converter/base.rb
+lib/kramdown/options.rb
+
+commit bfbae6cd6b9d7572ae52bce29150d0e304c8c5d3
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sun Jan 16 16:19:41 2011 +0100
+
+    Fixed bug RF#28785: Used false name for default template in doc for template option
+
+doc/news/release_0_13_0.page
+lib/kramdown/options.rb
+
+commit bf4bc2dd36a83d03ab2e409b81343b4e280ffcfe
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sun Jan 16 16:11:19 2011 +0100
+
+    Fixed bug RF#28809: empty <a> tags were output as self-closed tags
+
+doc/news/release_0_13_0.page
+lib/kramdown/converter/html.rb
+test/testcases/span/05_html/normal.html
+test/testcases/span/05_html/normal.text
+
+commit 0a3fcd72aaffc2b352268b387192c74329614253
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sun Jan 16 15:58:04 2011 +0100
+
+    Fixed bug where block HTML line was recognized as table line
+    
+    Block HTML blocks have a higher priority now than tables.
+
+doc/news/release_0_13_0.page
+lib/kramdown/parser/kramdown.rb
+test/testcases/block/09_html/parse_as_raw.html
+test/testcases/block/09_html/parse_as_raw.text
+
+commit 95d45c10cdd4b7044469cf85efd8c5d54bbba4fe
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Sun Jan 16 15:40:55 2011 +0100
+
+    Updated release notes
+
+doc/news/release_0_13_0.page
+
+commit 3a2504b2225edfdb519e66adf0ce15eb11239ce8
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Wed Nov 24 07:30:54 2010 +0100
+
+    Fixed raised error when parsing unknown named entities
+
+doc/news/release_0_13_0.page
+lib/kramdown/parser/html.rb
+lib/kramdown/parser/kramdown/html_entity.rb
+test/testcases/span/text_substitutions/entities.html
+test/testcases/span/text_substitutions/entities.text
+
+commit 9df6c7a9ffbeba67b72d7b39e3c31c588750f553
+Author: Thomas Leitner <t_leitner@gmx.at>
+Date:   Wed Nov 24 07:28:55 2010 +0100
+
+    Added release notes file and bumped version number
+
+doc/news/release_0_13_0.page
+lib/kramdown/version.rb
+
+commit 0bf12222397a8b1042f6659d032a0da686f1fc9f
+Author: Damien Pollet <damien.pollet@gmail.com>
+Date:   Fri Nov 5 00:15:07 2010 +0100
+
+    Entity definitions for thin, half-em, and em-spaces
+
+lib/kramdown/converter/latex.rb
+lib/kramdown/utils/entities.rb
+
 commit 7ac86c467418389f63844c16783157268351f192
 Author: Thomas Leitner <t_leitner@gmx.at>
 Date:   Mon Nov 1 09:55:09 2010 +0100

data/README

@@ -25,6 +25,9 @@ kramdown has a basic *Cloth API, so using kramdown is as easy as
 
 For detailed information have a look at the API documentation of the Kramdown::Document class.
 
+The full API documentation is available at http://kramdown.rubyforge.org/rdoc/, other sites with an
+API documentation for kramdown probably don't provide the complete documentation!
+
 
 == Development
 

data/Rakefile

@@ -18,6 +18,30 @@ begin
   gem 'rdoc' if RUBY_VERSION >= '1.9'
   require 'rdoc/task'
   require 'rdoc/rdoc'
+
+  class RDoc::RDoc
+
+    alias :old_parse_files :parse_files
+
+    def parse_files(options)
+      file_info = old_parse_files(options)
+      require 'kramdown/options'
+
+      # Add options documentation to Kramdown::Options module
+      opt_module = RDoc::TopLevel.all_classes_and_modules.find {|m| m.full_name == 'Kramdown::Options'}
+      opt_defs = Kramdown::Options.definitions.sort.collect do |n, definition|
+        desc = definition.desc.split(/\n/).map {|l| "    #{l}"}
+        desc[-2] = []
+        desc = desc.join("\n")
+        "[<tt>#{n}</tt> (type: #{definition.type}, default: #{definition.default.inspect})]\n#{desc}\n\n"
+      end
+      opt_module.comment << "\n== Available Options\n\n" << opt_defs.join("\n\n")
+
+      file_info
+    end
+
+  end
+
 rescue LoadError
 end
 

data/VERSION

@@ -1 +1 @@
-0.12.0
+0.13.1

data/benchmark/benchmark.sh

@@ -5,8 +5,9 @@ source ~/.bashrc
 RUBY_VERSIONS=`rvm list strings | sort`
 KD_VERSIONS="`git tag | sort -V` master"
 OTHERS=false
+MASTER_AS=
 
-while getopts "r:k:o" optname; do
+while getopts "r:k:o:m:" optname; do
     case "$optname" in
         "r")
             RUBY_VERSIONS="$OPTARG"
@@ -16,6 +17,9 @@ while getopts "r:k:o" optname; do
             ;;
         "o")
             OTHERS=true
+	    ;;
+	"m")
+	    MASTER_AS="$OPTARG"
             ;;
         "?")
             echo "Unknown option $OPTARG"
@@ -48,7 +52,12 @@ for RUBY_VERSION in $RUBY_VERSIONS; do
     for KD_VERSION in $KD_VERSIONS; do
         echo "Using kramdown version $KD_VERSION"
         git co $KD_VERSION 2>/dev/null
-        ruby -I${TMPDIR}/kramdown/lib ../generate_data.rb -k ${KD_VERSION} >/dev/null
+        if [ -z $MASTER_AS -o $KD_VERSION != master ]; then
+            VNUM=${KD_VERSION}
+        else
+            VNUM=$MASTER_AS
+        fi
+        ruby -I${TMPDIR}/kramdown/lib ../generate_data.rb -k ${VNUM} >/dev/null
     done
 
     if [ $OTHERS = "true" ]; then

data/doc/documentation.page

@@ -53,9 +53,8 @@ The kramdown package provides two ways for using it:
 * **As an application**
 
   Together with the library files a binary called `kramdown` is shipped which can be used to convert
-  text in any supported format (currently only kramdown syntax) to any supported output format (e.g.
-  HTML or LaTeX). It either reads from the files specified as the command line arguments or from the
-  standard input. For example:
+  text in any supported input format to any supported output format. It either reads from the files
+  specified as the command line arguments or from the standard input. For example:
 
       kramdown path/to/kramdown/doc/syntax.page
 

data/doc/index.page

@@ -8,8 +8,8 @@ sort_info: 1
 If you want to get started with kramdown, have a look at the [installation page](installation.html)
 to see how you can install it on your system. Then look through the
 [documentation](documentation.html) for finding information about how to actually use kramdown and
-its parsers/converters. The [syntax](syntax.html) provides a detailed description of the superset of
-Markdown which kramdown supports.
+its parsers/converters. The [syntax page](syntax.html) provides a detailed description of the
+superset of Markdown which kramdown supports.
 
 {tikz:: path: overview.png
 img_attr: {style: 'background:transparent'}
@@ -86,11 +86,11 @@ Markdown implementations because kramdown borrowed many ideas from existing pack
 completely written in Ruby, supports standard Markdown (with some minor modifications) and various
 extensions that have been made popular by the [PHP Markdown Extra] package and [Maruku].
 
-It is probably the fastest pure-Ruby Markdown converter available (November 2010), being about 4x
+It is probably the fastest pure-Ruby Markdown converter available (January 2011), being about 4x
 faster than [Maruku] and about 5x faster than [BlueFeather].
 
 <p class="a-center">
-The latest version of kramdown is <b>0.12.0</b> and it was released on <b>2010-11-01</b>.
+The latest version of kramdown is <b>0.13.1</b> and it was released on <b>2011-01-22</b>.
 </p>
 
 [PHP Markdown Extra]: http://michelf.com/projects/php-markdown/extra/

data/doc/installation.page

@@ -5,6 +5,12 @@ sort_info: 5
 ---
 # Download & Installation
 
+## Dependencies
+
+Since kramdown is written in Ruby, you just need the [Ruby interpreter](http://www.ruby-lang.org),
+version 1.8.5, 1.8.6, 1.8.7 or 1.9.2. There are no other dependencies.
+
+
 ## Compatibility Notes
 
 kramdown should work on any platform which supports Ruby. It has been successfully tested on the
@@ -42,14 +48,13 @@ as running:
 
 ### Windows
 
-You need to install Ruby first. This can easily be done by using the One-Click-Installer - just
-download the *latest* installation binary from the [files section][1] of the One-Click-Installer
-homepage and run it. After that open a command shell (select `Start -> Run...`, then enter `cmd` and
-click on `Ok`) and type in the following:
+You need to install Ruby first. This can easily be done by using the [RubyInstaller] - just download
+the installation binary and run it. After that open a command shell (select `Start -> Run...`, then
+enter `cmd` and click on `Ok`) and type in the following:
 
     gem install kramdown
 
-[1]: http://rubyforge.org/frs/?group_id=167
+[RubyInstaller]: http://rubyinstaller.org
 
 
 ## Generic Installation Instructions
@@ -81,9 +86,3 @@ repository always contains a clean state of the current development version of k
 out kramdown use the following command:
 
      git clone git://github.com/gettalong/kramdown.git
-
-
-## Dependencies
-
-Since kramdown is written in Ruby, you just need the [Ruby interpreter](http://www.ruby-lang.org)
-versions 1.8.5, 1.8.6, 1.8.7 or 1.9.2. There are no other dependencies.