r45407 - in /branches/upstream/libtext-multimarkdown-perl/current: ./ lib/Text/ t/ t/Text-MultiMarkdown.mdtest/ t/docs-multimarkdown-todo/

jawnsy-guest at users.alioth.debian.org jawnsy-guest at users.alioth.debian.org
Tue Oct 6 15:58:39 UTC 2009


Author: jawnsy-guest
Date: Tue Oct  6 15:58:34 2009
New Revision: 45407

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=45407
Log:
[svn-upgrade] Integrating new upstream version, libtext-multimarkdown-perl (1.0.29)

Added:
    branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.text
    branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.xhtml
Removed:
    branches/upstream/libtext-multimarkdown-perl/current/t/15inlinehtmldoenoturnoffmarkdown.t
    branches/upstream/libtext-multimarkdown-perl/current/t/Text-MultiMarkdown.mdtest/Citations.text
    branches/upstream/libtext-multimarkdown-perl/current/t/Text-MultiMarkdown.mdtest/Citations.xhtml
Modified:
    branches/upstream/libtext-multimarkdown-perl/current/Changes
    branches/upstream/libtext-multimarkdown-perl/current/MANIFEST
    branches/upstream/libtext-multimarkdown-perl/current/META.yml
    branches/upstream/libtext-multimarkdown-perl/current/Makefile.PL
    branches/upstream/libtext-multimarkdown-perl/current/README
    branches/upstream/libtext-multimarkdown-perl/current/Todo
    branches/upstream/libtext-multimarkdown-perl/current/lib/Text/MultiMarkdown.pm
    branches/upstream/libtext-multimarkdown-perl/current/t/03podspelling.t

Modified: branches/upstream/libtext-multimarkdown-perl/current/Changes
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/Changes?rev=45407&op=diff
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/Changes (original)
+++ branches/upstream/libtext-multimarkdown-perl/current/Changes Tue Oct  6 15:58:34 2009
@@ -216,3 +216,10 @@
         - Fix http://github.com/bobtfish/text-multimarkdown/issues#issue/5
           regression causing specialchars to not be unhashed in footnotes.
 
+1.0.28 2009-10-05T20:24:40
+        - Changes to be in line with latest Text::Markdown version 1.0.26
+        - Update README file and tie it to the code.
+
+1.0.29 2009-10-06T08:25:40
+        - Update dependency versions in Makefile.PL neglected last release.
+

Modified: branches/upstream/libtext-multimarkdown-perl/current/MANIFEST
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/MANIFEST?rev=45407&op=diff
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/MANIFEST (original)
+++ branches/upstream/libtext-multimarkdown-perl/current/MANIFEST Tue Oct  6 15:58:34 2009
@@ -31,7 +31,6 @@
 t/12empty_element_suffix.t
 t/13multimarkdown-nometadata-firstpara.t
 t/14unicode.t
-t/15inlinehtmldoenoturnoffmarkdown.t
 t/16headingsinlists.t
 t/17olulreportedonlist.t
 t/18codespanextra.t
@@ -164,6 +163,8 @@
 t/docs-maruku-unittest/xml_instruction.text
 t/docs-multimarkdown-todo/Amps_and_angle_encoding.html
 t/docs-multimarkdown-todo/Amps_and_angle_encoding.text
+t/docs-multimarkdown-todo/Citations.text
+t/docs-multimarkdown-todo/Citations.xhtml
 t/docs-multimarkdown-todo/Email_Obfuscation.html
 t/docs-multimarkdown-todo/Email_Obfuscation.text
 t/docs-multimarkdown-todo/Tidyness.html
@@ -294,8 +295,6 @@
 t/Text-MultiMarkdown.mdtest/Backslash_escapes.text
 t/Text-MultiMarkdown.mdtest/Blockquotes_with_code_blocks.html
 t/Text-MultiMarkdown.mdtest/Blockquotes_with_code_blocks.text
-t/Text-MultiMarkdown.mdtest/Citations.text
-t/Text-MultiMarkdown.mdtest/Citations.xhtml
 t/Text-MultiMarkdown.mdtest/complex_escaping.text
 t/Text-MultiMarkdown.mdtest/complex_escaping.xhtml
 t/Text-MultiMarkdown.mdtest/Cross-References.text

Modified: branches/upstream/libtext-multimarkdown-perl/current/META.yml
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/META.yml?rev=45407&op=diff
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/META.yml (original)
+++ branches/upstream/libtext-multimarkdown-perl/current/META.yml Tue Oct  6 15:58:34 2009
@@ -26,10 +26,10 @@
 requires:
   Digest::MD5: 0
   Encode: 0
-  Text::Markdown: 1.0.24
+  Text::Markdown: 1.0.26
   perl: 5.8.0
 resources:
   bugtracker: http://github.com/bobtfish/text-multimarkdown/issues
   license: http://opensource.org/licenses/bsd-license.php
   repository: http://github.com/bobtfish/text-multimarkdown/
-version: 1.0.27
+version: 1.0.29

Modified: branches/upstream/libtext-multimarkdown-perl/current/Makefile.PL
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/Makefile.PL?rev=45407&op=diff
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/Makefile.PL (original)
+++ branches/upstream/libtext-multimarkdown-perl/current/Makefile.PL Tue Oct  6 15:58:34 2009
@@ -12,7 +12,7 @@
 # Specific dependencies
 perl_version    '5.008';
 requires        'Digest::MD5'     => undef;
-requires        'Text::Markdown'  => '1.0.24';
+requires        'Text::Markdown'  => '1.0.26';
 requires        'Encode'          => undef;
 build_requires  'Test::More'      => '0.42';
 build_requires  'Test::Exception' => undef;
@@ -20,6 +20,11 @@
 build_requires  'File::Slurp'     => '9999.08';
 build_requires  'FindBin'         => undef;
 
+if ($Module::Install::AUTHOR) {
+    system("pod2text lib/Text/MultiMarkdown.pm > README")
+        and die $!;
+}
+
 # Scripts I install
 prompt_script('script/MultiMarkdown.pl');
 

Modified: branches/upstream/libtext-multimarkdown-perl/current/README
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/README?rev=45407&op=diff
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/README (original)
+++ branches/upstream/libtext-multimarkdown-perl/current/README Tue Oct  6 15:58:34 2009
@@ -1,24 +1,26 @@
 NAME
-    Text::Markdown - Convert Markdown syntax to (X)HTML
+    Text::MultiMarkdown - Convert MultiMarkdown syntax to (X)HTML
 
 SYNOPSIS
-        use Text::Markdown 'markdown';
+        use Text::MultiMarkdown 'markdown';
         my $html = markdown($text);
 
-        use Text::Markdown 'markdown';
+        use Text::MultiMarkdown 'markdown';
         my $html = markdown( $text, {
             empty_element_suffix => '>',
             tab_width => 2,
+            use_wikilinks => 1,
         } );
 
-        use Text::Markdown;
-        my $m = Text::Markdown->new;
+        use Text::MultiMarkdown;
+        my $m = Text::MultiMarkdown->new;
         my $html = $m->markdown($text);
 
-        use Text::Markdown;
+        use Text::MultiMarkdown;
         my $m = Text::MultiMarkdown->new(
             empty_element_suffix => '>',
             tab_width => 2,
+            use_wikilinks => 1,
         );
         my $html = $m->markdown( $text );
 
@@ -31,15 +33,36 @@
     Markdown's syntax is designed not as a generic markup language, but
     specifically to serve as a front-end to (X)HTML. You can use span-level
     HTML tags anywhere in a Markdown document, and you can use block level
-    HTML tags (like <div> and <table> as well).
+    HTML tags ("<div>", "<table>" etc.). Note that by default Markdown isn't
+    interpreted in HTML block-level elements, unless you add a "markdown=1""
+    attribute to the element. See Text::Markdown for details.
+
+    This module implements the MultiMarkdown markdown syntax extensions
+    from:
+
+        http://fletcherpenney.net/multimarkdown/
 
 SYNTAX
-    This module implements the 'original' Markdown markdown syntax from:
+    For more information about (original) Markdown's syntax, see:
 
         http://daringfireball.net/projects/markdown/
 
+    This module implements MultiMarkdown, which is an extension to
+    Markdown..
+
+    The extension is documented at:
+
+        http://fletcherpenney.net/multimarkdown/
+
+    and borrows from php-markdown, which lives at:
+
+        http://michelf.com/projects/php-markdown/extra/
+
+    This documentation is going to be moved/copied into this module for
+    clearer reading in a future release..
+
 OPTIONS
-    Text::Markdown supports a number of options to it's processor which
+    MultiMarkdown supports a number of options to it's processor which
     control the behaviour of the output document.
 
     These options can be supplied to the constructor, on in a hash with the
@@ -48,18 +71,85 @@
 
     The options for the processor are:
 
+    use_metadata
+        Controls the metadata options below.
+
+    strip_metadata
+        If true, any metadata in the input document is removed from the
+        output document (note - does not take effect in complete document
+        format).
+
     empty element suffix
         This option can be used to generate normal HTML output. By default,
         it is ' />', which is xHTML, change to '>' for normal HTML.
 
+    img_ids
+        Controls if <img> tags generated have an id attribute. Defaults to
+        true. Turn off for compatibility with the original markdown.
+
+    heading_ids
+        Controls if <hX> tags generated have an id attribute. Defaults to
+        true. Turn off for compatibility with the original markdown.
+
+    bibliography_title
+        The title of the generated bibliography, defaults to 'Bibliography'.
+
     tab_width
         Controls indent width in the generated markup, defaults to 4
 
-    markdown_in_html_blocks
-        Controls if Markdown is processed when inside HTML blocks. Defaults
-        to 0.
-
-METHODS
+    disable_tables
+        If true, this disables the MultiMarkdown table handling.
+
+    disable_footnotes
+        If true, this disables the MultiMarkdown footnotes handling.
+
+    disable_bibliography
+        If true, this disables the MultiMarkdown bibliography/citation
+        handling.
+
+    A number of possible items of metadata can also be supplied as options.
+    Note that if the use_metadata is true then the metadata in the document
+    will overwrite the settings on command line.
+
+    Metadata options supported are:
+
+    document_format
+    use_wikilinks
+    base_url
+
+METADATA
+    MultiMarkdown supports the concept of 'metadata', which allows you to
+    specify a number of formatting options within the document itself.
+    Metadata should be placed in the top few lines of a file, on value per
+    line as colon separated key/value pairs. The metadata should be
+    separated from the document with a blank line.
+
+    Most metadata keys are also supported as options to the constructor, or
+    options to the markdown method itself. (Note, as metadata, keys contain
+    space, whereas options the keys are underscore separated.)
+
+    You can attach arbitrary metadata to a document, which is output in HTML
+    <META> tags if unknown, see t/11document_format.t for more info.
+
+    A list of 'known' metadata keys, and their effects are listed below:
+
+    document format
+        If set to 'complete', MultiMarkdown will render an entire xHTML
+        page, otherwise it will render a document fragment
+
+        css Sets a CSS file for the file, if in 'complete' document format.
+
+        title
+            Sets the page title, if in 'complete' document format.
+
+    use wikilinks
+        If set to '1' or 'on', causes links that are WikiWords to
+        automatically be processed into links.
+
+    base url
+        This is the base URL for referencing wiki pages. In this is not
+        supplied, all wiki links are relative.
+
 METHODS
   new
     A simple constructor, see the SYNTAX and OPTIONS sections for more
@@ -69,52 +159,11 @@
     The main function as far as the outside world is concerned. See the
     SYNOPSIS for details on use.
 
-  urls
-    Returns a reference to a hash with the key being the markdown reference
-    and the value being the URL.
-
-    Useful for building scripts which preprocess a list of links before the
-    main content. See t/05options.t for an example of this hashref being
-    passed back into the markdown method to create links.
-
-OTHER IMPLEMENTATIONS
-    Markdown has been re-implemented in a number of languages, and with a
-    number of additions.
-
-    Those that I have found are listed below:
-
-    C - <http://www.pell.portland.or.us/~orc/Code/discount>
-        Discount - Original Markdown, but in C. Fastest implementation
-        available, and passes MDTest. Adds it's own set of custom features.
-
-    python - <http://www.freewisdom.org/projects/python-markdown/>
-        Python Markdown which is mostly compatible with the original, with
-        an interesting extension API.
-
-    ruby (maruku) - <http://maruku.rubyforge.org/>
-        One of the nicest implementations out there. Builds a parse tree
-        internally so very flexible.
-
-    php - <http://michelf.com/projects/php-markdown/>
-        A direct port of Markdown.pl, also has a separately maintained
-        'extra' version, which adds a number of features that were borrowed
-        by MultiMarkdown.
-
-    lua - <http://www.frykholm.se/files/markdown.lua>
-        Port to lua. Simple and lightweight (as lua is).
-
-    haskell - <http://johnmacfarlane.net/pandoc/>
-        Pandoc is a more general library, supporting Markdown,
-        reStructuredText, LaTeX and more.
-
-    javascript - <http://www.attacklab.net/showdown-gui.html>
-        Direct(ish) port of Markdown.pl to JavaScript
-
 BUGS
     To file bug reports or feature requests please send email to:
 
         bug-Text-Markdown at rt.cpan.org
-    
+
     Please include with your report: (1) the example input; (2) the output
     you expected; (3) the output Markdown actually produced.
 
@@ -133,23 +182,24 @@
 
         CPAN Module Text::MultiMarkdown (based on Text::Markdown by Sebastian
         Riedel) originally by Darren Kulp (http://kulp.ch/)
-    
+
         This module is maintained by: Tomas Doran http://www.bobtfish.net/
 
 THIS DISTRIBUTION
-    Please note that this distribution is a fork of John Gruber's original
-    Markdown project, and it *is not* in any way blessed by him.
-
-    Whilst this code aims to be compatible with the original Markdown.pl
-    (and incorporates and passes the Markdown test suite) whilst fixing a
-    number of bugs in the original - there may be differences between the
-    behaviour of this module and Markdown.pl. If you find any differences
-    where you believe Text::Markdown behaves contrary to the Markdown spec,
-    please report them as bugs.
-
-    Text::Markdown *does not* extend the markdown dialect in any way from
-    that which is documented at daringfireball. If you want additional
-    features, you should look at Text::MultiMarkdown.
+    Please note that this distribution is a fork of Fletcher Penny's
+    MultiMarkdown project, and it *is not* in any way blessed by him.
+
+    Whilst this code aims to be compatible with the original MultiMarkdown
+    (and incorporates and passes the MultiMarkdown test suite) whilst fixing
+    a number of bugs in the original - there may be differences between the
+    behaviour of this module and MultiMarkdown. If you find any differences
+    where you believe Text::MultiMarkdown behaves contrary to the
+    MultiMarkdown spec, please report them as bugs.
+
+SOURCE CODE
+    You can find the source code repository for Text::Markdown and
+    Text::MultiMarkdown on GitHub at
+    <http://github.com/bobtfish/text-markdown>.
 
 COPYRIGHT AND LICENSE
     Original Code Copyright (c) 2003-2004 John Gruber
@@ -158,7 +208,7 @@
     MultiMarkdown changes Copyright (c) 2005-2006 Fletcher T. Penney
     <http://fletcher.freeshell.org/> All rights reserved.
 
-    Text::MultiMarkdown changes Copyright (c) 2006-2008 Darren Kulp
+    Text::MultiMarkdown changes Copyright (c) 2006-2009 Darren Kulp
     <http://kulp.ch> and Tomas Doran <http://www.bobtfish.net>
 
     Redistribution and use in source and binary forms, with or without

Modified: branches/upstream/libtext-multimarkdown-perl/current/Todo
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/Todo?rev=45407&op=diff
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/Todo (original)
+++ branches/upstream/libtext-multimarkdown-perl/current/Todo Tue Oct  6 15:58:34 2009
@@ -1,6 +1,6 @@
 Todo pre 1.0.23:
     . Tests for $footnote =~ s/^glossary:\s*//i
-	. Tests for $footnote_closing_tag
+    . Tests for $footnote_closing_tag
     . Add an option to Text::Markdown to have original brand markdown style 
       emphasis within words support.
     . Re-merge Movable Type and Bloxom compatibility to the scripts, and add 
@@ -36,7 +36,9 @@
    . Make a Text::Markdown::Extra with the Markdown extra features?
      
 Todo pre 1.1:
-   . Build a parse tree when parsing (which can be returned), rather than just 
+   . Either remove Text::MultiMarkdown::_FixFootnoteParagraphs or add tests to
+     exercise it. Currently, removing it doesn't affect any test.
+   . Build a parse tree when parsing (which can be returned), rather than just
      using strings. This would make the output format much more flexible, and
      would remove a load of nasty hacks which escape, then un-escape things
      again whist processing..

Modified: branches/upstream/libtext-multimarkdown-perl/current/lib/Text/MultiMarkdown.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/lib/Text/MultiMarkdown.pm?rev=45407&op=diff
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/lib/Text/MultiMarkdown.pm (original)
+++ branches/upstream/libtext-multimarkdown-perl/current/lib/Text/MultiMarkdown.pm Tue Oct  6 15:58:34 2009
@@ -9,7 +9,7 @@
 use Carp        qw(croak);
 use base        qw(Text::Markdown);
 
-our $VERSION   = '1.0.27';
+our $VERSION   = '1.0.29';
 our @EXPORT_OK = qw(markdown);
 
 =head1 NAME
@@ -50,7 +50,10 @@
 Markdown's syntax is designed not as a generic markup language, but
 specifically to serve as a front-end to (X)HTML. You can use span-level
 HTML tags anywhere in a Markdown document, and you can use block level
-HTML tags (like <div> and <table> as well).
+HTML tags (C<< <div> >>, C<< <table> >> etc.). Note that by default
+Markdown isn't interpreted in HTML block-level elements, unless you add
+a C<markdown=1"> attribute to the element. See L<Text::Markdown> for 
+details.
 
 This module implements the MultiMarkdown markdown syntax extensions from:
 
@@ -114,10 +117,6 @@
 =item tab_width
 
 Controls indent width in the generated markup, defaults to 4
-
-=item markdown_in_html_blocks
-
-Controls if Markdown is processed when inside HTML blocks. Defaults to 0.
 
 =item disable_tables
 
@@ -218,9 +217,6 @@
     # For use with WikiWords and [[Wiki Links]]
     # NOTE: You can use \WikiWord to prevent a WikiWord from being treated as a link
     $p{use_wikilinks} = $p{use_wikilinks} ? 1 : 0;
-
-    # Is markdown processed in HTML blocks? See t/15inlinehtmldonotturnoffmarkdown.t
-    $p{markdown_in_html_blocks} = $p{markdown_in_html_blocks} ? 1 : 0;
 
     $p{heading_ids} = defined $p{heading_ids} ? $p{heading_ids} : 1;
     $p{img_ids}     = defined $p{img_ids}     ? $p{img_ids}     : 1;
@@ -297,14 +293,14 @@
     $text = $self->_ParseMetaData($text) if ($self->{use_metadata} || $self->{strip_metadata});
 
     # Turn block-level HTML blocks into hash entries
-    $text = $self->_HashHTMLBlocks($text) unless $self->{markdown_in_html_blocks};
+    $text = $self->_HashHTMLBlocks($text, {interpret_markdown_on_attribute => 1});
 
     $text = $self->_StripLinkDefinitions($text);
 
     # MMD only
     $text = $self->_StripMarkdownReferences($text);
 
-    $text = $self->_RunBlockGamut($text);
+    $text = $self->_RunBlockGamut($text, {wrap_in_p_tags => 1});
 
     # MMD Only
     $text = $self->_DoMarkdownCitations($text) unless $self->{disable_bibliography};
@@ -315,7 +311,7 @@
     # MMD Only
     # This must follow _UnescapeSpecialChars
     $text = $self->_UnescapeWikiWords($text);
-    $text = $self->_FixFootnoteParagraphs($text) unless $self->{disable_footnotes};
+    $text = $self->_FixFootnoteParagraphs($text) unless $self->{disable_footnotes};  # TODO: remove. Doesn't make any difference to test suite pass/failure
     $text .= $self->_PrintFootnotes() unless $self->{disable_footnotes};
     $text .= $self->_PrintMarkdownBibliography() unless $self->{disable_bibliography};
 
@@ -658,7 +654,7 @@
 
     # First, run routines that get skipped in footnotes
     foreach my $label (sort keys %{ $self->{_footnotes} }) {
-        my $footnote = $self->_RunBlockGamut($self->{_footnotes}{$label});
+        my $footnote = $self->_RunBlockGamut($self->{_footnotes}{$label}, {wrap_in_p_tags => 1});
         $footnote = $self->_UnescapeSpecialChars($footnote);
         $footnote = $self->_DoMarkdownCitations($footnote);
         $self->{_footnotes}{$label} = $footnote;
@@ -688,10 +684,11 @@
     return $text;
 }
 
+# TODO: remove. Doesn't make any difference to test suite pass/failure
 sub _FixFootnoteParagraphs {
     my ($self, $text) = @_;
 
-    $text =~ s/^\<p\>\<\/footnote\>/<\/footnote>/gm;
+    $text =~ s(^<p></footnote>)(</footnote>)gm;
 
     return $text;
 }
@@ -705,7 +702,7 @@
         $footnote_counter++;
         my $footnote = $self->{_footnotes}{$id};
 
-        $footnote =~ s/(\<\/(p(re)?|ol|ul)\>)$//;
+        $footnote =~ s/(<\/(p(re)?|ol|ul)>)$//;
         my $footnote_closing_tag = $1;
         $footnote_closing_tag = '' if !defined $footnote_closing_tag;
 
@@ -1131,11 +1128,7 @@
 
         $reference =~ s/^[ ]{0,$self->{tab_width}}//gm;
 
-        $reference = $self->_RunBlockGamut($reference);
-
-        # strip leading and trailing <p> tags (they will be added later)
-        $reference =~ s/^\<p\>//s;
-        $reference =~ s/\<\/p\>\s*$//s;
+        $reference = $self->_RunBlockGamut($reference, {wrap_in_p_tags => 0});
 
         $self->{_references}{$id} = $reference;
     }

Modified: branches/upstream/libtext-multimarkdown-perl/current/t/03podspelling.t
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/t/03podspelling.t?rev=45407&op=diff
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/t/03podspelling.t (original)
+++ branches/upstream/libtext-multimarkdown-perl/current/t/03podspelling.t Tue Oct  6 15:58:34 2009
@@ -48,4 +48,6 @@
 html
 shortversion
 quux
+GitHub
+Redistributions
 

Added: branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.text
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.text?rev=45407&op=file
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.text (added)
+++ branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.text Tue Oct  6 15:58:34 2009
@@ -1,0 +1,32 @@
+
+Handle MultiMarkdown-style citations.
+
+
+This is a borrowed idea[p. 23][#Doe:1996].
+
+> This is a cited blockquote without a page reference.[][#Smith:2005].
+
+And a plain paragraph.
+
+
+And a code block that is not a citation:
+
+	This is not a citation[p. 5][#Doe:1996].
+
+
+And a work by Johnson that is not cited, but should be included in bibliography:
+[Not cited][#Johnson:1996]
+
+And multiple citations.[p. 3][#Doe:1996][p. 10][#Smith:2005]
+
+How about a citation within a footnote? [^footcite]
+
+[#Smith:2005]:	James Smith. Some interesting paper. *Some Journal*, 1(2): 101-123, 2005.
+
+[#Doe:1996]:	John Doe. *Some Book*. Blog Books, 1996.
+
+[#Johnson:1996]:	Bill Johnson. *Some Book*. Blog Books, 1996.
+
+[#James:1996]:	John James. *Some Book*. Blog Books, 1996.
+
+[^footcite]: As described previously. [p. 12][#Smith:2005]

Added: branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.xhtml
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.xhtml?rev=45407&op=file
==============================================================================
--- branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.xhtml (added)
+++ branches/upstream/libtext-multimarkdown-perl/current/t/docs-multimarkdown-todo/Citations.xhtml Tue Oct  6 15:58:34 2009
@@ -1,0 +1,42 @@
+<p>Handle MultiMarkdown-style citations.</p>
+
+<p>This is a borrowed idea<span class="markdowncitation"> (<a href="#Doe:1996">1</a>, <span class="locator">p. 23</span>)</span>.</p>
+
+<blockquote>
+  <p>This is a cited blockquote without a page reference.<span class="markdowncitation"> (<a href="#Smith:2005">2</a>)</span>.</p>
+</blockquote>
+
+<p>And a plain paragraph.</p>
+
+<p>And a code block that is not a citation:</p>
+
+<pre><code>This is not a citation[p. 5][#Doe:1996].
+</code></pre>
+
+<p>And a work by Johnson that is not cited, but should be included in bibliography:
+<span class="notcited" id="Johnson:1996"/></p>
+
+<p>And multiple citations.<span class="markdowncitation"> (<a href="#Doe:1996">1</a>, <span class="locator">p. 3</span>)</span><span class="markdowncitation"> (<a href="#Smith:2005">2</a>, <span class="locator">p. 10</span>)</span></p>
+
+<p>How about a citation within a footnote? <a href="#fn:footcite" id="fnref:footcite" class="footnote">1</a></p>
+
+<div class="footnotes">
+<hr />
+<ol>
+
+<li id="fn:footcite"><p>As described previously. <span class="markdowncitation"> (<a href="#Smith:2005">2</a>, <span class="locator">p. 12</span>)</span><a href="#fnref:footcite" class="reversefootnote">&#160;&#8617;</a></p></li>
+
+</ol>
+</div>
+
+<div class="bibliography">
+<hr />
+<p>Bibliography</p>
+
+<div id="Doe:1996"><p>[1] <span class="item">John Doe. <em>Some Book</em>. Blog Books, 1996.</span></p></div>
+
+<div id="Smith:2005"><p>[2] <span class="item">James Smith. Some interesting paper. <em>Some Journal</em>, 1(2): 101-123, 2005.</span></p></div>
+
+<div id="Johnson:1996"><p>[3] <span class="item">Bill Johnson. <em>Some Book</em>. Blog Books, 1996.</span></p></div>
+
+</div>




More information about the Pkg-perl-cvs-commits mailing list