runeblog 0.2.53 → 0.2.58
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.lt3 +164 -69
- data/README.md +176 -65
- data/bin/blog +52 -4
- data/empty_view/remote/banner/austin-pano.jpg +0 -0
- data/empty_view/remote/banner/top.html +4 -0
- data/empty_view/themes/standard/banner/austin-pano.jpg +0 -0
- data/empty_view/themes/standard/banner/top.html +4 -0
- data/empty_view/themes/standard/blog/generate.lt3 +1 -16
- data/empty_view/themes/standard/blog/index.lt3 +3 -2
- data/empty_view/themes/standard/navbar/navbar.lt3 +4 -2
- data/empty_view/themes/standard/navbar/vnavbar.lt3 +19 -0
- data/empty_view/themes/standard/widgets/links/links.rb +41 -4
- data/empty_view/themes/standard/widgets/news/news.rb +70 -0
- data/empty_view/themes/standard/widgets/pages/pages.rb +56 -2
- data/empty_view/themes/standard/widgets/pinned/pinned.rb +81 -0
- data/lib/helpers-repl.rb +1 -0
- data/lib/liveblog.rb +102 -85
- data/lib/post.rb +6 -6
- data/lib/repl.rb +5 -9
- data/lib/runeblog.rb +3 -11
- data/lib/runeblog_version.rb +1 -1
- data/lib/xlate.rb +6 -7
- data/runeblog.gemspec +1 -0
- data/test/austin.rb +3 -2
- metadata +8 -3
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: '0873c41ad8c6eeae9fd84afe21144479c1c6bc1592ce74a18a84876b9d759aa4'
|
|
4
|
+
data.tar.gz: a3bb718ca13531568b0cce72f574c4642a976577b1449f37a592c845966c0084
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 6a059e27fa46e4367dfb9827f7587472152b6c62120abd10ab3ff61432e4363c122889150d027a32e673029e5ace5414c646e99d8700f2e9c17efa7e7be93e3f
|
|
7
|
+
data.tar.gz: 5d370df15a116caf0d6b3a3f2322af80e629d02ecfbd7b8274196b14f02bcf9edf15e8c48420f8b14235ee58946f7a3f86524496e08127b034df03531120c0ed
|
data/README.lt3
CHANGED
|
@@ -1,23 +1,18 @@
|
|
|
1
1
|
.mixin markdown
|
|
2
|
-
<div
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
<img src="raido.png" width="196" height="275" align="left"></img>
|
|
2
|
+
<div style="float: left; align: left; vertical-align: bottom">
|
|
3
|
+
<img src="raido4.png" width="210" height="295" align="left"></img>
|
|
6
4
|
</div>
|
|
5
|
+
<h1>runeblog</h1><b>Runeblog</b> is a blogging tool written in Ruby. It has these basic characteristics:
|
|
6
|
+
<ul>
|
|
7
|
+
<li>It is usable entirely in text mode from the terminal</li>
|
|
8
|
+
<li>It publishes web pages as static HTML</li>
|
|
9
|
+
<li>So far, yes, like Jekyll</li>
|
|
10
|
+
<li>It's based on Livetext (highly extensible Ruby-based markup)</li>
|
|
11
|
+
<li>It has the concept of multiple "views" for a blog</li>
|
|
12
|
+
<li>The multiple views are in effect multiple blogs managed with the same backend.</li>
|
|
13
|
+
</ul>
|
|
7
14
|
|
|
8
|
-
.h1 runeblog
|
|
9
|
-
|
|
10
|
-
Runeblog is a blogging tool written in Ruby. It has these basic characteristics:
|
|
11
|
-
|
|
12
|
-
.list
|
|
13
|
-
It is usable entirely from the command line
|
|
14
|
-
It publishes web pages as static HTML
|
|
15
|
-
So far, yes, like Jekyll
|
|
16
|
-
It's based on Livetext (highly extensible Ruby-based markup)
|
|
17
|
-
It has the concept of multiple "views" for a blog
|
|
18
|
-
.end
|
|
19
15
|
|
|
20
|
-
The multiple views are in effect multiple blogs managed with the same backend.
|
|
21
16
|
|
|
22
17
|
.h2 What is Livetext?
|
|
23
18
|
|
|
@@ -38,15 +33,16 @@ would go into another. There might be a view that only old friends or close frie
|
|
|
38
33
|
can see. There might be a view purely for reviews of music, books, and movies.
|
|
39
34
|
|
|
40
35
|
But the important points are these:
|
|
36
|
+
|
|
41
37
|
.list
|
|
42
|
-
|
|
38
|
+
<i>All</i> the views will be managed the same way in the same place, and they will all share common data.
|
|
43
39
|
Any post can easily be included in a single view, in more than one, or in all of them.
|
|
44
40
|
Each view can have its own look and feel, and it can be linked/published separately from the others.
|
|
45
41
|
Each view can be hosted in a different location and/or a different server and domain
|
|
46
42
|
Any post can be in more than one view
|
|
47
43
|
.end
|
|
48
44
|
|
|
49
|
-
.h2 The
|
|
45
|
+
.h2 The <tt>blog</tt> environment
|
|
50
46
|
|
|
51
47
|
There is a command-line tool called `blog which is a REPL (read-eval-print loop).
|
|
52
48
|
Note that this tool is a curses-based environment (mainly so it can display menus
|
|
@@ -55,93 +51,192 @@ and such to the user).
|
|
|
55
51
|
The help message looks like this:
|
|
56
52
|
|
|
57
53
|
.mono
|
|
58
|
-
|
|
54
|
+
<b>Basics:</b> <b>Views:</b>
|
|
55
|
+
------------------------------------------- -------------------------------------------
|
|
56
|
+
<b>h, help</b> This message <b>change view VIEW</b> Change current view
|
|
57
|
+
<b>q, quit</b> Exit the program <b>cv VIEW</b> Change current view
|
|
58
|
+
<b>v, version</b> Print version information <b>new view</b> Create a new view
|
|
59
|
+
<b>clear</b> Clear screen <b>list views</b> List all views available
|
|
60
|
+
<b>lsv</b> Same as: list views
|
|
61
|
+
<br>
|
|
62
|
+
<b>Posts:</b> <b>Advanced:</b>
|
|
63
|
+
------------------------------------------- -------------------------------------------
|
|
64
|
+
<b>p, post</b> Create a new post <b>config</b> Edit various system files
|
|
65
|
+
<b>new post</b> Same as p, post <b>customize</b> (BUGGY) Change set of tags, extra views
|
|
66
|
+
<b>lsp, list posts</b> List posts in current view <b>preview</b> Look at current (local) view in browser
|
|
67
|
+
<b>lsd, list drafts</b> List all drafts (all views) <b>browse</b> Look at current (published) view in browser
|
|
68
|
+
<b>delete ID [ID...]</b> Remove multiple posts <b>rebuild</b> Regenerate all posts and relink
|
|
69
|
+
<b>undelete ID</b> Undelete a post <b>publish</b> Publish (current view)
|
|
70
|
+
<b>edit ID</b> Edit a post <b>ssh</b> Login to remote server
|
|
71
|
+
<b>import ASSETS</b> Import assets (images, etc.) <b>manage WIDGET</b> Manage content/layout of a widget
|
|
72
|
+
.end
|
|
73
|
+
|
|
74
|
+
.h2 Getting started
|
|
59
75
|
|
|
60
|
-
|
|
61
|
-
|
|
76
|
+
But when you first run the REPL, it checks for an existing blog repository under
|
|
77
|
+
the `[.blogs] directory. If it doesn't find one, it asks whether you want to create
|
|
78
|
+
a new blog repo. Enter `y for yes.
|
|
79
|
+
. If you enter `y for yes, it creates a sort of "skeleton" with a single view called `[test_view].
|
|
62
80
|
|
|
63
|
-
|
|
64
|
-
new view Create a new view
|
|
65
|
-
list views List all views available
|
|
66
|
-
lsv Same as: list views
|
|
81
|
+
You'll then enter the editor (vim for now) to add configuration info to the `global.lt3 file.
|
|
67
82
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
lsp, list posts List posts in current view
|
|
71
|
-
lsd, list drafts List all posts regardless of view
|
|
83
|
+
<pre><b>FIXME add menu screenshot here</b></pre>
|
|
84
|
+
<pre><b>FIXME add vim screenshot here</b></pre>
|
|
72
85
|
|
|
73
|
-
|
|
74
|
-
|
|
86
|
+
The next thing you should do is to create at least one view of your own. Use the
|
|
87
|
+
`[new view] command for this. Note that the current view is displayed as part of the prompt.
|
|
75
88
|
|
|
76
|
-
|
|
77
|
-
|
|
89
|
+
<pre>
|
|
90
|
+
<b>[no view]</b> new view mystuff<br>
|
|
91
|
+
<b>[mystuff]</b>
|
|
92
|
+
</pre>
|
|
78
93
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
deploy Deploy (current view)
|
|
82
|
-
.end
|
|
94
|
+
To create a new post, use the `[new post] command (also abbreviated `post or simply `[p]). You will be
|
|
95
|
+
prompted for a title:
|
|
83
96
|
|
|
84
|
-
|
|
97
|
+
<pre>
|
|
98
|
+
<b>[around_austin]</b> new post<br>
|
|
99
|
+
<b>Title:</b> This is my first post
|
|
100
|
+
</pre>
|
|
85
101
|
|
|
86
|
-
|
|
87
|
-
the `[.blog] directory. If it doesn't find one, it asks whether you want to create
|
|
88
|
-
a new blog repo. If you enter `y for yes, it creates a sort of "skeleton" with a
|
|
89
|
-
single view called `[test_view].
|
|
102
|
+
Then you'll be sent into the editor (currently vim but can be others):
|
|
90
103
|
|
|
91
|
-
|
|
92
|
-
`[new view] command for this.
|
|
104
|
+
<pre><b>FIXME add example here</b></pre>
|
|
93
105
|
|
|
94
|
-
|
|
106
|
+
<pre>
|
|
107
|
+
<b>FIXME wizard?</b>
|
|
108
|
+
(publishing one-time setup - server, ssh keys, etc.)
|
|
109
|
+
preview...
|
|
110
|
+
publish...
|
|
111
|
+
browse...
|
|
112
|
+
(and so on)
|
|
113
|
+
</pre>
|
|
95
114
|
|
|
96
|
-
|
|
115
|
+
<b>To be continued</b>
|
|
97
116
|
|
|
98
|
-
|
|
117
|
+
.h2 Customizing the default templates and configuration
|
|
99
118
|
|
|
100
|
-
|
|
119
|
+
You can use the `config command to choose a file to edit.
|
|
101
120
|
|
|
102
|
-
|
|
121
|
+
<pre><b>FIXME add screenshot here</b></pre>
|
|
103
122
|
|
|
104
|
-
|
|
123
|
+
The meaning and interaction of these files will be explained later. *FIXME
|
|
105
124
|
|
|
106
|
-
|
|
125
|
+
When you make changes, `rebuild will detect these and regenerate whatever files
|
|
126
|
+
are needed.
|
|
107
127
|
|
|
108
|
-
|
|
128
|
+
.h2 The directory structure for a view
|
|
109
129
|
|
|
110
|
-
|
|
130
|
+
<pre><b>FIXME add details here</b></pre>
|
|
111
131
|
|
|
112
|
-
*TBD
|
|
113
132
|
|
|
114
133
|
.h2 Basics of Livetext
|
|
115
134
|
|
|
116
|
-
|
|
135
|
+
<b>TBD</b>
|
|
136
|
+
|
|
137
|
+
<b>Bold, italics, etc.</b>
|
|
138
|
+
single, double, bracketed
|
|
139
|
+
|
|
140
|
+
<b>Common dot commands)
|
|
141
|
+
<pre>
|
|
142
|
+
.debug
|
|
143
|
+
.say
|
|
144
|
+
.nopara
|
|
145
|
+
.quit
|
|
146
|
+
indented dot-commands
|
|
147
|
+
</pre>
|
|
148
|
+
|
|
149
|
+
<b>Using external files</b>
|
|
150
|
+
<pre>
|
|
151
|
+
.mixin
|
|
152
|
+
.include
|
|
153
|
+
.copy
|
|
154
|
+
.seek
|
|
155
|
+
</pre>
|
|
156
|
+
|
|
157
|
+
<b>Predefined functions and variables</b>
|
|
158
|
+
<pre>
|
|
159
|
+
\$File
|
|
160
|
+
\$\$date
|
|
161
|
+
etc.
|
|
162
|
+
</pre>
|
|
163
|
+
|
|
164
|
+
.h2 Runeblog-specific features (Liveblog</b>
|
|
165
|
+
|
|
166
|
+
<b>TBD</b>
|
|
167
|
+
|
|
168
|
+
<b>Dot commands - the basics</b>
|
|
169
|
+
<pre>
|
|
170
|
+
.mixin liveblog
|
|
171
|
+
.post
|
|
172
|
+
.title
|
|
173
|
+
.views
|
|
174
|
+
.tags
|
|
175
|
+
.teaser
|
|
176
|
+
</pre>
|
|
177
|
+
|
|
178
|
+
<b>Dot commands - more advanced</b>
|
|
179
|
+
<pre>
|
|
180
|
+
.image
|
|
181
|
+
.inset
|
|
182
|
+
.dropcap
|
|
183
|
+
.pin
|
|
184
|
+
</pre>
|
|
185
|
+
|
|
186
|
+
<b>Variables and functions</b>
|
|
187
|
+
<pre>
|
|
188
|
+
\$view, etc.
|
|
189
|
+
\$\$date, \$\$link, etc.
|
|
190
|
+
</pre>
|
|
117
191
|
|
|
118
|
-
(bold, italics, etc.)
|
|
119
192
|
|
|
120
|
-
|
|
193
|
+
.h2 Defining your own features
|
|
121
194
|
|
|
122
|
-
|
|
195
|
+
<b>Dot commands, variables, functions</b>
|
|
196
|
+
<pre>
|
|
197
|
+
.def/.end
|
|
198
|
+
.set
|
|
199
|
+
.variables
|
|
200
|
+
.heredoc
|
|
201
|
+
.func
|
|
202
|
+
</pre>
|
|
123
203
|
|
|
124
|
-
|
|
204
|
+
<b>Defining these in Ruby</b>
|
|
125
205
|
|
|
126
|
-
*TBD
|
|
127
206
|
|
|
128
|
-
|
|
207
|
+
.h2 More topics
|
|
129
208
|
|
|
130
|
-
|
|
209
|
+
<b>Meta tags, etc.</b>
|
|
210
|
+
<b>CSS</b>
|
|
131
211
|
|
|
132
|
-
|
|
212
|
+
<b>Widgets</b>
|
|
213
|
+
<pre>
|
|
214
|
+
pages
|
|
215
|
+
links
|
|
216
|
+
pinned
|
|
217
|
+
faq
|
|
218
|
+
sitemap
|
|
219
|
+
news
|
|
220
|
+
etc.
|
|
221
|
+
</pre>
|
|
133
222
|
|
|
134
|
-
|
|
223
|
+
<b>Banner and navbar</b>
|
|
135
224
|
|
|
136
|
-
|
|
225
|
+
<b>Creating your own widgets</b>
|
|
137
226
|
|
|
138
|
-
|
|
227
|
+
<b>Special tags coming "soon"</b>
|
|
228
|
+
<pre>
|
|
229
|
+
github, gitlab, gist
|
|
230
|
+
wikipedia
|
|
231
|
+
youtube, vimeo
|
|
232
|
+
twitter, instagram
|
|
233
|
+
etc.
|
|
234
|
+
</pre>
|
|
139
235
|
|
|
140
|
-
.h2
|
|
141
236
|
|
|
142
|
-
|
|
237
|
+
<b>TBD</b>
|
|
143
238
|
|
|
144
239
|
.h2 More later...
|
|
145
240
|
|
|
146
|
-
|
|
241
|
+
<b>TBD</b>
|
|
147
242
|
|
data/README.md
CHANGED
|
@@ -1,22 +1,19 @@
|
|
|
1
|
-
<div
|
|
2
|
-
<
|
|
3
|
-
|
|
4
|
-
<p>
|
|
5
|
-
|
|
6
|
-
<img src="raido.png" width="196" height="275" align="left"></img>
|
|
1
|
+
<div style="float: left; align: left; vertical-align: bottom">
|
|
2
|
+
<img src="raido4.png" width="210" height="295" align="left"></img>
|
|
7
3
|
</div>
|
|
4
|
+
<h1>runeblog</h1><b>Runeblog</b> is a blogging tool written in Ruby. It has these basic characteristics:
|
|
5
|
+
<ul>
|
|
6
|
+
<li>It is usable entirely in text mode from the terminal</li>
|
|
7
|
+
<li>It publishes web pages as static HTML</li>
|
|
8
|
+
<li>So far, yes, like Jekyll</li>
|
|
9
|
+
<li>It's based on Livetext (highly extensible Ruby-based markup)</li>
|
|
10
|
+
<li>It has the concept of multiple "views" for a blog</li>
|
|
11
|
+
<li>The multiple views are in effect multiple blogs managed with the same backend.</li>
|
|
12
|
+
</ul>
|
|
8
13
|
<p>
|
|
9
14
|
|
|
10
|
-
# runeblog
|
|
11
|
-
Runeblog is a blogging tool written in Ruby. It has these basic characteristics:
|
|
12
15
|
<p>
|
|
13
16
|
|
|
14
|
-
* It is usable entirely from the command line
|
|
15
|
-
* It publishes web pages as static HTML
|
|
16
|
-
* So far, yes, like Jekyll
|
|
17
|
-
* It's based on Livetext (highly extensible Ruby-based markup)
|
|
18
|
-
* It has the concept of multiple "views" for a blog
|
|
19
|
-
The multiple views are in effect multiple blogs managed with the same backend.
|
|
20
17
|
<p>
|
|
21
18
|
|
|
22
19
|
## What is Livetext?
|
|
@@ -40,12 +37,14 @@ can see. There might be a view purely for reviews of music, books, and movies.
|
|
|
40
37
|
<p>
|
|
41
38
|
|
|
42
39
|
But the important points are these:
|
|
43
|
-
|
|
40
|
+
<p>
|
|
41
|
+
|
|
42
|
+
* <i>All</i> the views will be managed the same way in the same place, and they will all share common data.
|
|
44
43
|
* Any post can easily be included in a single view, in more than one, or in all of them.
|
|
45
44
|
* Each view can have its own look and feel, and it can be linked/published separately from the others.
|
|
46
45
|
* Each view can be hosted in a different location and/or a different server and domain
|
|
47
46
|
* Any post can be in more than one view
|
|
48
|
-
## The
|
|
47
|
+
## The <tt>blog</tt> environment
|
|
49
48
|
There is a command-line tool called <font size=+1><tt>blog</tt></font> which is a REPL (read-eval-print loop).
|
|
50
49
|
Note that this tool is a curses-based environment (mainly so it can display menus
|
|
51
50
|
and such to the user).
|
|
@@ -55,108 +54,220 @@ The help message looks like this:
|
|
|
55
54
|
<p>
|
|
56
55
|
|
|
57
56
|
<pre>
|
|
58
|
-
|
|
57
|
+
<b>Basics:</b> <b>Views:</b>
|
|
58
|
+
------------------------------------------- -------------------------------------------
|
|
59
|
+
<b>h, help</b> This message <b>change view VIEW</b> Change current view
|
|
60
|
+
<b>q, quit</b> Exit the program <b>cv VIEW</b> Change current view
|
|
61
|
+
<b>v, version</b> Print version information <b>new view</b> Create a new view
|
|
62
|
+
<b>clear</b> Clear screen <b>list views</b> List all views available
|
|
63
|
+
<b>lsv</b> Same as: list views
|
|
64
|
+
<br>
|
|
65
|
+
<b>Posts:</b> <b>Advanced:</b>
|
|
66
|
+
------------------------------------------- -------------------------------------------
|
|
67
|
+
<b>p, post</b> Create a new post <b>config</b> Edit various system files
|
|
68
|
+
<b>new post</b> Same as p, post <b>customize</b> (BUGGY) Change set of tags, extra views
|
|
69
|
+
<b>lsp, list posts</b> List posts in current view <b>preview</b> Look at current (local) view in browser
|
|
70
|
+
<b>lsd, list drafts</b> List all drafts (all views) <b>browse</b> Look at current (published) view in browser
|
|
71
|
+
<b>delete ID [ID...]</b> Remove multiple posts <b>rebuild</b> Regenerate all posts and relink
|
|
72
|
+
<b>undelete ID</b> Undelete a post <b>publish</b> Publish (current view)
|
|
73
|
+
<b>edit ID</b> Edit a post <b>ssh</b> Login to remote server
|
|
74
|
+
<b>import ASSETS</b> Import assets (images, etc.) <b>manage WIDGET</b> Manage content/layout of a widget
|
|
75
|
+
</pre>
|
|
76
|
+
## Getting started
|
|
77
|
+
But when you first run the REPL, it checks for an existing blog repository under
|
|
78
|
+
the <font size=+1><tt>.blogs</tt></font> directory. If it doesn't find one, it asks whether you want to create
|
|
79
|
+
a new blog repo. Enter <font size=+1><tt>y</tt></font> for yes.
|
|
80
|
+
<p>
|
|
59
81
|
|
|
60
|
-
|
|
61
|
-
|
|
82
|
+
You'll then enter the editor (vim for now) to add configuration info to the <font size=+1><tt>global.lt3</tt></font> file.
|
|
83
|
+
<p>
|
|
62
84
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
lsv Same as: list views
|
|
85
|
+
<pre><b>FIXME add menu screenshot here</b></pre>
|
|
86
|
+
<pre><b>FIXME add vim screenshot here</b></pre>
|
|
87
|
+
<p>
|
|
67
88
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
lsd, list drafts List all posts regardless of view
|
|
89
|
+
The next thing you should do is to create at least one view of your own. Use the
|
|
90
|
+
`[new view] command for this. Note that the current view is displayed as part of the prompt.
|
|
91
|
+
<p>
|
|
72
92
|
|
|
73
|
-
|
|
74
|
-
|
|
93
|
+
<pre>
|
|
94
|
+
<b>[no view]</b> new view mystuff<br>
|
|
95
|
+
<b>[mystuff]</b>
|
|
96
|
+
</pre>
|
|
97
|
+
<p>
|
|
75
98
|
|
|
76
|
-
|
|
77
|
-
|
|
99
|
+
To create a new post, use the <font size=+1><tt>new post</tt></font> command (also abbreviated <font size=+1><tt>post</tt></font> or simply <font size=+1><tt>p</tt></font>). You will be
|
|
100
|
+
prompted for a title:
|
|
101
|
+
<p>
|
|
78
102
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
103
|
+
<pre>
|
|
104
|
+
<b>[around_austin]</b> new post<br>
|
|
105
|
+
<b>Title:</b> This is my first post
|
|
82
106
|
</pre>
|
|
83
|
-
## Getting started
|
|
84
|
-
But when you first run the REPL, it checks for an existing blog repository under
|
|
85
|
-
the <font size=+1><tt>.blog</tt></font> directory. If it doesn't find one, it asks whether you want to create
|
|
86
|
-
a new blog repo. If you enter <font size=+1><tt>y</tt></font> for yes, it creates a sort of "skeleton" with a
|
|
87
|
-
single view called <font size=+1><tt>test_view</tt></font>.
|
|
88
107
|
<p>
|
|
89
108
|
|
|
90
|
-
|
|
91
|
-
<font size=+1><tt>new view</tt></font> command for this.
|
|
109
|
+
Then you'll be sent into the editor (currently vim but can be others):
|
|
92
110
|
<p>
|
|
93
111
|
|
|
94
|
-
|
|
112
|
+
<pre><b>FIXME add example here</b></pre>
|
|
95
113
|
<p>
|
|
96
114
|
|
|
97
|
-
|
|
115
|
+
<pre>
|
|
116
|
+
<b>FIXME wizard?</b>
|
|
117
|
+
(publishing one-time setup - server, ssh keys, etc.)
|
|
118
|
+
preview...
|
|
119
|
+
publish...
|
|
120
|
+
browse...
|
|
121
|
+
(and so on)
|
|
122
|
+
</pre>
|
|
98
123
|
<p>
|
|
99
124
|
|
|
100
|
-
|
|
125
|
+
<b>To be continued</b>
|
|
101
126
|
<p>
|
|
102
127
|
|
|
103
|
-
|
|
128
|
+
## Customizing the default templates and configuration
|
|
129
|
+
You can use the <font size=+1><tt>config</tt></font> command to choose a file to edit.
|
|
104
130
|
<p>
|
|
105
131
|
|
|
106
|
-
|
|
132
|
+
<pre><b>FIXME add screenshot here</b></pre>
|
|
107
133
|
<p>
|
|
108
134
|
|
|
109
|
-
|
|
135
|
+
The meaning and interaction of these files will be explained later. <b>FIXME</b>
|
|
110
136
|
<p>
|
|
111
137
|
|
|
112
|
-
|
|
138
|
+
When you make changes, <font size=+1><tt>rebuild</tt></font> will detect these and regenerate whatever files
|
|
139
|
+
are needed.
|
|
113
140
|
<p>
|
|
114
141
|
|
|
115
|
-
|
|
142
|
+
## The directory structure for a view
|
|
143
|
+
<pre><b>FIXME add details here</b></pre>
|
|
116
144
|
<p>
|
|
117
145
|
|
|
118
|
-
## Changing the default templates
|
|
119
|
-
*TBD
|
|
120
146
|
<p>
|
|
121
147
|
|
|
122
148
|
## Basics of Livetext
|
|
123
|
-
|
|
149
|
+
<b>TBD</b>
|
|
150
|
+
<p>
|
|
151
|
+
|
|
152
|
+
<b>Bold, italics, etc.</b>
|
|
153
|
+
single, double, bracketed
|
|
154
|
+
<p>
|
|
155
|
+
|
|
156
|
+
<b>Common dot commands)
|
|
157
|
+
<pre>
|
|
158
|
+
.debug
|
|
159
|
+
.say
|
|
160
|
+
.nopara
|
|
161
|
+
.quit
|
|
162
|
+
indented dot-commands
|
|
163
|
+
</pre>
|
|
164
|
+
<p>
|
|
165
|
+
|
|
166
|
+
<b>Using external files</b>
|
|
167
|
+
<pre>
|
|
168
|
+
.mixin
|
|
169
|
+
.include
|
|
170
|
+
.copy
|
|
171
|
+
.seek
|
|
172
|
+
</pre>
|
|
124
173
|
<p>
|
|
125
174
|
|
|
126
|
-
|
|
175
|
+
<b>Predefined functions and variables</b>
|
|
176
|
+
<pre>
|
|
177
|
+
$File
|
|
178
|
+
$\[date is undefined]
|
|
179
|
+
etc.
|
|
180
|
+
</pre>
|
|
127
181
|
<p>
|
|
128
182
|
|
|
129
|
-
|
|
183
|
+
## Runeblog-specific features (Liveblog</b>
|
|
184
|
+
<b>TBD</b>
|
|
130
185
|
<p>
|
|
131
186
|
|
|
132
|
-
|
|
187
|
+
<b>Dot commands - the basics</b>
|
|
188
|
+
<pre>
|
|
189
|
+
.mixin liveblog
|
|
190
|
+
.post
|
|
191
|
+
.title
|
|
192
|
+
.views
|
|
193
|
+
.tags
|
|
194
|
+
.teaser
|
|
195
|
+
</pre>
|
|
133
196
|
<p>
|
|
134
197
|
|
|
135
|
-
|
|
136
|
-
|
|
198
|
+
<b>Dot commands - more advanced</b>
|
|
199
|
+
<pre>
|
|
200
|
+
.image
|
|
201
|
+
.inset
|
|
202
|
+
.dropcap
|
|
203
|
+
.pin
|
|
204
|
+
</pre>
|
|
137
205
|
<p>
|
|
138
206
|
|
|
139
|
-
|
|
207
|
+
<b>Variables and functions</b>
|
|
208
|
+
<pre>
|
|
209
|
+
$view, etc.
|
|
210
|
+
$\[date is undefined], $\[link is undefined], etc.
|
|
211
|
+
</pre>
|
|
140
212
|
<p>
|
|
141
213
|
|
|
142
|
-
(variables and functions)
|
|
143
214
|
<p>
|
|
144
215
|
|
|
145
216
|
## Defining your own features
|
|
146
|
-
|
|
217
|
+
<b>Dot commands, variables, functions</b>
|
|
218
|
+
<pre>
|
|
219
|
+
.def/.end
|
|
220
|
+
.set
|
|
221
|
+
.variables
|
|
222
|
+
.heredoc
|
|
223
|
+
.func
|
|
224
|
+
</pre>
|
|
147
225
|
<p>
|
|
148
226
|
|
|
149
|
-
|
|
227
|
+
<b>Defining these in Ruby</b>
|
|
228
|
+
<p>
|
|
229
|
+
|
|
230
|
+
<p>
|
|
231
|
+
|
|
232
|
+
## More topics
|
|
233
|
+
<b>Meta tags, etc.</b>
|
|
234
|
+
<b>CSS</b>
|
|
235
|
+
<p>
|
|
236
|
+
|
|
237
|
+
<b>Widgets</b>
|
|
238
|
+
<pre>
|
|
239
|
+
pages
|
|
240
|
+
links
|
|
241
|
+
pinned
|
|
242
|
+
faq
|
|
243
|
+
sitemap
|
|
244
|
+
news
|
|
245
|
+
etc.
|
|
246
|
+
</pre>
|
|
247
|
+
<p>
|
|
248
|
+
|
|
249
|
+
<b>Banner and navbar</b>
|
|
250
|
+
<p>
|
|
251
|
+
|
|
252
|
+
<b>Creating your own widgets</b>
|
|
253
|
+
<p>
|
|
254
|
+
|
|
255
|
+
<b>Special tags coming "soon"</b>
|
|
256
|
+
<pre>
|
|
257
|
+
github, gitlab, gist
|
|
258
|
+
wikipedia
|
|
259
|
+
youtube, vimeo
|
|
260
|
+
twitter, instagram
|
|
261
|
+
etc.
|
|
262
|
+
</pre>
|
|
150
263
|
<p>
|
|
151
264
|
|
|
152
|
-
*TBD
|
|
153
265
|
<p>
|
|
154
266
|
|
|
155
|
-
|
|
156
|
-
*TBD
|
|
267
|
+
<b>TBD</b>
|
|
157
268
|
<p>
|
|
158
269
|
|
|
159
270
|
## More later...
|
|
160
|
-
|
|
271
|
+
<b>TBD</b>
|
|
161
272
|
<p>
|
|
162
273
|
|