runeblog 0.2.56 → 0.2.61
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.
- checksums.yaml +4 -4
- data/README.lt3 +164 -69
- data/README.md +176 -65
- data/bin/blog +52 -4
- data/empty_view/themes/standard/banner/list.data +3 -0
- data/empty_view/themes/standard/blog/index.lt3 +1 -1
- data/empty_view/themes/standard/widgets/links/links.rb +21 -7
- data/empty_view/themes/standard/widgets/news/news.rb +70 -0
- data/empty_view/themes/standard/widgets/pages/pages.rb +70 -3
- data/empty_view/themes/standard/widgets/pinned/pinned.rb +26 -22
- data/lib/liveblog.rb +87 -83
- data/lib/post.rb +6 -6
- data/lib/repl.rb +4 -17
- data/lib/runeblog.rb +32 -6
- data/lib/runeblog_version.rb +1 -1
- data/runeblog.gemspec +1 -1
- data/test/austin.rb +3 -2
- metadata +5 -10
- data/empty_view/remote/navbar/GIT_IS_DUMB +0 -1
- data/empty_view/themes/standard/banner/navbar.lt3 +0 -17
- data/empty_view/themes/standard/navbar/about.lt3 +0 -18
- data/empty_view/themes/standard/navbar/contact.lt3 +0 -18
- data/empty_view/themes/standard/navbar/faq.lt3 +0 -1
- data/empty_view/themes/standard/navbar/navbar.lt3 +0 -16
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 65a0fbb53ba0184ee98c700924397a7054684add4f5516508410cfdbbfb742cd
|
|
4
|
+
data.tar.gz: fa4a3f7a744cf1ec29203ee172d111800a1bf0f6402a99fe07a05053dc8b7f86
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: e6b1a30fb4f7d2682747516d099915d232d49a48c26bfe7c42ea8d33cce49ee27cab3d488b636ad24abeafb239f79ecbe92790019077d48ac59d484e0a0c2f5b
|
|
7
|
+
data.tar.gz: bc0f11f41b53e6cf625d85e84adf52bb13317417f303041fac1dc5974120433348a38924932d35ce3cc65034945fa6e9247ba9efd4e1b86643e1372e6ab04e46
|
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
|
|