maruku 0.2 → 0.2.1

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/docs/maruku.html CHANGED
@@ -1,7 +1,9 @@
1
1
  <?xml version='1.0'?>
2
2
  <!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN'
3
3
  'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
4
- <html lang='en' xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'><head><title>Maruku, a Markdown interpreter</title><link href='style.css' rel='stylesheet' type='text/css' /></head><head><title>Maruku, a Markdown interpreter</title><link href='style.css' rel='stylesheet' type='text/css' /></head><body><h1>Mar<strong>u</strong>k<strong>u</strong>: a Markdown interpreter</h1><p>Maruku is a Markdown interpreter written in <a href='http://www.ruby-lang.org'>Ruby</a>.</p><p>Maruku allows you to write in an easy-to-read-and-write syntax, like this:</p><blockquote><p><a href='http://maruku.rubyforge.org/maruku.md'>This document in Markdown</a></p></blockquote><p>Then it can be translated to HTML:</p><blockquote><p><a href='http://maruku.rubyforge.org/maruku.html'>This document in HTML</a></p></blockquote><p>or Latex, which is then converted to PDF:</p><blockquote><p><a href='http://maruku.rubyforge.org/maruku.pdf'>This document in PDF</a></p></blockquote><p>Maruku implements the original <a href='http://daringfireball.net/projects/markdown/syntax'>Markdown syntax</a> (<a href='http://maruku.rubyforge.org/markdown_syntax.html'>HTML</a> or <a href='http://maruku.rubyforge.org/markdown_syntax.pdf'>PDF</a>, translated by Maruku).</p><p>Markdown implements also all the improvements in <a href='http://www.michelf.com/projects/php-markdown/extra/'>PHP Markdown Extra</a>.</p><p>Moreover, it implements ideas from <a href='http://fletcher.freeshell.org/wiki/MultiMarkdown'>MultiMarkdown</a>.</p><hr /><p><em>Table of contents</em>:</p><ul><li><p><a href='#download'>Download</a></p></li><li><p><a href='#usage'>Usage</a></p></li><li><p><a href='#extra'>Examples of PHP Markdown extra syntax</a></p></li><li><p><a href='#meta'>New metadata syntax</a></p></li><li><p><a href='#metalist'>List of metadata</a></p></li><li><p><a href='#maruku-and-bluecloth'>Maruku and Bluecloth</a></p></li><li><p><a href='#future'>Future developments</a></p><ul><li><a href='#future-export'>Export to other formats</a></li><li><a href='#future-syntax'>Syntax additions</a></li></ul></li></ul><hr /><h2 class='head' id='download'>Download</h2><p>The development site is <a href='http://maruku.rubyforge.net/'>http://maruku.rubyforge.net/</a>.</p><p>Download current <a href='http://rubygems.rubyforge.org/'>gem</a> at <a href='http://maruku.rubyforge.net/gem1.0'>http://maruku.rubyforge.net/gem1.0</a></p><h2>Usage</h2><p>This is the basic usage:</p><pre class='ruby' style='background-color: #f0f0e0;'><span class='ident'>require</span> <span class='punct'>'</span><span class='string'>maruku</span><span class='punct'>'</span>
4
+ <html lang='en' xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'><head><title>Maruku, a Markdown interpreter</title><link href='style.css' rel='stylesheet' type='text/css' /></head><head><title>Maruku, a Markdown interpreter</title><link href='style.css' rel='stylesheet' type='text/css' /></head><body><h1>Mar<strong>u</strong>k<strong>u</strong>: a Markdown interpreter</h1><p><a href='http://maruku.rubyforge.org/&gt;'>Maruku</a> is a Markdown interpreter written in <a href='http://www.ruby-lang.org'>Ruby</a>.</p><p>Maruku allows you to write in an easy-to-read-and-write syntax, like this:</p><blockquote><p><a href='http://maruku.rubyforge.org/maruku.md'>This document in Markdown</a></p></blockquote><p>Then it can be translated to HTML:</p><blockquote><p><a href='http://maruku.rubyforge.org/maruku.html'>This document in HTML</a></p></blockquote><p>or Latex, which is then converted to PDF:</p><blockquote><p><a href='http://maruku.rubyforge.org/maruku.pdf'>This document in PDF</a></p></blockquote><p>Maruku implements the original <a href='http://daringfireball.net/projects/markdown/syntax'>Markdown syntax</a> (<a href='http://maruku.rubyforge.org/markdown_syntax.html'>HTML</a> or <a href='http://maruku.rubyforge.org/markdown_syntax.pdf'>PDF</a>, translated by Maruku).</p><p>Markdown implements also all the improvements in <a href='http://www.michelf.com/projects/php-markdown/extra/'>PHP Markdown Extra</a>.</p><p>Moreover, it implements ideas from <a href='http://fletcher.freeshell.org/wiki/MultiMarkdown'>MultiMarkdown</a>.</p><h3>Authors</h3><p>Maruku has been developed so far by <a href='http://www.dis.uniroma1.it/~acensi/'>Andrea Censi</a>. Contributors are most welcome!</p><hr /><p><em>Table of contents</em>:</p><ul><li><p><a href='#download'>Download</a></p></li><li><p><a href='#usage'>Usage</a></p></li><li><p><a href='#extra'>Examples of PHP Markdown extra syntax</a></p></li><li><p><a href='#meta'>New metadata syntax</a></p></li><li><p><a href='#metalist'>List of metadata</a></p></li><li><p><a href='#maruku-and-bluecloth'>Maruku and Bluecloth</a></p></li><li><p><a href='#future'>Future developments</a></p><ul><li><a href='#future-export'>Export to other formats</a></li><li><a href='#future-syntax'>Syntax additions</a></li></ul></li></ul><hr /><h2 class='head' id='download'>Download</h2><p>The development site is <a href='http://rubyforge.org/projects/maruku/'>http://rubyforge.org/projects/maruku/</a>.</p><p>Download current <a href='http://rubygems.rubyforge.org/'>gem</a> at <a href='http://rubyforge.org/frs/?group_id=2795'>http://rubyforge.org/frs/?group_id=2795</a> or try to install with:</p><pre style='background-color: #f0f0e0;'>$ gem install maruku
5
+ </pre><p>Anonymous access to the repository is possible with:</p><pre style='background-color: #f0f0e0;'>$ svn checkout svn://rubyforge.org/var/svn/maruku
6
+ </pre><p>If you want commit-access, just create an account on Rubyforge and <a href='http://www.dis.uniroma1.it/~acensi/contact.html'>drop me a mail</a>.</p><h2>Usage</h2><p>This is the basic usage:</p><pre class='ruby' style='background-color: #f0f0e0;'><span class='ident'>require</span> <span class='punct'>'</span><span class='string'>maruku</span><span class='punct'>'</span>
5
7
 
6
8
  <span class='ident'>doc</span> <span class='punct'>=</span> <span class='constant'>Maruku</span><span class='punct'>.</span><span class='ident'>new</span><span class='punct'>(</span><span class='ident'>markdown_string</span><span class='punct'>)</span>
7
9
  <span class='ident'>puts</span> <span class='ident'>doc</span><span class='punct'>.</span><span class='ident'>to_html</span>
@@ -14,14 +16,14 @@
14
16
  </pre><h2 id='extra'>Examples of PHP Markdown Extra syntax</h2><ul><li><p>tables</p><pre style='background-color: #f0f0e0;'>Col1 | Very very long head | Very very long head|
15
17
  -----|:-------------------:|-------------------:|
16
18
  cell | center-align | right-align |
17
- </pre><table class='example'><thead><tr><th>Col1</th><th>Very very long head</th><th>Very very long head</th></tr></thead><tbody><tr><td style='text-align: left;'>cell</td><td style='text-align: center;'>center-align</td><td style='text-align: right;'>right-align</td></tr></tbody></table></li><li><p>footnotes <sup id='fnref:1'><a href='#fn:1' rel='footnote'>1</a></sup></p><pre style='background-color: #f0f0e0;'>*footnotes [^foot]
19
+ </pre><table class='example'><thead><tr><th>Col1</th><th>Very very long head</th><th>Very very long head</th></tr></thead><tbody><tr><td style='text-align: left;'>cell</td><td style='text-align: center;'>center-align</td><td style='text-align: right;'>right-align</td></tr></tbody></table></li><li><p>footnotes <sup id='fnref:1'><a href='#fn:1' rel='footnote'>1</a></sup></p><pre style='background-color: #f0f0e0;'>* footnotes [^foot]
18
20
 
19
21
  [^foot]: I really was missing those.</pre></li><li><p>Markdown inside HTML elememnts</p></li></ul><pre class='xml' style='background-color: #f0f0e0;'><span class='punct'>&lt;</span><span class='tag'>div</span> <span class='attribute'>markdown</span><span class='punct'>=&quot;</span><span class='string'>1</span><span class='punct'>&quot;</span> <span class='attribute'>style</span><span class='punct'>=&quot;</span><span class='string'>border: solid 1px black</span><span class='punct'>&quot;&gt;</span>
20
22
  This is a div with Markdown **strong text**
21
23
  <span class='punct'>&lt;/</span><span class='tag'>div</span><span class='punct'>&gt;</span>
22
24
  </pre><div style='border: solid 1px black'><p>This is a div with Markdown <strong>strong text</strong></p></div><ul><li><p>header ids</p><pre style='background-color: #f0f0e0;'>## Header ## {#id}</pre><p>For example, <a href='#download'>a link to the download</a> header.</p></li><li><p>definition lists</p><pre style='background-color: #f0f0e0;'>Definition list
23
25
  : something very hard to parse
24
- </pre><dl><dt>Definition list</dt><dd>something very hard to parse</dd></dl></li><li><p>abbreviations or <abbr title='Simple an abbreviation'>ABB</abbr> for short.</p></li></ul><h2 id='maruku-and-bluecloth'>Maruku and Bluecloth</h2><p>The other Ruby implementation of Markdown is <a href='http://www.deveiate.org/projects/BlueCloth'>Bluecloth</a>.</p><p>Maruku is much different in philosophy from Bluecloth: the biggest difference is that <em>parsing</em> is separated from <em>rendering</em>. In Maruku, an in-memory representation of the Markdown document is created. Instead, Bluecloth mantains the document in memory as a String at all times, and does a series of <tt style='background-color: #f0f0e0;'>gsub</tt> to transform to HTML.<sup id='fnref:2'><a href='#fn:2' rel='footnote'>2</a></sup></p><p>The in-memory representation makes it very easy to export to various formats (altough, for, now)</p><p>Other improvements over Bluecloth:</p><ul><li><p>the HTML output is provided also as a <tt style='background-color: #f0f0e0;'>REXML</tt> document tree.</p></li><li><p>PHP Markdown Syntax support.</p></li></ul><h2 id='meta'>New meta-data syntax</h2><p>Maruku implements a syntax that allows to attach &quot;meta&quot; information to objects.</p><h3>Meta-data for the document</h3><p>Meta-data for the document itself is specified through the use of email headers:</p><pre style='background-color: #f0f0e0;'>Title: A simple document containing meta-headers
26
+ </pre><dl><dt>Definition list</dt><dd>something very hard to parse</dd></dl></li><li><p>abbreviations or <abbr title='Simple an abbreviation'>ABB</abbr> for short.</p></li></ul><h2 id='maruku-and-bluecloth'>Maruku and Bluecloth</h2><p>The other Ruby implementation of Markdown is <a href='http://www.deveiate.org/projects/BlueCloth'>Bluecloth</a>.</p><p>Maruku is much different in philosophy from Bluecloth: the biggest difference is that <em>parsing</em> is separated from <em>rendering</em>. In Maruku, an in-memory representation of the Markdown document is created. Instead, Bluecloth mantains the document in memory as a String at all times, and does a series of <tt style='background-color: #f0f0e0;'>gsub</tt> to transform to HTML.</p><p>The in-memory representation makes it very easy to export to various formats (altough, for, now)</p><p>Other improvements over Bluecloth:</p><ul><li><p>the HTML output is provided also as a <tt style='background-color: #f0f0e0;'>REXML</tt> document tree.</p></li><li><p>PHP Markdown Syntax support.</p></li></ul><h2 id='meta'>New meta-data syntax</h2><p>Maruku implements a syntax that allows to attach &quot;meta&quot; information to objects.</p><h3>Meta-data for the document</h3><p>Meta-data for the document itself is specified through the use of email headers:</p><pre style='background-color: #f0f0e0;'>Title: A simple document containing meta-headers
25
27
  CSS: style.css
26
28
 
27
29
  Content of the document
@@ -47,7 +49,7 @@ Paragraph 1 is a warning
47
49
  </pre><p>Also, if the value is not present, it defaults to <tt style='background-color: #f0f0e0;'>true</tt>:</p><pre style='background-color: #f0f0e0;'>@ test
48
50
 
49
51
  This paragraph has the attribute &apos;test&apos; set.
50
- </pre><hr /><h2 id='metalist'>List of meta-data</h2><dl><dt><strong><tt style='background-color: #f0f0e0;'>title</tt>, <tt style='background-color: #f0f0e0;'>subject</tt></strong></dt><dd><p>(document) Sets the title of the document use in <tt style='background-color: #f0f0e0;'>title</tt> element.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>css</tt></strong></dt><dd><p>(document, HTML) Url of stylesheet.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>latex_use_syntax</tt></strong></dt><dd><p>(document, HTML) Use the [<tt style='background-color: #f0f0e0;'>syntax</tt> library][syntax] to add source highlighting.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>latex_use_listings</tt></strong></dt><dd><p>(document, LaTex) Use fancy <tt style='background-color: #f0f0e0;'>listing</tt> package for better displaying code blocks.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>style</tt>, <tt style='background-color: #f0f0e0;'>id</tt>, <tt style='background-color: #f0f0e0;'>class</tt></strong></dt><dd><p>(any block object, HTML) Standard CSS attributes are copied.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>lang</tt></strong></dt><dd><p>(code blocks) Name of programming language (<tt style='background-color: #f0f0e0;'>ruby</tt>) for syntax highlighting (does not work yet)</p><p>Default for this is <tt style='background-color: #f0f0e0;'>code_lang</tt> in document.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>code_show_spaces</tt></strong></dt><dd><p>Shows tabs and newlines (default is read in the document object).</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>code_background_color</tt></strong></dt><dd><p>Background color for code blocks. (default is read in the document object).</p><p>The format is either a named color (<tt style='background-color: #f0f0e0;'>green</tt>, <tt style='background-color: #f0f0e0;'>red</tt>) or a CSS color of the form <tt style='background-color: #f0f0e0;'>#ff00ff</tt>.</p><ul><li><p>for <strong>HTML output</strong>, the value is put straight in the <tt style='background-color: #f0f0e0;'>background-color</tt> CSS property of the block.</p></li><li><p>for <strong>LaTeX output</strong>, if it is a named color, it must be a color accepted by the latex <tt style='background-color: #f0f0e0;'>color</tt> packages. If it is of the form <tt style='background-color: #f0f0e0;'>#ff00ff</tt>, Maruku defines a color using the <tt style='background-color: #f0f0e0;'>\definecolor</tt> macro.</p><p>For example, for <tt style='background-color: #f0f0e0;'>#0000ff</tt>, the macro is called as:</p><pre class='tex' style='background-color: #f0f0e0;'>\definecolor{DummyName}{rgb}{0,0,1} </pre></li></ul></dd></dl><h3>Examples</h3><p>An example of this is the following:</p><pre style='background-color: #f0f0e0;'>@&not;code_show_spaces;&not;code_background_color:&not;green
52
+ </pre><hr /><h2 id='metalist'>List of meta-data</h2><dl><dt><strong><tt style='background-color: #f0f0e0;'>title</tt>, <tt style='background-color: #f0f0e0;'>subject</tt></strong></dt><dd><p>(document) Sets the title of the document (HTML: used in the <tt style='background-color: #f0f0e0;'>TITLE</tt> element).</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>css</tt></strong></dt><dd><p>(document, HTML) Url of stylesheet.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>html_use_syntax</tt></strong></dt><dd><p>(document, HTML) Use the <a href='http://syntax.rubyforge.org/'><tt style='background-color: #f0f0e0;'>syntax</tt> library</a> to add source highlighting.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>latex_use_listings</tt></strong></dt><dd><p>(document, LaTex) Use fancy <tt style='background-color: #f0f0e0;'>listing</tt> package for better displaying code blocks.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>style</tt>, <tt style='background-color: #f0f0e0;'>id</tt>, <tt style='background-color: #f0f0e0;'>class</tt></strong></dt><dd><p>(any block object, HTML) Standard CSS attributes are copied.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>lang</tt></strong></dt><dd><p>(code blocks) Name of programming language (<tt style='background-color: #f0f0e0;'>ruby</tt>) for syntax highlighting (does not work yet)</p><p>Default for this is <tt style='background-color: #f0f0e0;'>code_lang</tt> in document.</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>code_show_spaces</tt></strong></dt><dd><p>Shows tabs and newlines (default is read in the document object).</p></dd><dt><strong><tt style='background-color: #f0f0e0;'>code_background_color</tt></strong></dt><dd><p>Background color for code blocks. (default is read in the document object).</p><p>The format is either a named color (<tt style='background-color: #f0f0e0;'>green</tt>, <tt style='background-color: #f0f0e0;'>red</tt>) or a CSS color of the form <tt style='background-color: #f0f0e0;'>#ff00ff</tt>.</p><ul><li><p>for <strong>HTML output</strong>, the value is put straight in the <tt style='background-color: #f0f0e0;'>background-color</tt> CSS property of the block.</p></li><li><p>for <strong>LaTeX output</strong>, if it is a named color, it must be a color accepted by the latex <tt style='background-color: #f0f0e0;'>color</tt> packages. If it is of the form <tt style='background-color: #f0f0e0;'>#ff00ff</tt>, Maruku defines a color using the <tt style='background-color: #f0f0e0;'>\color[rgb]{r,g,b}</tt> macro.</p><p>For example, for <tt style='background-color: #f0f0e0;'>#0000ff</tt>, the macro is called as: <tt style='background-color: #f0f0e0;'>\color[rgb]{0,0,1}</tt>.</p></li></ul></dd></dl><h3>Examples</h3><p>An example of this is the following:</p><pre style='background-color: #f0f0e0;'>@&not;code_show_spaces;&not;code_background_color:&not;green
51
53
 
52
54
  &raquo;&nbsp;&nbsp;&nbsp;&not;One&not;space
53
55
  &raquo;&nbsp;&nbsp;&nbsp;&not;&not;Two&not;spaces
@@ -71,4 +73,4 @@ This is an equation with label:
71
73
 
72
74
  $ \alpha = \beta + \gamma $ (eq:1)
73
75
 
74
- This is a reference to equation: please see (eq:1)</pre></li></ul><div class='footnotes'><hr /><ol><li id='fn:1'><p>I really was missing those.<a href='#fnref:1' rev='footnote'>&#8617;</a></p></li><li id='fn:2'><p>&quot;a different philosophy&quot; stands for &quot;ugly&quot; <tt style='background-color: #f0f0e0;'>:-)</tt><a href='#fnref:2' rev='footnote'>&#8617;</a></p></li></ol></div></body></html>
76
+ This is a reference to equation: please see (eq:1)</pre></li></ul><div class='footnotes'><hr /><ol><li id='fn:1'><p>I really was missing those.<a href='#fnref:1' rev='footnote'>&#8617;</a></p></li></ol></div></body></html>
data/docs/maruku.log CHANGED
@@ -1,4 +1,4 @@
1
- This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) (format=pdflatex 2005.12.27) 25 DEC 2006 16:35
1
+ This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) (format=pdflatex 2005.12.27) 25 DEC 2006 21:06
2
2
  entering extended mode
3
3
  **./maruku
4
4
  (./maruku.tex
@@ -194,88 +194,64 @@ loading : Context Support Macros / PDF (2004.03.26)
194
194
  \MPnumerator=\count113
195
195
  \everyMPtoPDFconversion=\toks21
196
196
  )
197
- LaTeX Font Info: Try loading font information for OMS+cmr on input line 46.
197
+ LaTeX Font Info: Try loading font information for OMS+cmr on input line 50.
198
198
  (/sw/share/texmf-dist/tex/latex/base/omscmr.fd
199
199
  File: omscmr.fd 1999/05/25 v2.5h Standard LaTeX font definitions
200
200
  )
201
201
  LaTeX Font Info: Font shape `OMS/cmr/m/n' in size <10> not available
202
- (Font) Font shape `OMS/cmsy/m/n' tried instead on input line 46.
202
+ (Font) Font shape `OMS/cmsy/m/n' tried instead on input line 50.
203
+ [1
203
204
 
205
+ {/Users/andrea/.texmf-var/fonts/map/pdftex/updmap/pdftex.map}]
204
206
  (/sw/share/texmf-dist/tex/latex/listings/lstlang1.sty
205
207
  File: lstlang1.sty 2004/09/05 1.3 listings language file
206
208
  )
207
209
  (/sw/share/texmf-dist/tex/latex/listings/lstlang2.sty
208
210
  File: lstlang2.sty 2004/09/05 1.3 listings language file
209
- ) [1
210
-
211
- {/Users/andrea/.texmf-var/fonts/map/pdftex/updmap/pdftex.map}]
211
+ ) [2]
212
212
  LaTeX Font Info: External font `cmex10' loaded for size
213
- (Font) <7> on input line 168.
213
+ (Font) <7> on input line 191.
214
214
  LaTeX Font Info: External font `cmex10' loaded for size
215
- (Font) <5> on input line 168.
215
+ (Font) <5> on input line 191.
216
216
  LaTeX Font Info: External font `cmex10' loaded for size
217
- (Font) <8> on input line 175.
217
+ (Font) <8> on input line 198.
218
218
  LaTeX Font Info: External font `cmex10' loaded for size
219
- (Font) <6> on input line 175.
219
+ (Font) <6> on input line 198.
220
220
 
221
221
  (/sw/share/texmf-dist/tex/latex/listings/lstlang1.sty
222
222
  File: lstlang1.sty 2004/09/05 1.3 listings language file
223
223
  )
224
224
  (/sw/share/texmf-dist/tex/latex/listings/lstmisc.sty
225
225
  File: lstmisc.sty 2004/09/07 1.3 (Carsten Heinz)
226
- ) [2]
226
+ )
227
227
  LaTeX Font Info: Font shape `OT1/cmtt/bx/n' in size <8> not available
228
- (Font) Font shape `OT1/cmtt/m/n' tried instead on input line 198.
229
- [3] [4]
230
- Overfull \hbox (12.2479pt too wide) in paragraph at lines 414--415
228
+ (Font) Font shape `OT1/cmtt/m/n' tried instead on input line 221.
229
+ [3] [4] [5]
230
+ Overfull \hbox (12.2479pt too wide) in paragraph at lines 437--438
231
231
  []\OT1/cmr/m/n/10 for \OT1/cmr/bx/n/10 HTML out-put\OT1/cmr/m/n/10 , the value
232
232
  is put straight in the [][][][][][]
233
233
  []
234
234
 
235
- (/sw/share/texmf-dist/tex/latex/listings/lstlang1.sty
236
- File: lstlang1.sty 2004/09/05 1.3 listings language file
237
- )
238
- (/sw/share/texmf-dist/tex/latex/listings/lstlang2.sty
239
- File: lstlang2.sty 2004/09/05 1.3 listings language file
240
- )
241
- (/sw/share/texmf-dist/tex/latex/listings/lstlang3.sty
242
- File: lstlang3.sty 2004/09/05 1.3 listings language file
243
- )
244
- (/sw/share/texmf-dist/tex/latex/listings/lstlang1.sty
245
- File: lstlang1.sty 2004/09/05 1.3 listings language file
246
- )
247
- (/sw/share/texmf-dist/tex/latex/listings/lstlang2.sty
248
- File: lstlang2.sty 2004/09/05 1.3 listings language file
249
- )
250
- (/sw/share/texmf-dist/tex/latex/listings/lstlang3.sty
251
- File: lstlang3.sty 2004/09/05 1.3 listings language file
252
- )
253
- (/sw/share/texmf-dist/tex/latex/listings/lstlang1.sty
254
- File: lstlang1.sty 2004/09/05 1.3 listings language file
255
- )
256
- (/sw/share/texmf-dist/tex/latex/listings/lstlang2.sty
257
- File: lstlang2.sty 2004/09/05 1.3 listings language file
258
- )
259
- (/sw/share/texmf-dist/tex/latex/listings/lstlang3.sty
260
- File: lstlang3.sty 2004/09/05 1.3 listings language file
261
- )
262
- (/sw/share/texmf-dist/tex/latex/listings/lstmisc.sty
263
- File: lstmisc.sty 2004/09/07 1.3 (Carsten Heinz)
264
- ) [5]
235
+
236
+ Overfull \hbox (22.13806pt too wide) in paragraph at lines 442--443
237
+ []\OT1/cmr/m/n/10 For ex-am-ple, for [][][][][][], the macro is called as: [][]
238
+ [][][][].
239
+ []
240
+
265
241
  (/sw/share/texmf-dist/tex/latex/listings/lstlang1.sty
266
242
  File: lstlang1.sty 2004/09/05 1.3 listings language file
267
243
  ) [6] [7] (./maruku.aux) )
268
244
  Here is how much of TeX's memory you used:
269
- 5376 strings out of 94500
270
- 74269 string characters out of 1176113
271
- 168877 words of memory out of 1000000
272
- 8372 multiletter control sequences out of 10000+50000
245
+ 4423 strings out of 94500
246
+ 60941 string characters out of 1176113
247
+ 134257 words of memory out of 1000000
248
+ 7438 multiletter control sequences out of 10000+50000
273
249
  8353 words of font info for 30 fonts, out of 500000 for 2000
274
250
  580 hyphenation exceptions out of 1000
275
- 39i,8n,77p,529b,1962s stack positions out of 1500i,500n,5000p,200000b,5000s
251
+ 27i,8n,59p,646b,1581s stack positions out of 1500i,500n,5000p,200000b,5000s
276
252
  PDF statistics:
277
- 222 PDF objects out of 300000
278
- 137 named destinations out of 131072
253
+ 228 PDF objects out of 300000
254
+ 139 named destinations out of 131072
279
255
  17 words of extra memory for PDF output out of 65536
280
256
 
281
257
  ! pdfTeX warning (dest): name{future-export} has been referenced but does not e
@@ -288,7 +264,7 @@ placed by a fixed one
288
264
  ts/type1/bluesky/cm/cmr6.pfb></sw/share/texmf-dist/fonts/type1/bluesky/cm/cmr7.
289
265
  pfb></sw/share/texmf-dist/fonts/type1/bluesky/cm/cmtt10.pfb></sw/share/texmf-di
290
266
  st/fonts/type1/bluesky/cm/cmtt8.pfb></sw/share/texmf-dist/fonts/type1/bluesky/c
291
- m/cmbx10.pfb></sw/share/texmf-dist/fonts/type1/bluesky/cm/cmsy10.pfb></sw/share
292
- /texmf-dist/fonts/type1/bluesky/cm/cmti10.pfb></sw/share/texmf-dist/fonts/type1
267
+ m/cmsy10.pfb></sw/share/texmf-dist/fonts/type1/bluesky/cm/cmti10.pfb></sw/share
268
+ /texmf-dist/fonts/type1/bluesky/cm/cmbx10.pfb></sw/share/texmf-dist/fonts/type1
293
269
  /bluesky/cm/cmr10.pfb></sw/share/texmf-dist/fonts/type1/bluesky/cm/cmbx12.pfb>
294
- Output written on maruku.pdf (7 pages, 119358 bytes).
270
+ Output written on maruku.pdf (7 pages, 120937 bytes).
data/docs/maruku.md CHANGED
@@ -6,7 +6,9 @@ html_use_syntax: true
6
6
  Mar**u**k**u**: a Markdown interpreter
7
7
  ======================================
8
8
 
9
- Maruku is a Markdown interpreter written in [Ruby][].
9
+ [Maruku][] is a Markdown interpreter written in [Ruby][].
10
+
11
+ [maruku]: <http://maruku.rubyforge.org/>
10
12
 
11
13
  Maruku allows you to write in an easy-to-read-and-write syntax, like this:
12
14
 
@@ -29,6 +31,12 @@ in [PHP Markdown Extra][].
29
31
 
30
32
  Moreover, it implements ideas from [MultiMarkdown][].
31
33
 
34
+ ### Authors ###
35
+
36
+ Maruku has been developed so far by [Andrea Censi][].
37
+ Contributors are most welcome!
38
+
39
+ [Andrea Censi]: http://www.dis.uniroma1.it/~acensi/
32
40
 
33
41
  * * *
34
42
 
@@ -51,11 +59,20 @@ Moreover, it implements ideas from [MultiMarkdown][].
51
59
  Download {#download}
52
60
  --------
53
61
 
54
- The development site is <http://maruku.rubyforge.net/>.
62
+ The development site is <http://rubyforge.org/projects/maruku/>.
63
+
64
+ Download current [gem][] at <http://rubyforge.org/frs/?group_id=2795> or
65
+ try to install with:
66
+
67
+ $ gem install maruku
55
68
 
56
- Download current [gem][] at <http://maruku.rubyforge.net/gem1.0>
69
+ Anonymous access to the repository is possible with:
57
70
 
71
+ $ svn checkout svn://rubyforge.org/var/svn/maruku
58
72
 
73
+ If you want commit-access, just create an account on Rubyforge and [drop me a mail][drop].
74
+
75
+ [drop]: http://www.dis.uniroma1.it/~acensi/contact.html
59
76
  [gem]: http://rubygems.rubyforge.org/
60
77
 
61
78
  Usage
@@ -120,7 +137,7 @@ Examples of PHP Markdown Extra syntax {#extra}
120
137
 
121
138
  * footnotes [^foot]
122
139
 
123
- *footnotes [^foot]
140
+ * footnotes [^foot]
124
141
 
125
142
  [^foot]: I really was missing those.
126
143
 
@@ -167,7 +184,7 @@ difference is that *parsing* is separated from *rendering*.
167
184
  In Maruku, an in-memory representation of the Markdown
168
185
  document is created. Instead, Bluecloth mantains the document in
169
186
  memory as a String at all times, and does a series of `gsub`
170
- to transform to HTML.[^1]
187
+ to transform to HTML.
171
188
 
172
189
  [^1]: "a different philosophy" stands for "ugly" `:-)`
173
190
 
@@ -271,16 +288,14 @@ List of meta-data {#metalist}
271
288
 
272
289
 
273
290
  **`title`, `subject`**
274
- : (document) Sets the title of the document use in `title` element.
291
+ : (document) Sets the title of the document (HTML: used in the `TITLE` element).
275
292
 
276
293
  **`css`**
277
294
  : (document, HTML) Url of stylesheet.
278
295
 
279
- **`latex_use_syntax`**
296
+ **`html_use_syntax`**
280
297
  : (document, HTML) Use the [`syntax` library][syntax] to add source highlighting.
281
298
 
282
- [syntax]: http://syntax.rubyforge.org/
283
-
284
299
  **`latex_use_listings`**
285
300
  : (document, LaTex) Use fancy `listing` package for better displaying code blocks.
286
301
 
@@ -306,12 +321,11 @@ List of meta-data {#metalist}
306
321
 
307
322
  * for **LaTeX output**, if it is a named color, it must be a color accepted
308
323
  by the latex `color` packages. If it is of the form `#ff00ff`, Maruku
309
- defines a color using the `\definecolor` macro.
324
+ defines a color using the `\color[rgb]{r,g,b}` macro.
310
325
 
311
- For example, for `#0000ff`, the macro is called as:
326
+ For example, for `#0000ff`, the macro is called as: `\color[rgb]{0,0,1}`.
312
327
 
313
- @ lang: tex
314
- \definecolor{DummyName}{rgb}{0,0,1}
328
+ [syntax]: http://syntax.rubyforge.org/
315
329
 
316
330
 
317
331
  ### Examples ###
data/docs/maruku.pdf CHANGED
Binary file
data/docs/maruku.tex CHANGED
@@ -9,7 +9,7 @@
9
9
  \begin{document}
10
10
  \section*{Mar{\bf u}k{\bf u}: a Markdown interpreter}
11
11
 
12
- Maruku is a Markdown interpreter written in \href{http://www.ruby-lang.org}{Ruby}.
12
+ \href{http://maruku.rubyforge.org/>}{Maruku} is a Markdown interpreter written in \href{http://www.ruby-lang.org}{Ruby}.
13
13
 
14
14
  Maruku allows you to write in an easy-to-read-and-write syntax, like this:
15
15
 
@@ -38,6 +38,10 @@ Markdown implements also all the improvements in \href{http://www.michelf.com/pr
38
38
 
39
39
  Moreover, it implements ideas from \href{http://fletcher.freeshell.org/wiki/MultiMarkdown}{MultiMarkdown}.
40
40
 
41
+ \subsubsection*{Authors}
42
+
43
+ Maruku has been developed so far by \href{http://www.dis.uniroma1.it/~acensi/}{Andrea Censi}. Contributors are most welcome!
44
+
41
45
 
42
46
  \vspace{.5em} \hrule \vspace{.5em}
43
47
  {\em Table of contents}:
@@ -75,17 +79,36 @@ Moreover, it implements ideas from \href{http://fletcher.freeshell.org/wiki/Mult
75
79
  \vspace{.5em} \hrule \vspace{.5em}
76
80
  \hypertarget{download}{}\subsection*{{Download}}
77
81
 
78
- The development site is \href{http://maruku.rubyforge.net/}{http://maruku.rubyforge.net/}.
82
+ The development site is \href{http://rubyforge.org/projects/maruku/}{http://rubyforge.org/projects/maruku/}.
83
+
84
+ Download current \href{http://rubygems.rubyforge.org/}{gem} at \href{http://rubyforge.org/frs/?group_id=2795}{http://rubyforge.org/frs/?group\_id=2795} or try to install with:
85
+
86
+ \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
87
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
88
+ \lstset{basicstyle=\ttfamily\footnotesize}
89
+ \lstset{language={}}
90
+
91
+ \begin{lstlisting}
92
+ $ gem install maruku
93
+
94
+ \end{lstlisting}Anonymous access to the repository is possible with:
79
95
 
80
- Download current \href{http://rubygems.rubyforge.org/}{gem} at \href{http://maruku.rubyforge.net/gem1.0}{http://maruku.rubyforge.net/gem1.0}
96
+ \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
97
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
98
+ \lstset{basicstyle=\ttfamily\footnotesize}
99
+ \lstset{language={}}
100
+
101
+ \begin{lstlisting}
102
+ $ svn checkout svn://rubyforge.org/var/svn/maruku
103
+
104
+ \end{lstlisting}If you want commit-access, just create an account on Rubyforge and \href{http://www.dis.uniroma1.it/~acensi/contact.html}{drop me a mail}.
81
105
 
82
106
  \subsection*{Usage}
83
107
 
84
108
  This is the basic usage:
85
109
 
86
110
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
87
- \definecolor{maruku_color0}{rgb}{0.941176470588235,0.941176470588235,0.87843137254902}
88
- \lstset{backgroundcolor=\color{maruku_color0}}
111
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
89
112
  \lstset{basicstyle=\ttfamily\footnotesize}
90
113
  \lstset{language=ruby}
91
114
 
@@ -98,7 +121,7 @@ puts doc.to_html
98
121
  \end{lstlisting}or, if you install through RubyGems,
99
122
 
100
123
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
101
- \lstset{backgroundcolor=\color{maruku_color0}}
124
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
102
125
  \lstset{basicstyle=\ttfamily\footnotesize}
103
126
  \lstset{language=ruby}
104
127
 
@@ -109,7 +132,7 @@ require 'maruku'
109
132
  \end{lstlisting}This outputs a complete XHTML 1.0 document:
110
133
 
111
134
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
112
- \lstset{backgroundcolor=\color{maruku_color0}}
135
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
113
136
  \lstset{basicstyle=\ttfamily\footnotesize}
114
137
  \lstset{language=ruby}
115
138
 
@@ -118,7 +141,7 @@ puts doc.to_html_document
118
141
  \end{lstlisting}You can have the REXML document tree with:
119
142
 
120
143
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
121
- \lstset{backgroundcolor=\color{maruku_color0}}
144
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
122
145
  \lstset{basicstyle=\ttfamily\footnotesize}
123
146
  \lstset{language=ruby}
124
147
 
@@ -127,22 +150,22 @@ tree = doc.to_html_document_tree
127
150
 
128
151
  \end{lstlisting}\subsubsection*{From the command line}
129
152
 
130
- There are two command-line programs installed: \colorbox{maruku_color0}{\tt \char109\char97\char114\char117\char107\char117} and \colorbox{maruku_color0}{\tt \char109\char97\char114\char117\char116\char101\char120}
153
+ There are two command-line programs installed: \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char109\char97\char114\char117\char107\char117} and \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char109\char97\char114\char117\char116\char101\char120}
131
154
 
132
- \colorbox{maruku_color0}{\tt \char109\char97\char114\char117\char107\char117} converts Markdown in HTML:
155
+ \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char109\char97\char114\char117\char107\char117} converts Markdown in HTML:
133
156
 
134
157
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
135
- \lstset{backgroundcolor=\color{maruku_color0}}
158
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
136
159
  \lstset{basicstyle=\ttfamily\footnotesize}
137
160
  \lstset{language={}}
138
161
 
139
162
  \begin{lstlisting}
140
163
  $ maruku file.md # creates file.html
141
164
 
142
- \end{lstlisting}\colorbox{maruku_color0}{\tt \char109\char97\char114\char117\char116\char101\char120} converts Markdown in TeX, then calls \colorbox{maruku_color0}{\tt \char112\char100\char102\char108\char97\char116\char101\char120} to transform to PDF:
165
+ \end{lstlisting}\colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char109\char97\char114\char117\char116\char101\char120} converts Markdown in TeX, then calls \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char112\char100\char102\char108\char97\char116\char101\char120} to transform to PDF:
143
166
 
144
167
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
145
- \lstset{backgroundcolor=\color{maruku_color0}}
168
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
146
169
  \lstset{basicstyle=\ttfamily\footnotesize}
147
170
  \lstset{language={}}
148
171
 
@@ -156,7 +179,7 @@ $ marutex file.md # creates file.tex and file.pdf
156
179
  \item tables
157
180
 
158
181
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
159
- \lstset{backgroundcolor=\color{maruku_color0}}
182
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
160
183
  \lstset{basicstyle=\ttfamily\footnotesize}
161
184
  \lstset{language={}}
162
185
 
@@ -175,12 +198,12 @@ cell&center-align&right-align\\
175
198
  \item footnotes \footnote{I really was missing those.}
176
199
 
177
200
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
178
- \lstset{backgroundcolor=\color{maruku_color0}}
201
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
179
202
  \lstset{basicstyle=\ttfamily\footnotesize}
180
203
  \lstset{language={}}
181
204
 
182
205
  \begin{lstlisting}
183
- *footnotes [^foot]
206
+ * footnotes [^foot]
184
207
 
185
208
  [^foot]: I really was missing those.
186
209
  \end{lstlisting}
@@ -190,7 +213,7 @@ cell&center-align&right-align\\
190
213
 
191
214
  \end{itemize}
192
215
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
193
- \lstset{backgroundcolor=\color{maruku_color0}}
216
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
194
217
  \lstset{basicstyle=\ttfamily\footnotesize}
195
218
  \lstset{language=html}
196
219
 
@@ -203,7 +226,7 @@ cell&center-align&right-align\\
203
226
  \item header ids
204
227
 
205
228
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
206
- \lstset{backgroundcolor=\color{maruku_color0}}
229
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
207
230
  \lstset{basicstyle=\ttfamily\footnotesize}
208
231
  \lstset{language={}}
209
232
 
@@ -215,7 +238,7 @@ cell&center-align&right-align\\
215
238
  \item definition lists
216
239
 
217
240
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
218
- \lstset{backgroundcolor=\color{maruku_color0}}
241
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
219
242
  \lstset{basicstyle=\ttfamily\footnotesize}
220
243
  \lstset{language={}}
221
244
 
@@ -237,14 +260,14 @@ Definition list
237
260
 
238
261
  The other Ruby implementation of Markdown is \href{http://www.deveiate.org/projects/BlueCloth}{Bluecloth}.
239
262
 
240
- Maruku is much different in philosophy from Bluecloth: the biggest difference is that {\em parsing} is separated from {\em rendering}. In Maruku, an in-memory representation of the Markdown document is created. Instead, Bluecloth mantains the document in memory as a String at all times, and does a series of \colorbox{maruku_color0}{\tt \char103\char115\char117\char98} to transform to HTML.\footnote{"a different philosophy" stands for "ugly" \colorbox{maruku_color0}{\tt \char58\char45\char41}}
263
+ Maruku is much different in philosophy from Bluecloth: the biggest difference is that {\em parsing} is separated from {\em rendering}. In Maruku, an in-memory representation of the Markdown document is created. Instead, Bluecloth mantains the document in memory as a String at all times, and does a series of \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char103\char115\char117\char98} to transform to HTML.
241
264
 
242
265
  The in-memory representation makes it very easy to export to various formats (altough, for, now)
243
266
 
244
267
  Other improvements over Bluecloth:
245
268
 
246
269
  \begin{itemize}%
247
- \item the HTML output is provided also as a \colorbox{maruku_color0}{\tt \char82\char69\char88\char77\char76} document tree.
270
+ \item the HTML output is provided also as a \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char82\char69\char88\char77\char76} document tree.
248
271
 
249
272
 
250
273
  \item PHP Markdown Syntax support.
@@ -261,7 +284,7 @@ Maruku implements a syntax that allows to attach "meta" information to objects.
261
284
  Meta-data for the document itself is specified through the use of email headers:
262
285
 
263
286
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
264
- \lstset{backgroundcolor=\color{maruku_color0}}
287
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
265
288
  \lstset{basicstyle=\ttfamily\footnotesize}
266
289
  \lstset{language={}}
267
290
 
@@ -274,7 +297,7 @@ Content of the document
274
297
  \end{lstlisting}When creating the document through
275
298
 
276
299
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
277
- \lstset{backgroundcolor=\color{maruku_color0}}
300
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
278
301
  \lstset{basicstyle=\ttfamily\footnotesize}
279
302
  \lstset{language=ruby}
280
303
 
@@ -290,7 +313,7 @@ Maruku introduces a new syntax for attaching metadata to paragraphs, tables, and
290
313
  For example, consider the creation of two paragraphs:
291
314
 
292
315
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
293
- \lstset{backgroundcolor=\color{maruku_color0}}
316
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
294
317
  \lstset{basicstyle=\ttfamily\footnotesize}
295
318
  \lstset{language={}}
296
319
 
@@ -302,7 +325,7 @@ Paragraph 2
302
325
  \end{lstlisting}Now you really want to attach a 'class' attribute to the paragraphs (for example for CSS styling). Maruku allows you to use:
303
326
 
304
327
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
305
- \lstset{backgroundcolor=\color{maruku_color0}}
328
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
306
329
  \lstset{basicstyle=\ttfamily\footnotesize}
307
330
  \lstset{language={}}
308
331
 
@@ -313,10 +336,10 @@ Paragraph 1 is a warning
313
336
  Paragraph 2
314
337
 
315
338
 
316
- \end{lstlisting}You can add more by separating with a \colorbox{maruku_color0}{\tt \char59}:
339
+ \end{lstlisting}You can add more by separating with a \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char59}:
317
340
 
318
341
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
319
- \lstset{backgroundcolor=\color{maruku_color0}}
342
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
320
343
  \lstset{basicstyle=\ttfamily\footnotesize}
321
344
  \lstset{language={}}
322
345
 
@@ -329,13 +352,13 @@ Paragraph 1 is a warning
329
352
  \begin{enumerate}%
330
353
  \item newline
331
354
  \item an at-symbol '@'
332
- \item a series of name-value pairs. Each name-value is separated by a colon \colorbox{maruku_color0}{\tt \char58}, pairs are separated by semi-colons \colorbox{maruku_color0}{\tt \char59}
355
+ \item a series of name-value pairs. Each name-value is separated by a colon \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char58}, pairs are separated by semi-colons \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char59}
333
356
 
334
357
  \end{enumerate}
335
358
  Many declaration can be used, and they refer to {\em the following} object:
336
359
 
337
360
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
338
- \lstset{backgroundcolor=\color{maruku_color0}}
361
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
339
362
  \lstset{basicstyle=\ttfamily\footnotesize}
340
363
  \lstset{language={}}
341
364
 
@@ -347,7 +370,7 @@ Paragraph 1 is a warning
347
370
  \end{lstlisting}These can also be separated by newlines:
348
371
 
349
372
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
350
- \lstset{backgroundcolor=\color{maruku_color0}}
373
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
351
374
  \lstset{basicstyle=\ttfamily\footnotesize}
352
375
  \lstset{language={}}
353
376
 
@@ -358,10 +381,10 @@ Paragraph 1 is a warning
358
381
 
359
382
  Paragraph 1 is a warning
360
383
 
361
- \end{lstlisting}Also, if the value is not present, it defaults to \colorbox{maruku_color0}{\tt \char116\char114\char117\char101}:
384
+ \end{lstlisting}Also, if the value is not present, it defaults to \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char116\char114\char117\char101}:
362
385
 
363
386
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
364
- \lstset{backgroundcolor=\color{maruku_color0}}
387
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
365
388
  \lstset{basicstyle=\ttfamily\footnotesize}
366
389
  \lstset{language={}}
367
390
 
@@ -376,56 +399,49 @@ This paragraph has the attribute 'test' set.
376
399
 
377
400
  \begin{description}
378
401
 
379
- \item[{\bf \colorbox{maruku_color0}{\tt \char116\char105\char116\char108\char101}, \colorbox{maruku_color0}{\tt \char115\char117\char98\char106\char101\char99\char116}}] (document) Sets the title of the document use in \colorbox{maruku_color0}{\tt \char116\char105\char116\char108\char101} element.
402
+ \item[{\bf \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char116\char105\char116\char108\char101}, \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char115\char117\char98\char106\char101\char99\char116}}] (document) Sets the title of the document (HTML: used in the \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char84\char73\char84\char76\char69} element).
380
403
 
381
404
 
382
405
 
383
- \item[{\bf \colorbox{maruku_color0}{\tt \char99\char115\char115}}] (document, HTML) Url of stylesheet.
406
+ \item[{\bf \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char99\char115\char115}}] (document, HTML) Url of stylesheet.
384
407
 
385
408
 
386
409
 
387
- \item[{\bf \colorbox{maruku_color0}{\tt \char108\char97\char116\char101\char120\char95\char117\char115\char101\char95\char115\char121\char110\char116\char97\char120}}] (document, HTML) Use the [\colorbox{maruku_color0}{\tt \char115\char121\char110\char116\char97\char120} library][syntax] to add source highlighting.
410
+ \item[{\bf \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char104\char116\char109\char108\char95\char117\char115\char101\char95\char115\char121\char110\char116\char97\char120}}] (document, HTML) Use the \href{http://syntax.rubyforge.org/}{\colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char115\char121\char110\char116\char97\char120} library} to add source highlighting.
388
411
 
389
412
 
390
413
 
391
- \item[{\bf \colorbox{maruku_color0}{\tt \char108\char97\char116\char101\char120\char95\char117\char115\char101\char95\char108\char105\char115\char116\char105\char110\char103\char115}}] (document, LaTex) Use fancy \colorbox{maruku_color0}{\tt \char108\char105\char115\char116\char105\char110\char103} package for better displaying code blocks.
414
+ \item[{\bf \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char108\char97\char116\char101\char120\char95\char117\char115\char101\char95\char108\char105\char115\char116\char105\char110\char103\char115}}] (document, LaTex) Use fancy \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char108\char105\char115\char116\char105\char110\char103} package for better displaying code blocks.
392
415
 
393
416
 
394
417
 
395
- \item[{\bf \colorbox{maruku_color0}{\tt \char115\char116\char121\char108\char101}, \colorbox{maruku_color0}{\tt \char105\char100}, \colorbox{maruku_color0}{\tt \char99\char108\char97\char115\char115}}] (any block object, HTML) Standard CSS attributes are copied.
418
+ \item[{\bf \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char115\char116\char121\char108\char101}, \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char105\char100}, \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char99\char108\char97\char115\char115}}] (any block object, HTML) Standard CSS attributes are copied.
396
419
 
397
420
 
398
421
 
399
- \item[{\bf \colorbox{maruku_color0}{\tt \char108\char97\char110\char103}}] (code blocks) Name of programming language (\colorbox{maruku_color0}{\tt \char114\char117\char98\char121}) for syntax highlighting (does not work yet)
422
+ \item[{\bf \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char108\char97\char110\char103}}] (code blocks) Name of programming language (\colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char114\char117\char98\char121}) for syntax highlighting (does not work yet)
400
423
 
401
- Default for this is \colorbox{maruku_color0}{\tt \char99\char111\char100\char101\char95\char108\char97\char110\char103} in document.
424
+ Default for this is \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char99\char111\char100\char101\char95\char108\char97\char110\char103} in document.
402
425
 
403
426
 
404
427
 
405
- \item[{\bf \colorbox{maruku_color0}{\tt \char99\char111\char100\char101\char95\char115\char104\char111\char119\char95\char115\char112\char97\char99\char101\char115}}] Shows tabs and newlines (default is read in the document object).
428
+ \item[{\bf \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char99\char111\char100\char101\char95\char115\char104\char111\char119\char95\char115\char112\char97\char99\char101\char115}}] Shows tabs and newlines (default is read in the document object).
406
429
 
407
430
 
408
431
 
409
- \item[{\bf \colorbox{maruku_color0}{\tt \char99\char111\char100\char101\char95\char98\char97\char99\char107\char103\char114\char111\char117\char110\char100\char95\char99\char111\char108\char111\char114}}] Background color for code blocks. (default is read in the document object).
432
+ \item[{\bf \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char99\char111\char100\char101\char95\char98\char97\char99\char107\char103\char114\char111\char117\char110\char100\char95\char99\char111\char108\char111\char114}}] Background color for code blocks. (default is read in the document object).
410
433
 
411
- The format is either a named color (\colorbox{maruku_color0}{\tt \char103\char114\char101\char101\char110}, \colorbox{maruku_color0}{\tt \char114\char101\char100}) or a CSS color of the form \colorbox{maruku_color0}{\tt \char35\char102\char102\char48\char48\char102\char102}.
434
+ The format is either a named color (\colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char103\char114\char101\char101\char110}, \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char114\char101\char100}) or a CSS color of the form \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char35\char102\char102\char48\char48\char102\char102}.
412
435
 
413
436
  \begin{itemize}%
414
- \item for {\bf HTML output}, the value is put straight in the \colorbox{maruku_color0}{\tt \char98\char97\char99\char107\char103\char114\char111\char117\char110\char100\char45\char99\char111\char108\char111\char114} CSS property of the block.
437
+ \item for {\bf HTML output}, the value is put straight in the \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char98\char97\char99\char107\char103\char114\char111\char117\char110\char100\char45\char99\char111\char108\char111\char114} CSS property of the block.
415
438
 
416
439
 
417
- \item for {\bf LaTeX output}, if it is a named color, it must be a color accepted by the latex \colorbox{maruku_color0}{\tt \char99\char111\char108\char111\char114} packages. If it is of the form \colorbox{maruku_color0}{\tt \char35\char102\char102\char48\char48\char102\char102}, Maruku defines a color using the \colorbox{maruku_color0}{\tt \char92\char100\char101\char102\char105\char110\char101\char99\char111\char108\char111\char114} macro.
440
+ \item for {\bf LaTeX output}, if it is a named color, it must be a color accepted by the latex \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char99\char111\char108\char111\char114} packages. If it is of the form \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char35\char102\char102\char48\char48\char102\char102}, Maruku defines a color using the \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char92\char99\char111\char108\char111\char114\char91\char114\char103\char98\char93\char123\char114\char44\char103\char44\char98\char125} macro.
418
441
 
419
- For example, for \colorbox{maruku_color0}{\tt \char35\char48\char48\char48\char48\char102\char102}, the macro is called as:
442
+ For example, for \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char35\char48\char48\char48\char48\char102\char102}, the macro is called as: \colorbox[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}{\tt \char92\char99\char111\char108\char111\char114\char91\char114\char103\char98\char93\char123\char48\char44\char48\char44\char49\char125}.
420
443
 
421
- \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
422
- \lstset{backgroundcolor=\color{maruku_color0}}
423
- \lstset{basicstyle=\ttfamily\footnotesize}
424
- \lstset{language=tex}
425
444
 
426
- \begin{lstlisting}
427
- \definecolor{DummyName}{rgb}{0,0,1}
428
- \end{lstlisting}
429
445
 
430
446
  \end{itemize}
431
447
 
@@ -435,7 +451,7 @@ For example, for \colorbox{maruku_color0}{\tt \char35\char48\char48\char48\char4
435
451
  An example of this is the following:
436
452
 
437
453
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=true,showtabs=true}
438
- \lstset{backgroundcolor=\color{maruku_color0}}
454
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
439
455
  \lstset{basicstyle=\ttfamily\footnotesize}
440
456
  \lstset{language={}}
441
457
 
@@ -463,7 +479,7 @@ An example of this is the following:
463
479
  \end{lstlisting}Example with css-style color:
464
480
 
465
481
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
466
- \lstset{backgroundcolor=\color{maruku_color0}}
482
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
467
483
  \lstset{basicstyle=\ttfamily\footnotesize}
468
484
  \lstset{language={}}
469
485
 
@@ -475,8 +491,7 @@ An example of this is the following:
475
491
  \end{lstlisting}produces:
476
492
 
477
493
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
478
- \definecolor{maruku_color1}{rgb}{0.270588235294118,0.337254901960784,0.470588235294118}
479
- \lstset{backgroundcolor=\color{maruku_color1}}
494
+ \lstset{backgroundcolor=\color[rgb]{0.270588235294118,0.337254901960784,0.470588235294118}}
480
495
  \lstset{basicstyle=\ttfamily\footnotesize}
481
496
  \lstset{language={}}
482
497
 
@@ -486,7 +501,7 @@ A strange color
486
501
  \end{lstlisting}Or highlighting (does not work well yet):
487
502
 
488
503
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
489
- \lstset{backgroundcolor=\color{maruku_color0}}
504
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
490
505
  \lstset{basicstyle=\ttfamily\footnotesize}
491
506
  \lstset{language={}}
492
507
 
@@ -497,7 +512,7 @@ A strange color
497
512
  \end{lstlisting}produces:
498
513
 
499
514
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
500
- \lstset{backgroundcolor=\color{maruku_color0}}
515
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
501
516
  \lstset{basicstyle=\ttfamily\footnotesize}
502
517
  \lstset{language=xml}
503
518
 
@@ -518,7 +533,7 @@ Things I'm thinking about:
518
533
  \item a syntax for commenting parts of the document:
519
534
 
520
535
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
521
- \lstset{backgroundcolor=\color{maruku_color0}}
536
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
522
537
  \lstset{basicstyle=\ttfamily\footnotesize}
523
538
  \lstset{language={}}
524
539
 
@@ -529,7 +544,7 @@ This is a paragraph
529
544
  \item choose a syntax for adding math:
530
545
 
531
546
  \lstset{columns=fixed,frame=shadowbox}\lstset{showspaces=false,showtabs=false}
532
- \lstset{backgroundcolor=\color{maruku_color0}}
547
+ \lstset{backgroundcolor=\color[rgb]{0.941176470588235,0.941176470588235,0.87843137254902}}
533
548
  \lstset{basicstyle=\ttfamily\footnotesize}
534
549
  \lstset{language={}}
535
550