man/man0/README.html in md2man-2.1.1 vs man/man0/README.html in md2man-3.0.0
- old
+ new
@@ -1,122 +1,122 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
- <meta name="generator" content="md2man 2.1.1 https://github.com/sunaku/md2man" />
+ <meta name="generator" content="md2man 3.0.0 https://github.com/sunaku/md2man" />
<title>README</title>
<link rel="stylesheet" href="../style.css"/>
<!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
</head>
-<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man0">man0</a>/README</span></div></div><div class="container-fluid"><h1 id="md2man-markdown-to-manpage"><span class="md2man-title">md2man</span> <span class="md2man-section">-</span> <span class="md2man-date">markdown</span> <span class="md2man-source">to</span> <span class="md2man-manual">manpage</span><a name="md2man-markdown-to-manpage" href="#md2man-markdown-to-manpage" class="md2man-permalink"></a></h1><p>md2man is a Ruby library and a set of command-line programs that convert
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man0">man0</a>/README</span></div></div><div class="container-fluid"><h1 id="md2man-markdown-to-manpage"><a name="md2man-markdown-to-manpage" href="#md2man-markdown-to-manpage" class="md2man-permalink" title="permalink"></a><span class="md2man-title">md2man</span> <span class="md2man-section">-</span> <span class="md2man-date">markdown</span> <span class="md2man-source">to</span> <span class="md2man-manual">manpage</span></h1><p>md2man is a Ruby library and a set of command-line programs that convert
<a href="http://daringfireball.net/projects/markdown/">Markdown</a> into UNIX manual pages (both <a href="http://troff.org">roff</a> and HTML) using <a href="https://github.com/vmg/redcarpet">Redcarpet</a>.</p>
<ul>
<li>Package: <a href="https://rubygems.org/gems/md2man">https://rubygems.org/gems/md2man</a></li>
<li>Manuals: <a href="https://sunaku.github.io/md2man">https://sunaku.github.io/md2man</a></li>
<li>Sources: <a href="https://github.com/sunaku/md2man">https://github.com/sunaku/md2man</a></li>
<li>Support: <a href="https://github.com/sunaku/md2man/issues">https://github.com/sunaku/md2man/issues</a></li>
</ul>
-<h2 id="Features">Features<a name="Features" href="#Features" class="md2man-permalink"></a></h2>
+<h2 id="features"><a name="features" href="#features" class="md2man-permalink" title="permalink"></a>Features</h2>
<ul>
<li><p>Formats tagged and indented paragraphs (see "document format" below).</p></li>
<li><p>Translates all HTML4 and XHTML1 entities into native <a href="http://troff.org">roff</a> equivalents.</p></li>
<li><p>Supports markdown extensions such as <a href="http://michelf.com/projects/php-markdown/extra/#table">PHP Markdown Extra tables</a>.</p></li>
<li><p>Usable from the command line as a filter in a UNIX command pipeline.</p></li>
</ul>
-<h3 id="Demonstration">Demonstration<a name="Demonstration" href="#Demonstration" class="md2man-permalink"></a></h3><p>Try converting <a href="https://raw.github.com/sunaku/md2man/master/EXAMPLE.markdown">this example Markdown file</a> into a UNIX manual page:</p>
+<h3 id="demonstration"><a name="demonstration" href="#demonstration" class="md2man-permalink" title="permalink"></a>Demonstration</h3><p>Try converting <a href="https://raw.github.com/sunaku/md2man/master/EXAMPLE.markdown">this example Markdown file</a> into a UNIX manual page:</p>
<pre><code>md2man-roff EXAMPLE.markdown > EXAMPLE.1
man -l EXAMPLE.1
</code></pre>
<p><img src="EXAMPLE.png" alt="Obligatory screenshot of md2man(1) in action!"></p><p>Also try converting <a href="https://raw.github.com/sunaku/md2man/master/EXAMPLE.markdown">that example Markdown file</a> into a web page:</p>
<pre><code>md2man-html EXAMPLE.markdown > EXAMPLE.html
open EXAMPLE.html
</code></pre>
-<h2 id="Installation">Installation<a name="Installation" href="#Installation" class="md2man-permalink"></a></h2>
+<h2 id="installation"><a name="installation" href="#installation" class="md2man-permalink" title="permalink"></a>Installation</h2>
<pre><code>gem install md2man
</code></pre>
-<h3 id="Development">Development<a name="Development" href="#Development" class="md2man-permalink"></a></h3>
+<h3 id="development"><a name="development" href="#development" class="md2man-permalink" title="permalink"></a>Development</h3>
<pre><code>git clone git://github.com/sunaku/md2man
cd md2man
bundle install
bundle exec rake --tasks # packaging tasks
bundle exec md2man-roff --help # run it directly
bundle exec md2man-html --help # run it directly
</code></pre>
-<h2 id="Usage">Usage<a name="Usage" href="#Usage" class="md2man-permalink"></a></h2><h3 id="For-roff-output">For <a href="http://troff.org">roff</a> output<a name="For-roff-output" href="#For-roff-output" class="md2man-permalink"></a></h3><h4 id="At-the-command-line">At the command line<a name="At-the-command-line" href="#At-the-command-line" class="md2man-permalink"></a></h4><p>See <a class="md2man-xref" href="../man1/md2man-roff.1.html">md2man-roff(1)</a> manual:</p>
+<h2 id="usage"><a name="usage" href="#usage" class="md2man-permalink" title="permalink"></a>Usage</h2><h3 id="for-roff-output"><a name="for-roff-output" href="#for-roff-output" class="md2man-permalink" title="permalink"></a>For <a href="http://troff.org">roff</a> output</h3><h4 id="at-the-command-line"><a name="at-the-command-line" href="#at-the-command-line" class="md2man-permalink" title="permalink"></a>At the command line</h4><p>See <a class="md2man-reference" href="../man1/md2man-roff.1.html">md2man-roff(1)</a> manual:</p>
<pre><code>md2man-roff --help
</code></pre>
-<h4 id="Inside-a-Ruby-script">Inside a Ruby script<a name="Inside-a-Ruby-script" href="#Inside-a-Ruby-script" class="md2man-permalink"></a></h4><p>Use the default renderer:</p>
+<h4 id="inside-a-ruby-script"><a name="inside-a-ruby-script" href="#inside-a-ruby-script" class="md2man-permalink" title="permalink"></a>Inside a Ruby script</h4><p>Use the default renderer:</p>
<pre><code>require 'md2man/roff/engine'
-your_roff_output = Md2Man::Roff::<a class="md2man-xref">ENGINE.render(your_markdown_input)</a>
+your_roff_output = Md2Man::Roff::<a class="md2man-reference">ENGINE.render(your_markdown_input)</a>
</code></pre>
<p>Build your own renderer:</p>
<pre><code>require 'md2man/roff/engine'
engine = Redcarpet::Markdown.new(Md2Man::Roff::Engine, your_options_hash)
-your_roff_output = <a class="md2man-xref">engine.render(your_markdown_input)</a>
+your_roff_output = <a class="md2man-reference">engine.render(your_markdown_input)</a>
</code></pre>
<p>Define your own renderer:</p>
<pre><code>require 'md2man/roff/engine'
class YourManpageRenderer < Md2Man::Roff::Engine
# ... your stuff here ...
end
engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
-your_roff_output = <a class="md2man-xref">engine.render(your_markdown_input)</a>
+your_roff_output = <a class="md2man-reference">engine.render(your_markdown_input)</a>
</code></pre>
<p>Mix-in your own renderer:</p>
<pre><code>require 'md2man/roff'
class YourManpageRenderer < Redcarpet::Render::Base
include Md2Man::Roff
# ... your stuff here ...
end
engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
-your_roff_output = <a class="md2man-xref">engine.render(your_markdown_input)</a>
+your_roff_output = <a class="md2man-reference">engine.render(your_markdown_input)</a>
</code></pre>
-<h3 id="For-HTML-output">For HTML output<a name="For-HTML-output" href="#For-HTML-output" class="md2man-permalink"></a></h3><h4 id="At-the-command-line">At the command line<a name="At-the-command-line" href="#At-the-command-line" class="md2man-permalink"></a></h4><p>See <a class="md2man-xref" href="../man1/md2man-html.1.html">md2man-html(1)</a> manual:</p>
+<h3 id="for-html-output"><a name="for-html-output" href="#for-html-output" class="md2man-permalink" title="permalink"></a>For HTML output</h3><h4 id="at-the-command-line-1"><a name="at-the-command-line-1" href="#at-the-command-line-1" class="md2man-permalink" title="permalink"></a>At the command line</h4><p>See <a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a> manual:</p>
<pre><code>md2man-html --help
</code></pre>
-<h4 id="Inside-a-Ruby-script">Inside a Ruby script<a name="Inside-a-Ruby-script" href="#Inside-a-Ruby-script" class="md2man-permalink"></a></h4><p>Use the default renderer:</p>
+<h4 id="inside-a-ruby-script-1"><a name="inside-a-ruby-script-1" href="#inside-a-ruby-script-1" class="md2man-permalink" title="permalink"></a>Inside a Ruby script</h4><p>Use the default renderer:</p>
<pre><code>require 'md2man/html/engine'
-your_html_output = Md2Man::HTML::<a class="md2man-xref">ENGINE.render(your_markdown_input)</a>
+your_html_output = Md2Man::HTML::<a class="md2man-reference">ENGINE.render(your_markdown_input)</a>
</code></pre>
<p>Build your own renderer:</p>
<pre><code>require 'md2man/html/engine'
engine = Redcarpet::Markdown.new(Md2Man::HTML::Engine, your_options_hash)
-your_html_output = <a class="md2man-xref">engine.render(your_markdown_input)</a>
+your_html_output = <a class="md2man-reference">engine.render(your_markdown_input)</a>
</code></pre>
<p>Define your own renderer:</p>
<pre><code>require 'md2man/html/engine'
class YourManpageRenderer < Md2Man::HTML::Engine
# ... your stuff here ...
end
engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
-your_html_output = <a class="md2man-xref">engine.render(your_markdown_input)</a>
+your_html_output = <a class="md2man-reference">engine.render(your_markdown_input)</a>
</code></pre>
<p>Mix-in your own renderer:</p>
<pre><code>require 'md2man/html'
class YourManpageRenderer < Redcarpet::Render::Base
include Md2Man::HTML
# ... your stuff here ...
end
engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
-your_html_output = <a class="md2man-xref">engine.render(your_markdown_input)</a>
+your_html_output = <a class="md2man-reference">engine.render(your_markdown_input)</a>
</code></pre>
-<h3 id="Building-man-pages">Building man pages<a name="Building-man-pages" href="#Building-man-pages" class="md2man-permalink"></a></h3><h4 id="At-the-command-line">At the command line<a name="At-the-command-line" href="#At-the-command-line" class="md2man-permalink"></a></h4><p>See <a class="md2man-xref" href="../man1/md2man-rake.1.html">md2man-rake(1)</a> manual:</p>
+<h3 id="building-man-pages"><a name="building-man-pages" href="#building-man-pages" class="md2man-permalink" title="permalink"></a>Building man pages</h3><h4 id="at-the-command-line-2"><a name="at-the-command-line-2" href="#at-the-command-line-2" class="md2man-permalink" title="permalink"></a>At the command line</h4><p>See <a class="md2man-reference" href="../man1/md2man-rake.1.html">md2man-rake(1)</a> manual:</p>
<pre><code>md2man-rake --help
</code></pre>
-<h4 id="Inside-a-Ruby-script">Inside a Ruby script<a name="Inside-a-Ruby-script" href="#Inside-a-Ruby-script" class="md2man-permalink"></a></h4><p>Add this snippet to your gemspec file:</p>
+<h4 id="inside-a-ruby-script-2"><a name="inside-a-ruby-script-2" href="#inside-a-ruby-script-2" class="md2man-permalink" title="permalink"></a>Inside a Ruby script</h4><p>Add this snippet to your gemspec file:</p>
<pre><code>s.files += Dir['man/man?/*.?'] # UNIX man pages
s.files += Dir['man/**/*.{html,css,js}'] # HTML man pages
s.add_development_dependency 'md2man', '~> 2.0'
</code></pre>
<p>Add this line to your Rakefile:</p>
@@ -127,7 +127,7 @@
There are also sub-tasks to build manual pages individually as <a href="http://troff.org">roff</a> or HTML.</p><p>If you're using Bundler, this task also hooks into Bundler's gem packaging
tasks and ensures that your manual pages are built for packaging into a gem:</p>
<pre><code>bundle exec rake build
gem spec pkg/*.gem | fgrep man/
</code></pre>
-<h2 id="License">License<a name="License" href="#License" class="md2man-permalink"></a></h2><p>Released under the ISC license. See the LICENSE file for details.</p></div></body>
+<h2 id="license"><a name="license" href="#license" class="md2man-permalink" title="permalink"></a>License</h2><p>Released under the ISC license. See the LICENSE file for details.</p></div></body>
</html>