tumblr-rb 1.3.0 → 2.0.0.alpha
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/.travis.yml +7 -0
- data/Gemfile +15 -8
- data/Gemfile.lock +65 -65
- data/LICENSE +4 -2
- data/README.md +31 -84
- data/Rakefile +8 -68
- data/bin/tumblr +3 -133
- data/lib/tumblr.rb +7 -184
- data/lib/tumblr/authentication.rb +71 -0
- data/lib/tumblr/client.rb +148 -0
- data/lib/tumblr/command_line_interface.rb +222 -0
- data/lib/tumblr/credentials.rb +31 -0
- data/lib/tumblr/post.rb +253 -171
- data/lib/tumblr/post/answer.rb +17 -0
- data/lib/tumblr/post/audio.rb +22 -10
- data/lib/tumblr/post/chat.rb +25 -0
- data/lib/tumblr/post/link.rb +22 -9
- data/lib/tumblr/post/photo.rb +29 -10
- data/lib/tumblr/post/quote.rb +17 -10
- data/lib/tumblr/post/text.rb +18 -0
- data/lib/tumblr/post/video.rb +26 -11
- data/lib/tumblr/version.rb +3 -0
- data/lib/tumblr/views/error.erb +6 -0
- data/lib/tumblr/views/form.erb +11 -0
- data/lib/tumblr/views/layout.erb +41 -0
- data/lib/tumblr/views/success.erb +6 -0
- data/man/tumblr.1 +67 -65
- data/man/tumblr.1.html +131 -108
- data/man/tumblr.1.ronn +76 -57
- data/man/tumblr.5 +48 -68
- data/man/tumblr.5.html +106 -114
- data/man/tumblr.5.ronn +38 -51
- data/spec/fixtures/posts.json +10 -0
- data/spec/fixtures/typical_animated_gif.gif +0 -0
- data/spec/spec_helper.rb +12 -0
- data/spec/tumblr/authentication_spec.rb +57 -0
- data/spec/tumblr/client_spec.rb +223 -0
- data/spec/tumblr/credentials_spec.rb +63 -0
- data/spec/tumblr/post_spec.rb +125 -0
- data/tumblr-rb.gemspec +16 -89
- metadata +101 -102
- data/lib/tumblr/authenticator.rb +0 -18
- data/lib/tumblr/post/conversation.rb +0 -15
- data/lib/tumblr/post/regular.rb +0 -14
- data/lib/tumblr/reader.rb +0 -191
- data/lib/tumblr/writer.rb +0 -39
- data/test/fixtures/vcr_cassettes/authenticate/authenticate.yml +0 -39
- data/test/fixtures/vcr_cassettes/read/all_pages.yml +0 -34
- data/test/fixtures/vcr_cassettes/read/authenticated.yml +0 -40
- data/test/fixtures/vcr_cassettes/read/authentication_failure.yml +0 -33
- data/test/fixtures/vcr_cassettes/read/like.yml +0 -31
- data/test/fixtures/vcr_cassettes/read/mwunsch.yml +0 -101
- data/test/fixtures/vcr_cassettes/read/optional.yml +0 -48
- data/test/fixtures/vcr_cassettes/read/pages.yml +0 -36
- data/test/fixtures/vcr_cassettes/read/tumblrgemtest.yml +0 -42
- data/test/fixtures/vcr_cassettes/read/unlike.yml +0 -31
- data/test/fixtures/vcr_cassettes/write/delete.yml +0 -31
- data/test/fixtures/vcr_cassettes/write/edit.yml +0 -31
- data/test/fixtures/vcr_cassettes/write/reblog.yml +0 -31
- data/test/fixtures/vcr_cassettes/write/write.yml +0 -31
- data/test/helper.rb +0 -44
- data/test/test_tumblr.rb +0 -710
data/man/tumblr.5
CHANGED
@@ -1,137 +1,117 @@
|
|
1
|
-
.\" generated with Ronn/v0.
|
2
|
-
.\" http://github.com/rtomayko/ronn/
|
1
|
+
.\" generated with Ronn/v0.7.3
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "TUMBLR" "5" "
|
4
|
+
.TH "TUMBLR" "5" "October 2012" "Mark Wunsch" "Tumblr Manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
|
-
\fBtumblr\fR
|
7
|
+
\fBtumblr\fR \- tumblr posts in plaintext
|
8
8
|
.
|
9
9
|
.SH "SYNOPSIS"
|
10
10
|
.
|
11
11
|
.nf
|
12
|
+
|
12
13
|
\-\-\-
|
13
14
|
title: A typical Tumblr post
|
14
15
|
state: queue
|
15
|
-
publish\-on: next tuesday
|
16
16
|
tags: unix, manpages
|
17
17
|
format: markdown
|
18
18
|
\-\-\-
|
19
|
-
|
19
|
+
|
20
|
+
This will create a *Regular* type of post on Tumblr\.com\. It\'s so easy\.
|
20
21
|
That bit up at the top is called YAML frontmatter, and it just gives the
|
21
|
-
post a bit of metadata, so publishing options are more flexible
|
22
|
-
They correspond to the Tumblr API
|
22
|
+
post a bit of metadata, so publishing options are more flexible\.
|
23
|
+
They correspond to the Tumblr API\. This post will be added to your Tumblr
|
23
24
|
queue, to be published next Tuesday, tagged with "unix" and "manpages",
|
24
|
-
and formatted in markdown
|
25
|
+
and formatted in markdown\.
|
25
26
|
.
|
26
27
|
.fi
|
27
28
|
.
|
28
29
|
.SH "DESCRIPTION"
|
29
|
-
Any file can be published to Tumblr
|
30
|
+
Any plaintext file can be published to Tumblr\.com as a \fIText\fR 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\.
|
30
31
|
.
|
31
32
|
.P
|
32
|
-
YAML frontmatter beings with \fB\-\-\-\fR on a single line, followed by YAML, ending with another \fB\-\-\-\fR on a single line, e
|
33
|
+
YAML frontmatter beings with \fB\-\-\-\fR on a single line, followed by YAML, ending with another \fB\-\-\-\fR on a single line, e\.g\.
|
33
34
|
.
|
34
35
|
.IP "" 4
|
35
36
|
.
|
36
37
|
.nf
|
38
|
+
|
37
39
|
\-\-\-
|
38
40
|
type: quote
|
39
41
|
source: Billy Shakespeare
|
40
42
|
state: draft
|
41
43
|
tags: hamlet, shakespeare
|
42
44
|
\-\-\-
|
43
|
-
"To be or not to be
|
45
|
+
"To be or not to be\."
|
44
46
|
.
|
45
47
|
.fi
|
46
48
|
.
|
47
49
|
.IP "" 0
|
48
50
|
.
|
49
51
|
.P
|
50
|
-
Understood YAML parameters are documented and taken from the Tumblr API: http://www
|
52
|
+
Understood YAML parameters are documented and taken from the Tumblr API: http://www\.tumblr\.com/docs/en/api/v2#posting
|
51
53
|
.
|
52
54
|
.SH "BASIC PARAMETERS"
|
53
55
|
These YAML parameters are available for all posts
|
54
56
|
.
|
55
|
-
.
|
56
|
-
\fBtype\fR
|
57
|
-
|
58
|
-
Will take a guess if omitted.
|
59
|
-
See \fIPOST\-TYPE SPECIFIC PARAMETERS\fR below.
|
60
|
-
.
|
61
|
-
.IP "\(bu" 4
|
62
|
-
\fBstate\fR:
|
63
|
-
\fBpublished\fR, \fBdraft\fR, \fBqueue\fR, \fBsubmission\fR
|
64
|
-
.
|
65
|
-
.IP "\(bu" 4
|
66
|
-
\fBformat\fR:
|
67
|
-
\fBhtml\fR or \fBmarkdown\fR
|
68
|
-
.
|
69
|
-
.IP "\(bu" 4
|
70
|
-
\fBtags\fR:
|
71
|
-
.
|
72
|
-
.br
|
73
|
-
Comma\-separated list of tags.
|
74
|
-
.
|
75
|
-
.IP "\(bu" 4
|
76
|
-
\fBdate\fR:
|
77
|
-
Post date.
|
78
|
-
.
|
79
|
-
.IP "\(bu" 4
|
80
|
-
\fBprivate\fR:
|
81
|
-
If the post should be marked private.
|
57
|
+
.TP
|
58
|
+
\fBtype\fR
|
59
|
+
\fBtext\fR, \fBphoto\fR, \fBquote\fR, \fBlink\fR, \fBchat\fR, \fBaudio\fR, \fBvideo\fR Will take a guess if omitted\. See \fIPOST\-TYPE SPECIFIC PARAMETERS\fR below\.
|
82
60
|
.
|
83
|
-
.
|
84
|
-
\
|
85
|
-
|
61
|
+
.TP
|
62
|
+
\fBstate\fR
|
63
|
+
\fBpublished\fR, \fBdraft\fR, \fBqueue\fR, \fBprivate\fR
|
86
64
|
.
|
87
|
-
.
|
88
|
-
\
|
89
|
-
|
65
|
+
.TP
|
66
|
+
\fBformat\fR
|
67
|
+
\fBhtml\fR or \fBmarkdown\fR Defaults to \fBmarkdown\fR
|
90
68
|
.
|
91
|
-
.
|
92
|
-
\
|
93
|
-
|
69
|
+
.TP
|
70
|
+
\fBtags\fR
|
71
|
+
Comma\-separated list of tags\.
|
94
72
|
.
|
95
|
-
.
|
96
|
-
\
|
97
|
-
|
73
|
+
.TP
|
74
|
+
\fBdate\fR
|
75
|
+
Post date\.
|
98
76
|
.
|
99
|
-
.
|
100
|
-
\
|
101
|
-
|
77
|
+
.TP
|
78
|
+
\fBslug\fR
|
79
|
+
A custom string to appear in the post\'s url\.
|
102
80
|
.
|
103
|
-
.
|
81
|
+
.TP
|
82
|
+
\fBtweet\fR
|
83
|
+
Manages the autotweet (if enabled) for this post
|
104
84
|
.
|
105
85
|
.SH "POST\-TYPE SPECIFIC PARAMETERS"
|
106
|
-
These are parameters that are available for specific types of posts
|
86
|
+
These are parameters that are available for specific types of posts\.
|
107
87
|
.
|
108
88
|
.TP
|
109
|
-
\
|
110
|
-
|
89
|
+
\fBtext\fR
|
90
|
+
\fBtitle\fR, \fBbody\fR
|
111
91
|
.
|
112
92
|
.TP
|
113
93
|
\fBphoto\fR
|
114
|
-
|
94
|
+
\fBcaption\fR, \fBlink\fR, \fBsource\fR, \fBdata\fR
|
115
95
|
.
|
116
96
|
.TP
|
117
97
|
\fBquote\fR
|
118
|
-
|
98
|
+
\fBquote\fR, \fBsource\fR
|
119
99
|
.
|
120
100
|
.TP
|
121
101
|
\fBlink\fR
|
122
|
-
|
102
|
+
\fBtitle\fR, \fBurl\fR, \fBdescription\fR
|
123
103
|
.
|
124
104
|
.TP
|
125
|
-
\
|
126
|
-
|
105
|
+
\fBchat\fR
|
106
|
+
\fBtitle\fR,\fBconversation\fR
|
127
107
|
.
|
128
108
|
.TP
|
129
|
-
\
|
130
|
-
|
109
|
+
\fBaudio\fR
|
110
|
+
\fBcaption\fR, \fBexternal_url\fR, \fBdata\fR
|
131
111
|
.
|
132
112
|
.TP
|
133
|
-
\
|
134
|
-
|
113
|
+
\fBvideo\fR
|
114
|
+
\fBcaption\fR, \fBembed\fR, \fBdata\fR
|
135
115
|
.
|
136
116
|
.SH "SEE ALSO"
|
137
117
|
tumblr(1), markdown(5)
|
data/man/tumblr.5.html
CHANGED
@@ -2,90 +2,96 @@
|
|
2
2
|
<html>
|
3
3
|
<head>
|
4
4
|
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
-
<meta name='generator' value='Ronn/v0.
|
6
|
-
<title>tumblr(5)
|
7
|
-
<style type='text/css'>
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
float:left; width:33%; list-style-type:none;
|
44
|
-
text-transform:uppercase; font-size:18px; color:#999;
|
45
|
-
letter-spacing:1px;}
|
46
|
-
#man ol.man { width:100%; }
|
47
|
-
#man ol.man li.tl { text-align:left }
|
48
|
-
#man ol.man li.tc { text-align:center;letter-spacing:4px }
|
49
|
-
#man ol.man li.tr { text-align:right }
|
50
|
-
#man ol.man a { color:#999 }
|
51
|
-
#man ol.man a:hover { color:#333231 }
|
5
|
+
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
+
<title>tumblr(5) - tumblr posts in plaintext</title>
|
7
|
+
<style type='text/css' media='all'>
|
8
|
+
/* style: man */
|
9
|
+
body#manpage {margin:0}
|
10
|
+
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
+
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
+
.mp h2 {margin:10px 0 0 0}
|
13
|
+
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
+
.mp h3 {margin:0 0 0 4ex}
|
15
|
+
.mp dt {margin:0;clear:left}
|
16
|
+
.mp dt.flush {float:left;width:8ex}
|
17
|
+
.mp dd {margin:0 0 0 9ex}
|
18
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
+
.mp pre {margin-bottom:20px}
|
20
|
+
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
+
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
+
.mp img {display:block;margin:auto}
|
23
|
+
.mp h1.man-title {display:none}
|
24
|
+
.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}
|
25
|
+
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
+
.mp h1 {font-size:20px;line-height:2}
|
27
|
+
.mp {text-align:justify;background:#fff}
|
28
|
+
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
+
.mp u {text-decoration:underline}
|
31
|
+
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
+
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
+
.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}
|
34
|
+
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
+
.mp pre {padding:0 4ex}
|
36
|
+
.mp pre code {font-weight:normal;color:#434241}
|
37
|
+
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
+
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}
|
39
|
+
ol.man-decor {width:100%}
|
40
|
+
ol.man-decor li.tl {text-align:left}
|
41
|
+
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
+
ol.man-decor li.tr {text-align:right;float:right}
|
52
43
|
</style>
|
53
44
|
</head>
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
<
|
63
|
-
|
64
|
-
|
65
|
-
<
|
66
|
-
<
|
67
|
-
|
68
|
-
<
|
45
|
+
<!--
|
46
|
+
The following styles are deprecated and will be removed at some point:
|
47
|
+
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
48
|
+
|
49
|
+
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
50
|
+
.man-navigation should be used instead.
|
51
|
+
-->
|
52
|
+
<body id='manpage'>
|
53
|
+
<div class='mp' id='man'>
|
54
|
+
|
55
|
+
<div class='man-navigation' style='display:none'>
|
56
|
+
<a href="#NAME">NAME</a>
|
57
|
+
<a href="#SYNOPSIS">SYNOPSIS</a>
|
58
|
+
<a href="#DESCRIPTION">DESCRIPTION</a>
|
59
|
+
<a href="#BASIC-PARAMETERS">BASIC PARAMETERS</a>
|
60
|
+
<a href="#POST-TYPE-SPECIFIC-PARAMETERS">POST-TYPE SPECIFIC PARAMETERS</a>
|
61
|
+
<a href="#SEE-ALSO">SEE ALSO</a>
|
62
|
+
</div>
|
63
|
+
|
64
|
+
<ol class='man-decor man-head man head'>
|
65
|
+
<li class='tl'>tumblr(5)</li>
|
66
|
+
<li class='tc'>Tumblr Manual</li>
|
67
|
+
<li class='tr'>tumblr(5)</li>
|
68
|
+
</ol>
|
69
|
+
|
70
|
+
<h2 id="NAME">NAME</h2>
|
71
|
+
<p class="man-name">
|
72
|
+
<code>tumblr</code> - <span class="man-whatis">tumblr posts in plaintext</span>
|
73
|
+
</p>
|
74
|
+
|
75
|
+
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
69
76
|
|
70
77
|
<pre><code>---
|
71
78
|
title: A typical Tumblr post
|
72
79
|
state: queue
|
73
|
-
publish-on: next tuesday
|
74
80
|
tags: unix, manpages
|
75
81
|
format: markdown
|
76
82
|
---
|
77
83
|
|
78
|
-
This will create a *Regular* type of post on Tumblr.com. It's so easy.
|
79
|
-
That bit up at the top is called YAML frontmatter, and it just gives the
|
84
|
+
This will create a *Regular* type of post on Tumblr.com. It's so easy.
|
85
|
+
That bit up at the top is called YAML frontmatter, and it just gives the
|
80
86
|
post a bit of metadata, so publishing options are more flexible.
|
81
|
-
They correspond to the Tumblr API. This post will be added to your Tumblr
|
82
|
-
queue, to be published next Tuesday, tagged with "unix" and "manpages",
|
87
|
+
They correspond to the Tumblr API. This post will be added to your Tumblr
|
88
|
+
queue, to be published next Tuesday, tagged with "unix" and "manpages",
|
83
89
|
and formatted in markdown.
|
84
90
|
</code></pre>
|
85
91
|
|
86
|
-
<h2>DESCRIPTION</h2>
|
92
|
+
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
87
93
|
|
88
|
-
<p>Any file can be published to Tumblr.com as a <i>
|
94
|
+
<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>
|
89
95
|
|
90
96
|
<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>
|
91
97
|
|
@@ -98,66 +104,52 @@ tags: hamlet, shakespeare
|
|
98
104
|
"To be or not to be."
|
99
105
|
</code></pre>
|
100
106
|
|
101
|
-
<p>Understood YAML parameters are documented and taken from the Tumblr API: http://www.tumblr.com/docs/en/api#
|
107
|
+
<p>Understood YAML parameters are documented and taken from the Tumblr API: http://www.tumblr.com/docs/en/api/v2#posting</p>
|
102
108
|
|
103
|
-
<h2>BASIC PARAMETERS</h2>
|
109
|
+
<h2 id="BASIC-PARAMETERS">BASIC PARAMETERS</h2>
|
104
110
|
|
105
111
|
<p>These YAML parameters are available for all posts</p>
|
106
112
|
|
107
|
-
<
|
108
|
-
<
|
109
|
-
<code>regular</code>, <code>photo</code>, <code>link</code>, <code>quote</code>, <code>conversation</code>, <code>video</code>, <code>audio</code>
|
113
|
+
<dl>
|
114
|
+
<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>
|
110
115
|
Will take a guess if omitted.
|
111
|
-
See <em>POST-TYPE SPECIFIC PARAMETERS</em> below.</p></
|
112
|
-
<
|
113
|
-
|
114
|
-
<
|
115
|
-
|
116
|
-
<
|
117
|
-
|
118
|
-
<
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
<
|
123
|
-
A custom string to appear in the post's url.</p></li>
|
124
|
-
<li><p><code>group</code>:
|
125
|
-
ID for a secondary blog.</p></li>
|
126
|
-
<li><p><code>generator</code>:
|
127
|
-
Short description of the publishing application.</p></li>
|
128
|
-
<li><p><code>send-to-twitter</code>:
|
129
|
-
Twitter status update to make if the tumblelog has enabled it.</p></li>
|
130
|
-
<li><p><code>publish-on</code>:
|
131
|
-
If the post state is 'queue', publish on this date</p></li>
|
132
|
-
</ul>
|
133
|
-
|
134
|
-
|
135
|
-
<h2>POST-TYPE SPECIFIC PARAMETERS</h2>
|
116
|
+
See <em>POST-TYPE SPECIFIC PARAMETERS</em> below.</p></dd>
|
117
|
+
<dt class="flush"><code>state</code></dt><dd><p> <code>published</code>, <code>draft</code>, <code>queue</code>, <code>private</code></p></dd>
|
118
|
+
<dt class="flush"><code>format</code></dt><dd><p> <code>html</code> or <code>markdown</code>
|
119
|
+
Defaults to <code>markdown</code></p></dd>
|
120
|
+
<dt class="flush"><code>tags</code></dt><dd><p> Comma-separated list of tags.</p></dd>
|
121
|
+
<dt class="flush"><code>date</code></dt><dd><p> Post date.</p></dd>
|
122
|
+
<dt class="flush"><code>slug</code></dt><dd><p> A custom string to appear in the post's url.</p></dd>
|
123
|
+
<dt class="flush"><code>tweet</code></dt><dd><p> Manages the autotweet (if enabled) for this post</p></dd>
|
124
|
+
</dl>
|
125
|
+
|
126
|
+
|
127
|
+
<h2 id="POST-TYPE-SPECIFIC-PARAMETERS">POST-TYPE SPECIFIC PARAMETERS</h2>
|
136
128
|
|
137
129
|
<p>These are parameters that are available for specific types of posts.</p>
|
138
130
|
|
139
131
|
<dl>
|
140
|
-
<dt class="flush"><code>
|
141
|
-
<dt class="flush"><code>photo</code></dt><dd><p> <code>caption</code>, <code>
|
142
|
-
<dt class="flush"><code>quote</code></dt><dd><p> <code>source</code></p></dd>
|
143
|
-
<dt class="flush"><code>link</code></dt><dd><p> <code>
|
144
|
-
<dt><code>
|
145
|
-
<dt class="flush"><code>
|
146
|
-
<dt class="flush"><code>
|
132
|
+
<dt class="flush"><code>text</code></dt><dd><p> <code>title</code>, <code>body</code></p></dd>
|
133
|
+
<dt class="flush"><code>photo</code></dt><dd><p> <code>caption</code>, <code>link</code>, <code>source</code>, <code>data</code></p></dd>
|
134
|
+
<dt class="flush"><code>quote</code></dt><dd><p> <code>quote</code>, <code>source</code></p></dd>
|
135
|
+
<dt class="flush"><code>link</code></dt><dd><p> <code>title</code>, <code>url</code>, <code>description</code></p></dd>
|
136
|
+
<dt class="flush"><code>chat</code></dt><dd><p> <code>title</code>,<code>conversation</code></p></dd>
|
137
|
+
<dt class="flush"><code>audio</code></dt><dd><p> <code>caption</code>, <code>external_url</code>, <code>data</code></p></dd>
|
138
|
+
<dt class="flush"><code>video</code></dt><dd><p> <code>caption</code>, <code>embed</code>, <code>data</code></p></dd>
|
147
139
|
</dl>
|
148
140
|
|
149
141
|
|
150
|
-
<h2>SEE ALSO</h2>
|
142
|
+
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
151
143
|
|
152
|
-
<p>tumblr(1)
|
144
|
+
<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>
|
153
145
|
|
154
146
|
|
155
|
-
<ol class='foot man'>
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
</ol>
|
147
|
+
<ol class='man-decor man-foot man foot'>
|
148
|
+
<li class='tl'>Mark Wunsch</li>
|
149
|
+
<li class='tc'>October 2012</li>
|
150
|
+
<li class='tr'>tumblr(5)</li>
|
151
|
+
</ol>
|
160
152
|
|
161
|
-
</div>
|
153
|
+
</div>
|
162
154
|
</body>
|
163
155
|
</html>
|
data/man/tumblr.5.ronn
CHANGED
@@ -6,21 +6,20 @@ tumblr(5) -- tumblr posts in plaintext
|
|
6
6
|
---
|
7
7
|
title: A typical Tumblr post
|
8
8
|
state: queue
|
9
|
-
publish-on: next tuesday
|
10
9
|
tags: unix, manpages
|
11
10
|
format: markdown
|
12
11
|
---
|
13
|
-
|
14
|
-
This will create a *Regular* type of post on Tumblr.com. It's so easy.
|
15
|
-
That bit up at the top is called YAML frontmatter, and it just gives the
|
12
|
+
|
13
|
+
This will create a *Regular* type of post on Tumblr.com. It's so easy.
|
14
|
+
That bit up at the top is called YAML frontmatter, and it just gives the
|
16
15
|
post a bit of metadata, so publishing options are more flexible.
|
17
|
-
They correspond to the Tumblr API. This post will be added to your Tumblr
|
18
|
-
queue, to be published next Tuesday, tagged with "unix" and "manpages",
|
16
|
+
They correspond to the Tumblr API. This post will be added to your Tumblr
|
17
|
+
queue, to be published next Tuesday, tagged with "unix" and "manpages",
|
19
18
|
and formatted in markdown.
|
20
|
-
|
19
|
+
|
21
20
|
## DESCRIPTION
|
22
21
|
|
23
|
-
Any file can be published to Tumblr.com as a <i>
|
22
|
+
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.
|
24
23
|
|
25
24
|
YAML frontmatter beings with `---` on a single line, followed by YAML, ending with another `---` on a single line, e.g.
|
26
25
|
|
@@ -31,74 +30,62 @@ YAML frontmatter beings with `---` on a single line, followed by YAML, ending wi
|
|
31
30
|
tags: hamlet, shakespeare
|
32
31
|
---
|
33
32
|
"To be or not to be."
|
34
|
-
|
35
|
-
Understood YAML parameters are documented and taken from the Tumblr API: http://www.tumblr.com/docs/en/api#
|
33
|
+
|
34
|
+
Understood YAML parameters are documented and taken from the Tumblr API: http://www.tumblr.com/docs/en/api/v2#posting
|
36
35
|
|
37
36
|
## BASIC PARAMETERS
|
38
37
|
|
39
38
|
These YAML parameters are available for all posts
|
40
39
|
|
41
40
|
* `type`:
|
42
|
-
`
|
41
|
+
`text`, `photo`, `quote`, `link`, `chat`, `audio`, `video`
|
43
42
|
Will take a guess if omitted.
|
44
43
|
See _POST-TYPE SPECIFIC PARAMETERS_ below.
|
45
44
|
|
46
45
|
* `state`:
|
47
|
-
`published`, `draft`, `queue`, `
|
48
|
-
|
46
|
+
`published`, `draft`, `queue`, `private`
|
47
|
+
|
49
48
|
* `format`:
|
50
49
|
`html` or `markdown`
|
51
|
-
|
52
|
-
|
50
|
+
Defaults to `markdown`
|
51
|
+
|
52
|
+
* `tags`:
|
53
53
|
Comma-separated list of tags.
|
54
|
-
|
54
|
+
|
55
55
|
* `date`:
|
56
56
|
Post date.
|
57
|
-
|
58
|
-
* `private`:
|
59
|
-
If the post should be marked private.
|
60
|
-
|
57
|
+
|
61
58
|
* `slug`:
|
62
59
|
A custom string to appear in the post's url.
|
63
|
-
|
64
|
-
* `
|
65
|
-
|
66
|
-
|
67
|
-
* `generator`:
|
68
|
-
Short description of the publishing application.
|
69
|
-
|
70
|
-
* `send-to-twitter`:
|
71
|
-
Twitter status update to make if the tumblelog has enabled it.
|
72
|
-
|
73
|
-
* `publish-on`:
|
74
|
-
If the post state is 'queue', publish on this date
|
75
|
-
|
60
|
+
|
61
|
+
* `tweet`:
|
62
|
+
Manages the autotweet (if enabled) for this post
|
63
|
+
|
76
64
|
## POST-TYPE SPECIFIC PARAMETERS
|
77
65
|
|
78
66
|
These are parameters that are available for specific types of posts.
|
79
67
|
|
80
|
-
* `
|
81
|
-
`title`
|
82
|
-
|
68
|
+
* `text`:
|
69
|
+
`title`, `body`
|
70
|
+
|
83
71
|
* `photo`:
|
84
|
-
`caption`, `
|
85
|
-
|
72
|
+
`caption`, `link`, `source`, `data`
|
73
|
+
|
86
74
|
* `quote`:
|
87
|
-
`source`
|
88
|
-
|
75
|
+
`quote`, `source`
|
76
|
+
|
89
77
|
* `link`:
|
90
|
-
`
|
91
|
-
|
92
|
-
* `
|
93
|
-
`title`
|
94
|
-
|
95
|
-
* `video`:
|
96
|
-
`title`,`caption`
|
97
|
-
|
78
|
+
`title`, `url`, `description`
|
79
|
+
|
80
|
+
* `chat`:
|
81
|
+
`title`,`conversation`
|
82
|
+
|
98
83
|
* `audio`:
|
99
|
-
`caption`
|
100
|
-
|
84
|
+
`caption`, `external_url`, `data`
|
85
|
+
|
86
|
+
* `video`:
|
87
|
+
`caption`, `embed`, `data`
|
88
|
+
|
101
89
|
## SEE ALSO
|
102
90
|
|
103
91
|
tumblr(1), markdown(5)
|
104
|
-
|