runeblog 0.1.61 → 0.1.62

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7453b5f695da487a1597153fc5d1d50f6587f1af6034ffc9b0d8e11d8fdcea18
-  data.tar.gz: 0d96a8a534c8835a486c2e58685d98696919483c880221ef6e0333b39a7b868a
+  metadata.gz: e021bb5ab60b228bcc7dd8b0e088af60487f684b6c64abc619f09cbbdd843c8a
+  data.tar.gz: 572d365ddb2687da51026203f2ab4d88aeead5d84e891df5aeec6270f6e446c0
 SHA512:
-  metadata.gz: 786b5590bbfea02bc77382d06f6ccf4ed465da0140b96d09cecd1e9297fded5d9a7b82013b235f64c7be3f13d125c9582ad92d0f5a4448bf7917310f1a93a923
-  data.tar.gz: ad8870b822206825c0a175003f5772f114724401931d64d18b3f3a3bfeae135f60fc12793525d605d40010be2ed3e32b163cd8a3dafa8516a8e87bab010ea32d
+  metadata.gz: 2917038cd8e6cadb31ee669027c19c7e2e35f96223a0beeb7df7da360af86042cb2d26403ed2df0a8cf3f4a3eef6936124d601771ff52742ed2fb284ea4d534b
+  data.tar.gz: 12c24806b6a78b9661ee51df1736591bdc7cd37fb311a20d9f1377213e53b53aa997a8ddb657058fed76fffc4d226f990f8f89d5468c3fdc2d9ef68b6ec6df59

data/README.lt3

@@ -102,5 +102,41 @@ The next thing you should do is to create at least one view of your own. Use the
 
 *[To be continued]
 
+.h2 Changing the default templates
+
+*TBD
+
+.h2 Basics of Livetext
+
+*TBD
+
+(bold, italics, etc.)
+
+(common dot commands)
+
+(predefined functions and variables)
+
+.h2 Runeblog-specific features (Liveblog)
+
+*TBD
+
+(dot commands)
+
+(variables and functions)
+
+.h2 Defining your own features
+
+(dot commands)
+
+(variables and functions)
+
+*TBD
+
+.h2
+
+*TBD
+
 .h2 More later...
 
+*TBD
+

data/README.md

@@ -7,13 +7,16 @@ Runeblog is a blogging tool written in Ruby. It has these basic characteristics:
  * 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
+The multiple views are in effect multiple blogs managed with the same backend.
+<p>
+
 ## 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 <i>in Ruby</i>. 
+formatters such as <font size=+1><tt>nroff</tt></font>. It's very flexible, and it is extensible <i>in Ruby</i>. 
 <p>
 
-It isn't yet full-featured, but it is usable. Runeblog uses Livetext, along 
-with some custom definitions, to try to ease the formatting of a blog entry.
+It is far from mature or full-featured, but it is usable. Runeblog uses Livetext, 
+along with some custom definitions, to try to ease the formatting of a blog entry.
 <p>
 
 ## What are "views"?
@@ -32,8 +35,13 @@ But the important points are these:
  * 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
 ## The `blog environment
-There is a command-line tool called <tt>blog</tt> which is a REPL (read-eval-print loop). 
+There is a command-line tool called <font size=+1><tt>blog</tt></font> 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).
+<p>
+
 The help message looks like this:
 <p>
 
@@ -43,7 +51,7 @@ The help message looks like this:
      h, help           This message
      q, quit           Exit the program
 
-     change view <i>view</i> 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
@@ -53,19 +61,93 @@ The help message looks like this:
      lsp, list posts   List posts in current view
      lsd, list drafts  List all posts regardless of view
 
-     rm <i>id</i>             Remove a post
-     edit <i>id</i>           Edit a post
+     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)
 </pre>
-## More later...
+## Getting started
+But when you first run the REPL, it checks for an existing blog under the <font size=+1><tt>.blog</tt></font>
+directory. If it doesn't find one, it asks whether you want to create a new blog.
+If you enter <font size=+1><tt>y</tt></font> for yes, it creates a sort of "skeleton" with a single view
+called <font size=+1><tt>test_view</tt></font>.
+<p>
+
+The next thing you should do is to create at least one view of your own. Use the
+<font size=+1><tt>new view</tt></font> command for this.  
+<p>
+
+(new view)
+<p>
+
+(new post)
+<p>
+
+(preview)
+<p>
+
+(publishing one-time setup - server, ssh keys, etc.)
+<p>
+
+(publish)
+<p>
+
+(browse)
+<p>
+
+(and so on...)
+<p>
+
 <b>To be continued</b>
 <p>
 
+## Changing the default templates
+<b>TBD</b>
+<p>
+
+## Basics of Livetext
+<b>TBD</b>
+<p>
+
+(bold, italics, etc.)
+<p>
+
+(common dot commands)
+<p>
+
+(predefined functions and variables)
+<p>
+
+## Runeblog-specific features (Liveblog)
+<b>TBD</b>
+<p>
+
+(dot commands)
+<p>
+
+(variables and functions)
+<p>
+
+## Defining your own features
+(dot commands)
+<p>
+
+(variables and functions)
+<p>
+
+<b>TBD</b>
+<p>
+
+## 
+<b>TBD</b>
+<p>
+
+## More later...
+<b>TBD</b>
 <p>
 

data/lib/liveblog.rb

@@ -222,3 +222,23 @@ def finalize
   @meta
 end
  
+Dot = self   # Clunky! for dot commands called from Functions class
+
+# Find a better way to do this?
+
+class LiveText::Functions
+
+  def br
+    # Thought: Maybe make a way for functions to "simply" call the
+    #   dot command of the same name?? Is this trivial??
+    # Also: Should probably pass as a "real" function parameter?
+    n = self.class.param
+    n = n.empty? ? 1 : n.to_i
+    "<br>"*n
+  end
+
+  def hr
+    Dot.hr
+  end
+
+end

data/lib/runeblog_version.rb

@@ -1,6 +1,6 @@
 
 class RuneBlog
-  VERSION = "0.1.61"
+  VERSION = "0.1.62"
 
   Path  = File.expand_path(File.join(File.dirname(__FILE__)))
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: runeblog
 version: !ruby/object:Gem::Version
-  version: 0.1.61
+  version: 0.1.62
 platform: ruby
 authors:
 - Hal Fulton
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-16 00:00:00.000000000 Z
+date: 2019-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: livetext