moredown 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/COPYING +52 -0
- data/README.markdown +109 -0
- data/Rakefile +121 -0
- data/VERSION +1 -0
- data/bin/rdiscount +5 -0
- data/ext/Csio.c +49 -0
- data/ext/amalloc.h +29 -0
- data/ext/config.h +9 -0
- data/ext/cstring.h +73 -0
- data/ext/docheader.c +43 -0
- data/ext/dumptree.c +147 -0
- data/ext/extconf.rb +8 -0
- data/ext/generate.c +1389 -0
- data/ext/markdown.c +962 -0
- data/ext/markdown.h +135 -0
- data/ext/mkdio.c +241 -0
- data/ext/mkdio.h +66 -0
- data/ext/rdiscount.c +92 -0
- data/ext/resource.c +169 -0
- data/ext/toc.c +86 -0
- data/lib/markdown.rb +1 -0
- data/lib/moredown.rb +153 -0
- data/lib/rdiscount.rb +72 -0
- data/moredown.gemspec +73 -0
- data/test/benchmark.rb +56 -0
- data/test/benchmark.txt +306 -0
- data/test/markdown_test.rb +119 -0
- data/test/moredown_test.rb +172 -0
- data/test/rdiscount_test.rb +43 -0
- metadata +88 -0
data/COPYING
ADDED
@@ -0,0 +1,52 @@
|
|
1
|
+
The core Discount C sources are
|
2
|
+
Copyright (C) 2007 David Loren Parsons.
|
3
|
+
|
4
|
+
The Discount Ruby extension sources are
|
5
|
+
Copyright (C) 2008 Ryan Tomayko.
|
6
|
+
|
7
|
+
All rights reserved.
|
8
|
+
|
9
|
+
Permission is hereby granted, free of charge, to any person
|
10
|
+
obtaining a copy of this software and associated documentation files
|
11
|
+
(the "Software"), to deal in the Software without restriction,
|
12
|
+
including without limitation the rights to use, copy, modify, merge,
|
13
|
+
publish, distribute, sublicence, and/or sell copies of the Software,
|
14
|
+
and to permit persons to whom the Software is furnished to do so,
|
15
|
+
subject to the following conditions:
|
16
|
+
|
17
|
+
1. Redistributions of source code must retain the above copyright
|
18
|
+
notice, this list of conditions, and the following disclaimer.
|
19
|
+
|
20
|
+
2. Redistributions in binary form must reproduce the above
|
21
|
+
copyright notice, this list of conditions and the following
|
22
|
+
disclaimer in the documentation and/or other materials provided
|
23
|
+
with the distribution, and in the same place and form as other
|
24
|
+
copyright, license and disclaimer information.
|
25
|
+
|
26
|
+
3. The end-user documentation included with the redistribution, if
|
27
|
+
any, must include the following acknowledgment:
|
28
|
+
|
29
|
+
This product includes software developed by
|
30
|
+
David Loren Parsons <http://www.pell.portland.or.us/~orc>
|
31
|
+
|
32
|
+
in the same place and form as other third-party acknowledgments.
|
33
|
+
Alternately, this acknowledgment may appear in the software
|
34
|
+
itself, in the same form and location as other such third-party
|
35
|
+
acknowledgments.
|
36
|
+
|
37
|
+
4. Except as contained in this notice, the name of David Loren
|
38
|
+
Parsons shall not be used in advertising or otherwise to promote
|
39
|
+
the sale, use or other dealings in this Software without prior
|
40
|
+
written authorization from David Loren Parsons.
|
41
|
+
|
42
|
+
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
|
43
|
+
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
44
|
+
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
45
|
+
IN NO EVENT SHALL DAVID LOREN PARSONS BE LIABLE FOR ANY DIRECT,
|
46
|
+
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
47
|
+
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
48
|
+
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
49
|
+
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
50
|
+
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
51
|
+
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
|
52
|
+
OF THE POSSIBILITY OF SUCH DAMAGE.
|
data/README.markdown
ADDED
@@ -0,0 +1,109 @@
|
|
1
|
+
Discount Markdown Processor for Ruby (with some extras)
|
2
|
+
=======================================================
|
3
|
+
|
4
|
+
Discount is an implementation of John Gruber's Markdown markup language in C. It
|
5
|
+
implements all of the language described in [the markdown syntax document][1] and
|
6
|
+
passes the [Markdown 1.0 test suite][2].
|
7
|
+
|
8
|
+
Discount was developed by [David Loren Parsons][3]. The Ruby extension was
|
9
|
+
developed by [Ryan Tomayko][4] and extended by [Nathan Hoad][5].
|
10
|
+
|
11
|
+
[1]: http://daringfireball.net/projects/markdown/syntax
|
12
|
+
[2]: http://daringfireball.net/projects/downloads/MarkdownTest_1.0.zip
|
13
|
+
[3]: http://www.pell.portland.or.us/~orc
|
14
|
+
[4]: http://tomayko.com/
|
15
|
+
[5]: http://nathanhoad.net/
|
16
|
+
|
17
|
+
Installation, Hacking
|
18
|
+
---------------------
|
19
|
+
|
20
|
+
The Moredown gem can be installed from Github:
|
21
|
+
|
22
|
+
$ gem sources -a http://gems.github.com
|
23
|
+
$ [sudo] gem install nathanhoad-moredown
|
24
|
+
|
25
|
+
The Moredown sources are available via Git:
|
26
|
+
|
27
|
+
$ git clone git://github.com/nathanhoad/moredown.git
|
28
|
+
$ cd moredown
|
29
|
+
$ rake --tasks
|
30
|
+
|
31
|
+
For more information, see [the project page](http://github.com/nathanhoad/moredown).
|
32
|
+
|
33
|
+
Usage
|
34
|
+
-----
|
35
|
+
|
36
|
+
Moredown can be used in any way that RDiscount can be (see below). In addition, Moredown
|
37
|
+
implements some extras:
|
38
|
+
|
39
|
+
* Static method for simple calls
|
40
|
+
|
41
|
+
require 'nathanhoad-moredown'
|
42
|
+
html = Moredown.text_to_html("Hello World!")
|
43
|
+
|
44
|
+
* Remap relative URLs
|
45
|
+
|
46
|
+
Moredown.new(text, :base_url => 'http://nathanhoad.net').to_html
|
47
|
+
|
48
|
+
* Remap headings (eg. h1 becomes h3).
|
49
|
+
|
50
|
+
Moredown.new(text, :map_headings => 2)
|
51
|
+
|
52
|
+
* Embed Youtube videos (similar to image syntax except the title text is used for width and height)
|
53
|
+
|
54
|
+

|
55
|
+

|
56
|
+
|
57
|
+
* Use Flash movies (include the width and height if you want)
|
58
|
+
|
59
|
+

|
60
|
+

|
61
|
+
|
62
|
+
* Use SwfObject (javascript not included) for graceful Flash degradation
|
63
|
+
|
64
|
+
Moredown.new(text, :swfobject => { :src => 'swfobject.js', :version => '10', :fallback => 'No Flash' })
|
65
|
+
|
66
|
+
* Image alignments (extension to image syntax)
|
67
|
+
|
68
|
+
:left
|
69
|
+
:right
|
70
|
+
:center
|
71
|
+
|
72
|
+
* Emoticons
|
73
|
+
|
74
|
+
:-)
|
75
|
+
:-P
|
76
|
+
:-D
|
77
|
+
:-(
|
78
|
+
:-@
|
79
|
+
;-)
|
80
|
+
|
81
|
+
* RDiscount extensions are now passed under `:extensions`
|
82
|
+
|
83
|
+
Moredown.new(text, :extensions => [:smart])
|
84
|
+
|
85
|
+
RDiscount implements the basic protocol popularized by RedCloth and adopted
|
86
|
+
by BlueCloth:
|
87
|
+
|
88
|
+
require 'nathanhoad-moredown'
|
89
|
+
markdown = Moredown.new("Hello World!")
|
90
|
+
puts markdown.to_html
|
91
|
+
|
92
|
+
Inject Moredown into your BlueCloth-using code by replacing your bluecloth
|
93
|
+
require statements with the following:
|
94
|
+
|
95
|
+
begin
|
96
|
+
require 'nathanhoad-moredown'
|
97
|
+
BlueCloth = Moredown
|
98
|
+
rescue LoadError
|
99
|
+
require 'bluecloth'
|
100
|
+
end
|
101
|
+
|
102
|
+
|
103
|
+
COPYING
|
104
|
+
-------
|
105
|
+
|
106
|
+
Discount is free software; it is released under a BSD-style license
|
107
|
+
that allows you to do as you wish with it as long as you don't attempt
|
108
|
+
to claim it as your own work. RDiscount adopts Discount's license
|
109
|
+
verbatim. See the file `COPYING` for more information.
|
data/Rakefile
ADDED
@@ -0,0 +1,121 @@
|
|
1
|
+
require 'rake/clean'
|
2
|
+
|
3
|
+
task :default => :test
|
4
|
+
|
5
|
+
|
6
|
+
# ==========================================================
|
7
|
+
# Packaging
|
8
|
+
# ==========================================================
|
9
|
+
|
10
|
+
begin
|
11
|
+
require 'jeweler'
|
12
|
+
Jeweler::Tasks.new do |gemspec|
|
13
|
+
gemspec.name = "moredown"
|
14
|
+
gemspec.summary = "Markdown plus more!"
|
15
|
+
gemspec.description = "An extension to the RDiscount Markdown formatter"
|
16
|
+
gemspec.email = "nathan@nathanhoad.net"
|
17
|
+
gemspec.homepage = "http://nathanhoad.net/projects/moredown"
|
18
|
+
gemspec.authors = ["Nathan Hoad", "Ryan Tomayko", "David Loren Parsons"]
|
19
|
+
gemspec.files = `git ls-files`.split("\n").sort.reject{ |file| file =~ /^\./ || file =~ /^test\/MarkdownTest/ }
|
20
|
+
end
|
21
|
+
rescue LoadError
|
22
|
+
puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
|
23
|
+
end
|
24
|
+
|
25
|
+
|
26
|
+
|
27
|
+
# ==========================================================
|
28
|
+
# Ruby Extension
|
29
|
+
# ==========================================================
|
30
|
+
|
31
|
+
DLEXT = Config::CONFIG['DLEXT']
|
32
|
+
|
33
|
+
file 'ext/Makefile' => FileList['ext/{*.c,*.h,*.rb}'] do
|
34
|
+
chdir('ext') { ruby 'extconf.rb' }
|
35
|
+
end
|
36
|
+
CLEAN.include 'ext/Makefile', 'ext/mkmf.log'
|
37
|
+
|
38
|
+
file "ext/rdiscount.#{DLEXT}" => FileList['ext/Makefile', 'ext/*.{c,h,rb}'] do |f|
|
39
|
+
sh 'cd ext && make'
|
40
|
+
end
|
41
|
+
CLEAN.include 'ext/*.{o,bundle,so,dll}'
|
42
|
+
|
43
|
+
file "lib/rdiscount.#{DLEXT}" => "ext/rdiscount.#{DLEXT}" do |f|
|
44
|
+
cp f.prerequisites, "lib/", :preserve => true
|
45
|
+
end
|
46
|
+
|
47
|
+
desc 'Build the rdiscount extension'
|
48
|
+
task :build_ext => "lib/rdiscount.#{DLEXT}"
|
49
|
+
|
50
|
+
# ==========================================================
|
51
|
+
# Testing
|
52
|
+
# ==========================================================
|
53
|
+
|
54
|
+
desc 'Run unit tests'
|
55
|
+
task 'test:unit' => [:build_ext] do |t|
|
56
|
+
sh 'testrb test/moredown_test.rb test/markdown_test.rb test/rdiscount_test.rb'
|
57
|
+
end
|
58
|
+
|
59
|
+
desc 'Run conformance tests (MARKDOWN_TEST_VER=1.0)'
|
60
|
+
task 'test:conformance' => [:build_ext] do |t|
|
61
|
+
script = "#{pwd}/bin/rdiscount"
|
62
|
+
test_version = ENV['MARKDOWN_TEST_VER'] || '1.0.3'
|
63
|
+
chdir("test/MarkdownTest_#{test_version}") do
|
64
|
+
sh "./MarkdownTest.pl --script='#{script}' --tidy"
|
65
|
+
end
|
66
|
+
end
|
67
|
+
|
68
|
+
desc 'Run version 1.0 conformance suite'
|
69
|
+
task 'test:conformance:1.0' => [:build_ext] do |t|
|
70
|
+
ENV['MARKDOWN_TEST_VER'] = '1.0'
|
71
|
+
Rake::Task['test:conformance'].invoke
|
72
|
+
end
|
73
|
+
|
74
|
+
desc 'Run 1.0.3 conformance suite'
|
75
|
+
task 'test:conformance:1.0.3' => [:build_ext] do |t|
|
76
|
+
ENV['MARKDOWN_TEST_VER'] = '1.0.3'
|
77
|
+
Rake::Task['test:conformance'].invoke
|
78
|
+
end
|
79
|
+
|
80
|
+
desc 'Run unit and conformance tests'
|
81
|
+
task :test => %w[test:unit test:conformance]
|
82
|
+
|
83
|
+
desc 'Run benchmarks'
|
84
|
+
task :benchmark => :build_ext do |t|
|
85
|
+
$:.unshift 'lib'
|
86
|
+
load 'test/benchmark.rb'
|
87
|
+
end
|
88
|
+
|
89
|
+
# ==========================================================
|
90
|
+
# Update package's Discount sources
|
91
|
+
# ==========================================================
|
92
|
+
|
93
|
+
desc 'Gather required discount sources into extension directory'
|
94
|
+
task :gather => 'discount' do |t|
|
95
|
+
files =
|
96
|
+
FileList[
|
97
|
+
'discount/{markdown,mkdio,amalloc,cstring}.h',
|
98
|
+
'discount/{markdown,docheader,dumptree,generate,mkdio,resource,toc,Csio}.c'
|
99
|
+
]
|
100
|
+
cp files, 'ext/',
|
101
|
+
:preserve => true,
|
102
|
+
:verbose => true
|
103
|
+
end
|
104
|
+
|
105
|
+
# best. task. ever.
|
106
|
+
file 'discount' do |f|
|
107
|
+
STDERR.puts((<<-TEXT).gsub(/^ +/, ''))
|
108
|
+
Sorry, this operation requires a human. Tell your human to:
|
109
|
+
|
110
|
+
Grab a discount tarball from:
|
111
|
+
http://www.pell.portland.or.us/~orc/Code/discount/
|
112
|
+
|
113
|
+
Extract here with something like:
|
114
|
+
tar xvzf discount-1.2.9.tar.gz
|
115
|
+
|
116
|
+
Create a discount symlink pointing at the version directory:
|
117
|
+
ln -hsf discount-1.2.9 discount
|
118
|
+
|
119
|
+
TEXT
|
120
|
+
fail "discount sources required."
|
121
|
+
end
|
data/VERSION
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
1.0.0
|
data/bin/rdiscount
ADDED
data/ext/Csio.c
ADDED
@@ -0,0 +1,49 @@
|
|
1
|
+
#include <stdio.h>
|
2
|
+
#include <string.h>
|
3
|
+
#include <stdarg.h>
|
4
|
+
#include "cstring.h"
|
5
|
+
#include "markdown.h"
|
6
|
+
#include "amalloc.h"
|
7
|
+
|
8
|
+
|
9
|
+
/* putc() into a cstring
|
10
|
+
*/
|
11
|
+
void
|
12
|
+
Csputc(int c, Cstring *iot)
|
13
|
+
{
|
14
|
+
EXPAND(*iot) = c;
|
15
|
+
}
|
16
|
+
|
17
|
+
|
18
|
+
/* printf() into a cstring
|
19
|
+
*/
|
20
|
+
int
|
21
|
+
Csprintf(Cstring *iot, char *fmt, ...)
|
22
|
+
{
|
23
|
+
va_list ptr;
|
24
|
+
int siz=100;
|
25
|
+
|
26
|
+
do {
|
27
|
+
RESERVE(*iot, siz);
|
28
|
+
va_start(ptr, fmt);
|
29
|
+
siz = vsnprintf(T(*iot)+S(*iot), ALL(*iot)-S(*iot), fmt, ptr);
|
30
|
+
va_end(ptr);
|
31
|
+
} while ( siz > (ALL(*iot)-S(*iot)) );
|
32
|
+
|
33
|
+
S(*iot) += siz;
|
34
|
+
return siz;
|
35
|
+
}
|
36
|
+
|
37
|
+
|
38
|
+
/* reparse() into a cstring
|
39
|
+
*/
|
40
|
+
void
|
41
|
+
Csreparse(Cstring *iot, char *buf, int size, int flags)
|
42
|
+
{
|
43
|
+
MMIOT f;
|
44
|
+
___mkd_initmmiot(&f, 0);
|
45
|
+
___mkd_reparse(buf, size, 0, &f);
|
46
|
+
___mkd_emblock(&f);
|
47
|
+
SUFFIX(*iot, T(f.out), S(f.out));
|
48
|
+
___mkd_freemmiot(&f, 0);
|
49
|
+
}
|
data/ext/amalloc.h
ADDED
@@ -0,0 +1,29 @@
|
|
1
|
+
/*
|
2
|
+
* debugging malloc()/realloc()/calloc()/free() that attempts
|
3
|
+
* to keep track of just what's been allocated today.
|
4
|
+
*/
|
5
|
+
#ifndef AMALLOC_D
|
6
|
+
#define AMALLOC_D
|
7
|
+
|
8
|
+
#include "config.h"
|
9
|
+
|
10
|
+
#ifdef USE_AMALLOC
|
11
|
+
|
12
|
+
extern void *amalloc(int);
|
13
|
+
extern void *acalloc(int,int);
|
14
|
+
extern void *arealloc(void*,int);
|
15
|
+
extern void afree(void*);
|
16
|
+
extern void adump();
|
17
|
+
|
18
|
+
#define malloc amalloc
|
19
|
+
#define calloc acalloc
|
20
|
+
#define realloc arealloc
|
21
|
+
#define free afree
|
22
|
+
|
23
|
+
#else
|
24
|
+
|
25
|
+
#define adump() (void)1
|
26
|
+
|
27
|
+
#endif
|
28
|
+
|
29
|
+
#endif/*AMALLOC_D*/
|
data/ext/config.h
ADDED
data/ext/cstring.h
ADDED
@@ -0,0 +1,73 @@
|
|
1
|
+
/* two template types: STRING(t) which defines a pascal-style string
|
2
|
+
* of element (t) [STRING(char) is the closest to the pascal string],
|
3
|
+
* and ANCHOR(t) which defines a baseplate that a linked list can be
|
4
|
+
* built up from. [The linked list /must/ contain a ->next pointer
|
5
|
+
* for linking the list together with.]
|
6
|
+
*/
|
7
|
+
#ifndef _CSTRING_D
|
8
|
+
#define _CSTRING_D
|
9
|
+
|
10
|
+
#include <string.h>
|
11
|
+
#include <stdlib.h>
|
12
|
+
|
13
|
+
#include "amalloc.h"
|
14
|
+
|
15
|
+
/* expandable Pascal-style string.
|
16
|
+
*/
|
17
|
+
#define STRING(type) struct { type *text; int size, alloc; }
|
18
|
+
|
19
|
+
#define CREATE(x) T(x) = (void*)(S(x) = (x).alloc = 0)
|
20
|
+
#define EXPAND(x) (S(x)++)[(S(x) < (x).alloc) \
|
21
|
+
? (T(x)) \
|
22
|
+
: (T(x) = T(x) ? realloc(T(x), sizeof T(x)[0] * ((x).alloc += 100)) \
|
23
|
+
: malloc(sizeof T(x)[0] * ((x).alloc += 100)) )]
|
24
|
+
|
25
|
+
#define DELETE(x) (x).alloc ? (free(T(x)), S(x) = (x).alloc = 0) \
|
26
|
+
: ( S(x) = 0 )
|
27
|
+
#define CLIP(t,i,sz) \
|
28
|
+
( ((i) >= 0) && ((sz) > 0) && (((i)+(sz)) <= S(t)) ) ? \
|
29
|
+
(memmove(&T(t)[i], &T(t)[i+sz], (S(t)-(i+sz)+1)*sizeof(T(t)[0])), \
|
30
|
+
S(t) -= (sz)) : -1
|
31
|
+
|
32
|
+
#define RESERVE(x, sz) T(x) = ((x).alloc > S(x) + (sz) \
|
33
|
+
? T(x) \
|
34
|
+
: T(x) \
|
35
|
+
? realloc(T(x), sizeof T(x)[0] * ((x).alloc = 100+(sz)+S(x))) \
|
36
|
+
: malloc(sizeof T(x)[0] * ((x).alloc = 100+(sz)+S(x))))
|
37
|
+
#define SUFFIX(t,p,sz) \
|
38
|
+
memcpy(((S(t) += (sz)) - (sz)) + \
|
39
|
+
(T(t) = T(t) ? realloc(T(t), sizeof T(t)[0] * ((t).alloc += sz)) \
|
40
|
+
: malloc(sizeof T(t)[0] * ((t).alloc += sz))), \
|
41
|
+
(p), sizeof(T(t)[0])*(sz))
|
42
|
+
|
43
|
+
#define PREFIX(t,p,sz) \
|
44
|
+
RESERVE( (t), (sz) ); \
|
45
|
+
if ( S(t) ) { memmove(T(t)+(sz), T(t), S(t)); } \
|
46
|
+
memcpy( T(t), (p), (sz) ); \
|
47
|
+
S(t) += (sz)
|
48
|
+
|
49
|
+
/* reference-style links (and images) are stored in an array
|
50
|
+
*/
|
51
|
+
#define T(x) (x).text
|
52
|
+
#define S(x) (x).size
|
53
|
+
#define ALL(x) (x).alloc
|
54
|
+
|
55
|
+
/* abstract anchor type that defines a list base
|
56
|
+
* with a function that attaches an element to
|
57
|
+
* the end of the list.
|
58
|
+
*
|
59
|
+
* the list base field is named .text so that the T()
|
60
|
+
* macro will work with it.
|
61
|
+
*/
|
62
|
+
#define ANCHOR(t) struct { t *text, *end; }
|
63
|
+
|
64
|
+
#define ATTACH(t, p) ( (t).text ?( ((t).end->next = (p)), ((t).end = (p)) ) \
|
65
|
+
:( ((t).text = (t).end = (p)) ) )
|
66
|
+
|
67
|
+
typedef STRING(char) Cstring;
|
68
|
+
|
69
|
+
extern void Csputc(int, Cstring *);
|
70
|
+
extern int Csprintf(Cstring *, char *, ...);
|
71
|
+
extern void Csreparse(Cstring *, char *, int, int);
|
72
|
+
|
73
|
+
#endif/*_CSTRING_D*/
|