./README.lt3 in runeblog-0.1.59 vs ./README.lt3 in runeblog-0.1.61
- old
+ new
@@ -10,10 +10,12 @@
So far, yes, like Jekyll
It's based on Livetext (highly extensible Ruby-based markup)
It has the concept of multiple "views" for a blog
.end
+The multiple views are in effect multiple blogs managed with the same backend.
+
.h2 What is Livetext?
Livetext is a markup format that is a throwback to the old, old days of text
formatters such as ``nroff. It's very flexible, and it is extensible _[in Ruby].
@@ -34,24 +36,28 @@
.list
_All the views will be managed the same way in the same place, and they will all share common data.
Any post can easily be included in a single view, in more than one, or in all of them.
Each view can have its own look and feel, and it can be linked/published separately from the others.
Each view can be hosted in a different location and/or a different server and domain
+Any post can be in more than one view
.end
.h2 The `blog environment
There is a command-line tool called `blog which is a REPL (read-eval-print loop).
+Note that this tool is a curses-based environment (mainly so it can display menus
+and such to the user).
+
The help message looks like this:
.mono
Commands:
h, help This message
q, quit Exit the program
- change view _view Change current view
+ change view _view Change current view
new view Create a new view
list views List all views available
lsv Same as: list views
p, post Create a new post
@@ -60,18 +66,41 @@
lsd, list drafts List all posts regardless of view
rm _id Remove a post
edit _id Edit a post
- open Look at current (local) view in browser
- open remote Look at current (deployed) view in browser
+ preview Look at current (local) view in browser
+ browse Look at current (deployed) view in browser
- relink Regenerate index for all views
- rebuild Regenerate all posts and relink
+ relink Regenerate index for all views (MAY CHANGE)
+ rebuild Regenerate all posts and relink (MAY CHANGE)
deploy Deploy (current view)
.end
-.h2 More later...
+.h2 Getting started
+But when you first run the REPL, it checks for an existing blog under the `.blog
+directory. If it doesn't find one, it asks whether you want to create a new blog.
+If you enter `y for yes, it creates a sort of "skeleton" with a single view
+called ``test_view.
+
+The next thing you should do is to create at least one view of your own. Use the
+`[new view] command for this.
+
+(new view)
+
+(new post)
+
+(preview)
+
+(publishing one-time setup - server, ssh keys, etc.)
+
+(publish)
+
+(browse)
+
+(and so on...)
+
*[To be continued]
+.h2 More later...