man/tumblr.5.html in tumblr-rb-1.3.0 vs man/tumblr.5.html in tumblr-rb-2.0.0.alpha
- old
+ new
@@ -1,93 +1,99 @@
<!DOCTYPE html>
<html>
<head>
<meta http-equiv='content-type' value='text/html;charset=utf8'>
- <meta name='generator' value='Ronn/v0.4.1'>
- <title>tumblr(5) -- tumblr posts in plaintext</title>
- <style type='text/css'>
- body {margin:0}
- #man, #man code, #man pre, #man tt, #man kbd, #man samp {
- font-family:consolas,monospace;
- font-size:16px;
- line-height:1.3;
- color:#343331;
- background:#fff; }
- #man { max-width:89ex; text-align:justify; margin:0 25px 25px 25px }
- #man h1, #man h2, #man h3 { color:#232221;clear:left }
- #man h1 { font-size:28px; margin:15px 0 30px 0; text-align:center }
- #man h2 { font-size:18px; margin-bottom:0; margin-top:10px; line-height:1.3; }
- #man h3 { font-size:16px; margin:0 0 0 4ex; }
- #man p, #man ul, #man ol, #man dl, #man pre { margin:0 0 18px 0; }
- #man pre {
- color:#333231;
- background:#edeceb;
- padding:5px 7px;
- margin:0px 0 20px 0;
- border-left:2ex solid #ddd}
- #man pre + h2, #man pre + h3 {
- margin-top:22px;
- }
- #man h2 + pre, #man h3 + pre {
- margin-top:5px;
- }
- #man > p, #man > ul, #man > ol, #man > dl, #man > pre { margin-left:8ex; }
- #man dt { margin:0; clear:left }
- #man dt.flush { float:left; width:8ex }
- #man dd { margin:0 0 0 9ex }
- #man code, #man strong, #man b { font-weight:bold; color:#131211; }
- #man pre code { font-weight:normal; color:#232221; background:inherit }
- #man em, var, u {
- font-style:normal; color:#333231; border-bottom:1px solid #999; }
- #man h1.man-title { display:none; }
- #man ol.man, #man ol.man li { margin:2px 0 10px 0; padding:0;
- float:left; width:33%; list-style-type:none;
- text-transform:uppercase; font-size:18px; color:#999;
- letter-spacing:1px;}
- #man ol.man { width:100%; }
- #man ol.man li.tl { text-align:left }
- #man ol.man li.tc { text-align:center;letter-spacing:4px }
- #man ol.man li.tr { text-align:right }
- #man ol.man a { color:#999 }
- #man ol.man a:hover { color:#333231 }
+ <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
+ <title>tumblr(5) - tumblr posts in plaintext</title>
+ <style type='text/css' media='all'>
+ /* style: man */
+ body#manpage {margin:0}
+ .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
+ .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
+ .mp h2 {margin:10px 0 0 0}
+ .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
+ .mp h3 {margin:0 0 0 4ex}
+ .mp dt {margin:0;clear:left}
+ .mp dt.flush {float:left;width:8ex}
+ .mp dd {margin:0 0 0 9ex}
+ .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
+ .mp pre {margin-bottom:20px}
+ .mp pre+h2,.mp pre+h3 {margin-top:22px}
+ .mp h2+pre,.mp h3+pre {margin-top:5px}
+ .mp img {display:block;margin:auto}
+ .mp h1.man-title {display:none}
+ .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
+ .mp h2 {font-size:16px;line-height:1.25}
+ .mp h1 {font-size:20px;line-height:2}
+ .mp {text-align:justify;background:#fff}
+ .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
+ .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
+ .mp u {text-decoration:underline}
+ .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
+ .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
+ .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
+ .mp b.man-ref {font-weight:normal;color:#434241}
+ .mp pre {padding:0 4ex}
+ .mp pre code {font-weight:normal;color:#434241}
+ .mp h2+pre,h3+pre {padding-left:0}
+ ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
+ ol.man-decor {width:100%}
+ ol.man-decor li.tl {text-align:left}
+ ol.man-decor li.tc {text-align:center;letter-spacing:4px}
+ ol.man-decor li.tr {text-align:right;float:right}
</style>
</head>
-<body>
-<div id='man'>
+<!--
+ The following styles are deprecated and will be removed at some point:
+ div#man, div#man ol.man, div#man ol.head, div#man ol.man.
-<h1 class='man-title'>tumblr(5)</h1>
+ The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
+ .man-navigation should be used instead.
+-->
+<body id='manpage'>
+ <div class='mp' id='man'>
-<ol class='head man'>
- <li class='tl'>tumblr(5)</li>
- <li class='tc'>Tumblr Manual</li>
- <li class='tr'>tumblr(5)</li>
-</ol>
+ <div class='man-navigation' style='display:none'>
+ <a href="#NAME">NAME</a>
+ <a href="#SYNOPSIS">SYNOPSIS</a>
+ <a href="#DESCRIPTION">DESCRIPTION</a>
+ <a href="#BASIC-PARAMETERS">BASIC PARAMETERS</a>
+ <a href="#POST-TYPE-SPECIFIC-PARAMETERS">POST-TYPE SPECIFIC PARAMETERS</a>
+ <a href="#SEE-ALSO">SEE ALSO</a>
+ </div>
-<h2 id='NAME'>NAME</h2>
-<p><code>tumblr</code> -- tumblr posts in plaintext</p>
+ <ol class='man-decor man-head man head'>
+ <li class='tl'>tumblr(5)</li>
+ <li class='tc'>Tumblr Manual</li>
+ <li class='tr'>tumblr(5)</li>
+ </ol>
-<h2>SYNOPSIS</h2>
+ <h2 id="NAME">NAME</h2>
+<p class="man-name">
+ <code>tumblr</code> - <span class="man-whatis">tumblr posts in plaintext</span>
+</p>
+<h2 id="SYNOPSIS">SYNOPSIS</h2>
+
<pre><code>---
title: A typical Tumblr post
state: queue
-publish-on: next tuesday
tags: unix, manpages
format: markdown
---
-This will create a *Regular* type of post on Tumblr.com. It's so easy.
-That bit up at the top is called YAML frontmatter, and it just gives the
+This will create a *Regular* type of post on Tumblr.com. It's so easy.
+That bit up at the top is called YAML frontmatter, and it just gives the
post a bit of metadata, so publishing options are more flexible.
-They correspond to the Tumblr API. This post will be added to your Tumblr
-queue, to be published next Tuesday, tagged with "unix" and "manpages",
+They correspond to the Tumblr API. This post will be added to your Tumblr
+queue, to be published next Tuesday, tagged with "unix" and "manpages",
and formatted in markdown.
</code></pre>
-<h2>DESCRIPTION</h2>
+<h2 id="DESCRIPTION">DESCRIPTION</h2>
-<p>Any file can be published to Tumblr.com as a <i>Regular</i> post, but if you add a bit of YAML frontmatter (<yaml.org>) to the file, you can tell Tumblr exactly what you want to do.</p>
+<p>Any plaintext file can be published to Tumblr.com as a <i>Text</i> post, but if you add a bit of YAML frontmatter (<yaml.org>) to the file, you can tell Tumblr exactly what you want to do.</p>
<p>YAML frontmatter beings with <code>---</code> on a single line, followed by YAML, ending with another <code>---</code> on a single line, e.g.</p>
<pre><code>---
type: quote
@@ -96,68 +102,54 @@
tags: hamlet, shakespeare
---
"To be or not to be."
</code></pre>
-<p>Understood YAML parameters are documented and taken from the Tumblr API: http://www.tumblr.com/docs/en/api#api_write</p>
+<p>Understood YAML parameters are documented and taken from the Tumblr API: http://www.tumblr.com/docs/en/api/v2#posting</p>
-<h2>BASIC PARAMETERS</h2>
+<h2 id="BASIC-PARAMETERS">BASIC PARAMETERS</h2>
<p>These YAML parameters are available for all posts</p>
-<ul>
-<li><p><code>type</code>:
- <code>regular</code>, <code>photo</code>, <code>link</code>, <code>quote</code>, <code>conversation</code>, <code>video</code>, <code>audio</code>
+<dl>
+<dt class="flush"><code>type</code></dt><dd><p> <code>text</code>, <code>photo</code>, <code>quote</code>, <code>link</code>, <code>chat</code>, <code>audio</code>, <code>video</code>
Will take a guess if omitted.
- See <em>POST-TYPE SPECIFIC PARAMETERS</em> below.</p></li>
-<li><p><code>state</code>:
- <code>published</code>, <code>draft</code>, <code>queue</code>, <code>submission</code></p></li>
-<li><p><code>format</code>:
- <code>html</code> or <code>markdown</code></p></li>
-<li><p><code>tags</code>: <br />
- Comma-separated list of tags.</p></li>
-<li><p><code>date</code>:
- Post date.</p></li>
-<li><p><code>private</code>:
- If the post should be marked private.</p></li>
-<li><p><code>slug</code>:
- A custom string to appear in the post's url.</p></li>
-<li><p><code>group</code>:
- ID for a secondary blog.</p></li>
-<li><p><code>generator</code>:
- Short description of the publishing application.</p></li>
-<li><p><code>send-to-twitter</code>:
- Twitter status update to make if the tumblelog has enabled it.</p></li>
-<li><p><code>publish-on</code>:
- If the post state is 'queue', publish on this date</p></li>
-</ul>
+ See <em>POST-TYPE SPECIFIC PARAMETERS</em> below.</p></dd>
+<dt class="flush"><code>state</code></dt><dd><p> <code>published</code>, <code>draft</code>, <code>queue</code>, <code>private</code></p></dd>
+<dt class="flush"><code>format</code></dt><dd><p> <code>html</code> or <code>markdown</code>
+ Defaults to <code>markdown</code></p></dd>
+<dt class="flush"><code>tags</code></dt><dd><p> Comma-separated list of tags.</p></dd>
+<dt class="flush"><code>date</code></dt><dd><p> Post date.</p></dd>
+<dt class="flush"><code>slug</code></dt><dd><p> A custom string to appear in the post's url.</p></dd>
+<dt class="flush"><code>tweet</code></dt><dd><p> Manages the autotweet (if enabled) for this post</p></dd>
+</dl>
-<h2>POST-TYPE SPECIFIC PARAMETERS</h2>
+<h2 id="POST-TYPE-SPECIFIC-PARAMETERS">POST-TYPE SPECIFIC PARAMETERS</h2>
<p>These are parameters that are available for specific types of posts.</p>
<dl>
-<dt class="flush"><code>regular</code></dt><dd><p> <code>title</code></p></dd>
-<dt class="flush"><code>photo</code></dt><dd><p> <code>caption</code>, <code>click-through-url</code></p></dd>
-<dt class="flush"><code>quote</code></dt><dd><p> <code>source</code></p></dd>
-<dt class="flush"><code>link</code></dt><dd><p> <code>name</code>, <code>description</code></p></dd>
-<dt><code>conversation</code></dt><dd><p> <code>title</code></p></dd>
-<dt class="flush"><code>video</code></dt><dd><p> <code>title</code>,<code>caption</code></p></dd>
-<dt class="flush"><code>audio</code></dt><dd><p> <code>caption</code></p></dd>
+<dt class="flush"><code>text</code></dt><dd><p> <code>title</code>, <code>body</code></p></dd>
+<dt class="flush"><code>photo</code></dt><dd><p> <code>caption</code>, <code>link</code>, <code>source</code>, <code>data</code></p></dd>
+<dt class="flush"><code>quote</code></dt><dd><p> <code>quote</code>, <code>source</code></p></dd>
+<dt class="flush"><code>link</code></dt><dd><p> <code>title</code>, <code>url</code>, <code>description</code></p></dd>
+<dt class="flush"><code>chat</code></dt><dd><p> <code>title</code>,<code>conversation</code></p></dd>
+<dt class="flush"><code>audio</code></dt><dd><p> <code>caption</code>, <code>external_url</code>, <code>data</code></p></dd>
+<dt class="flush"><code>video</code></dt><dd><p> <code>caption</code>, <code>embed</code>, <code>data</code></p></dd>
</dl>
-<h2>SEE ALSO</h2>
+<h2 id="SEE-ALSO">SEE ALSO</h2>
-<p>tumblr(1), markdown(5)</p>
+<p><a class="man-ref" href="tumblr.1.html">tumblr<span class="s">(1)</span></a>, <span class="man-ref">markdown<span class="s">(5)</span></span></p>
-<ol class='foot man'>
- <li class='tl'>Mark Wunsch</li>
- <li class='tc'>March 2010</li>
- <li class='tr'>tumblr(5)</li>
-</ol>
+ <ol class='man-decor man-foot man foot'>
+ <li class='tl'>Mark Wunsch</li>
+ <li class='tc'>October 2012</li>
+ <li class='tr'>tumblr(5)</li>
+ </ol>
-</div>
+ </div>
</body>
</html>