runeblog 0.3.02

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: af242702c47c1cad260040a42b4fe58f5fb84e83934bfa80e0f12fd3e7083c9c
+  data.tar.gz: 90b1d17454ce166e5c89b1c8ed6cc43f129a708a14200b94a1bb5c2a5a721a7b
+SHA512:
+  metadata.gz: a70f36f01ebdfc94db5b6794b8975b876b0255b154d8393d87e7728f19010c478daaa93462cbb21aa0bee539c4d4a922640d8c92f7f3707538974d5cbe60f65d
+  data.tar.gz: 50d5b646a4fa6e050f0aedb2789371c61fd5115ce35d03051b3ce690f113b47182782951ac8a6e7742bbf1316e7791fcccfd653d2d67911bf75b4bf3e62ae4a6

data/README.lt3

@@ -0,0 +1,279 @@
+.mixin markdown
+<div style="float: left; align: left; vertical-align: bottom">
+<img src="readme/raido4.png" width="210" height="295" align="left"></img>
+</div>
+<h1>runeblog</h1><b>Runeblog</b> is a blogging tool written in Ruby. It has these basic characteristics:
+<ul>
+  <li>It is usable entirely in text mode from the terminal</li>
+  <li>It publishes web pages as static HTML</li>
+  <li>So far, yes, like Jekyll</li>
+  <li>It's based on Livetext (highly extensible Ruby-based markup)</li>
+  <li>It has the concept of multiple "views" for a blog</li>
+  <li>The multiple views are in effect multiple blogs managed with the same backend.</li>
+</ul>
+
+
+
+.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]. 
+
+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.
+
+.h2 What are "views"?
+
+Think of them as multiple separate blogs with the same backend. Why would you
+want to do this? Maybe you wouldn't, but I do.
+
+The purpose is to present different "faces" to different audiences. In my case,
+my computing-related stuff would go into one view, and my hometown-related things
+would go into another. There might be a view that only old friends or close friends
+can see. There might be a view purely for reviews of music, books, and movies. 
+
+But the important points are these:
+
+.list
+<i>All</i> 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 <tt>blog</tt> 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
+  <b>Basics:</b>                                         <b>Views:</b>
+  -------------------------------------------     -------------------------------------------
+  <b>h, help</b>           This message                  <b>change view VIEW</b>  Change current view
+  <b>q, quit</b>           Exit the program              <b>cv VIEW</b>           Change current view
+  <b>v, version</b>        Print version information     <b>new view</b>          Create a new view
+  <b>clear</b>             Clear screen                  <b>list views</b>        List all views available
+                                                  <b>lsv</b>               Same as: list views
+<br>
+  <b>Posts:</b>                                          <b>Advanced:</b>
+  -------------------------------------------     -------------------------------------------
+  <b>p, post</b>           Create a new post             <b>config</b>            Edit various system files
+  <b>new post</b>          Same as p, post               <b>customize</b>         (BUGGY) Change set of tags, extra views
+  <b>lsp, list posts</b>   List posts in current view    <b>preview</b>           Look at current (local) view in browser
+  <b>lsd, list drafts</b>  List all drafts (all views)   <b>browse</b>            Look at current (published) view in browser
+  <b>delete ID [ID...]</b> Remove multiple posts         <b>rebuild</b>           Regenerate all posts and relink
+  <b>undelete ID</b>       Undelete a post               <b>publish</b>           Publish (current view)
+  <b>edit ID</b>           Edit a post                   <b>ssh</b>               Login to remote server
+  <b>import ASSETS</b>     Import assets (images, etc.)  <b>manage WIDGET</b>     Manage content/layout of a widget
+.end
+
+.h2 Getting started
+
+But when you first run the REPL, it checks for an existing blog repository under 
+the `[.blogs] directory. If it doesn't find one, it asks whether you want to create 
+a new blog repo. Enter `y for yes.
+. If you enter `y for yes, it creates a sort of "skeleton" with a single view called `[test_view].
+
+You'll then enter the editor (vim for now) to add configuration info to the `global.lt3 file.
+
+<!-- <pre><b>FIXME add menu screenshot here</b></pre> -->
+<!-- <pre><b>FIXME add vim screenshot here</b></pre> -->
+<img src="readme/vim-global.png" width="494" height="696" align="center"></img>
+
+The next thing you should do is to create at least one view of your own. Use the `[new view] 
+command for this. Note that the current view is displayed as part of the prompt.
+
+<pre>
+<b>[no view]</b> new view mystuff<br>
+<b>[mystuff]</b>
+</pre>
+
+To create a new post, use the `[new post] command (also abbreviated `post or simply `[p]). You will be
+prompted for a title:
+
+<pre>
+<b>[mystuff]</b> new post<br>
+<b>Title:</b> This is my first post
+</pre>
+
+Then you'll be sent into the editor (currently vim but can be others):
+
+<img src="readme/edit-first.png" width="506" height="383" align="center"></img>
+
+<pre>
+<b>FIXME wizard?</b>
+(publishing one-time setup - server, ssh keys, etc.)
+preview...
+publish...
+browse...
+(and so on)
+</pre>
+
+<b>To be continued</b>
+
+.h2 Customizing the default templates and configuration
+
+You can use the `config command to choose a file to edit.
+
+<img src="readme/config-menu.png" width="700" height="547" align="center"></img>
+
+The meaning and interaction of these files will be explained later. *FIXME
+
+When you make changes, `rebuild will detect these and regenerate whatever files
+are needed.
+
+.h2 The directory structure for a view
+
+<b>Subject to change</b>
+TBD: Add details
+
+<pre>
+    .blogs/views/mystuff/
+    ├── assets
+    ├── posts
+    ├── remote
+    │   ├── assets
+    │   ├── banner
+    │   ├── etc
+    │   ├── permalink
+    │   └── widgets
+    │       ├── ad
+    │       ├── links
+    │       ├── news
+    │       ├── pages
+    │       └── pinned
+    └── themes
+        └── standard
+            ├── banner
+            ├── blog
+            ├── etc
+            ├── post
+            └── widgets
+                ├── ad
+                ├── bydates
+                ├── links
+                ├── news
+                ├── pages
+                ├── pinned
+                ├── search
+                ├── sitemap
+                └── tag-cloud
+</pre>
+
+<pre><b>FIXME add details here</b></pre>
+
+
+.h2 Basics of Livetext
+
+<b>TBD</b>
+
+<b>Bold, italics, etc.</b>
+  single, double, bracketed
+
+<b>Common dot commands)
+<pre>
+  .debug
+  .say
+  .nopara
+  .quit
+  indented dot-commands
+</pre>
+
+<b>Using external files</b>
+<pre>
+  .mixin
+  .include
+  .copy
+  .seek
+</pre>
+
+<b>Predefined functions and variables</b>
+<pre>
+  \$File
+  `[\$\$date]
+  etc.
+</pre>
+
+.h2 Runeblog-specific features (Liveblog)</b>
+
+<b>TBD</b>
+
+<b>Dot commands - the basics</b>
+<pre>
+  .mixin liveblog
+  .post
+  .title
+  .views
+  .tags
+  .teaser
+</pre>
+
+<b>Dot commands - more advanced</b>
+<pre>
+  .image
+  .inset
+  .dropcap
+  .pin
+</pre>
+
+<b>Variables and functions</b>
+<pre>
+  \$view, etc.
+  \$\$date, \$\$link, etc.
+</pre>
+
+
+.h2 Defining your own features
+
+<b>Dot commands, variables, functions</b>
+<pre>
+  .def/.end
+  .set
+  .variables
+  .heredoc
+  .func
+</pre>
+
+<b>Defining these in Ruby</b>
+
+
+.h2 More topics
+
+<b>Meta tags, etc.</b>
+<b>CSS</b>
+
+<b>Widgets</b>
+<pre>
+  pages
+  links 
+  pinned
+  faq
+  sitemap
+  news
+  etc.
+</pre>
+
+<b>Banner and navbar</b>
+
+<b>Creating your own widgets</b>
+
+<b>Special tags/functions coming "soon"</b>
+<pre>
+  github, gitlab, gist
+  wikipedia
+  youtube, vimeo
+  twitter, instagram
+  etc.
+</pre>
+
+
+<b>TBD</b>
+
+.h2 More later...
+
+<b>TBD</b>
+

data/README.md

@@ -0,0 +1,312 @@
+<div style="float: left; align: left; vertical-align: bottom">
+<img src="readme/raido4.png" width="210" height="295" align="left"></img>
+</div>
+<h1>runeblog</h1><b>Runeblog</b> is a blogging tool written in Ruby. It has these basic characteristics:
+<ul>
+  <li>It is usable entirely in text mode from the terminal</li>
+  <li>It publishes web pages as static HTML</li>
+  <li>So far, yes, like Jekyll</li>
+  <li>It's based on Livetext (highly extensible Ruby-based markup)</li>
+  <li>It has the concept of multiple "views" for a blog</li>
+  <li>The multiple views are in effect multiple blogs managed with the same backend.</li>
+</ul>
+<p>
+
+<p>
+
+<p>
+
+## What is Livetext?
+Livetext is a markup format that is a throwback to the old, old days of text 
+formatters such as <font size=+1><tt>roff</tt></font> It's very flexible, and it is extensible <i>in Ruby</i>. 
+<p>
+
+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"?
+Think of them as multiple separate blogs with the same backend. Why would you
+want to do this? Maybe you wouldn't, but I do.
+<p>
+
+The purpose is to present different "faces" to different audiences. In my case,
+my computing-related stuff would go into one view, and my hometown-related things
+would go into another. There might be a view that only old friends or close friends
+can see. There might be a view purely for reviews of music, books, and movies. 
+<p>
+
+But the important points are these:
+<p>
+
+ * <i>All</i> 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
+## The <tt>blog</tt> environment
+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>
+
+<pre>
+  <b>Basics:</b>                                         <b>Views:</b>
+  -------------------------------------------     -------------------------------------------
+  <b>h, help</b>           This message                  <b>change view VIEW</b>  Change current view
+  <b>q, quit</b>           Exit the program              <b>cv VIEW</b>           Change current view
+  <b>v, version</b>        Print version information     <b>new view</b>          Create a new view
+  <b>clear</b>             Clear screen                  <b>list views</b>        List all views available
+                                                  <b>lsv</b>               Same as: list views
+<br>
+  <b>Posts:</b>                                          <b>Advanced:</b>
+  -------------------------------------------     -------------------------------------------
+  <b>p, post</b>           Create a new post             <b>config</b>            Edit various system files
+  <b>new post</b>          Same as p, post               <b>customize</b>         (BUGGY) Change set of tags, extra views
+  <b>lsp, list posts</b>   List posts in current view    <b>preview</b>           Look at current (local) view in browser
+  <b>lsd, list drafts</b>  List all drafts (all views)   <b>browse</b>            Look at current (published) view in browser
+  <b>delete ID [ID...]</b> Remove multiple posts         <b>rebuild</b>           Regenerate all posts and relink
+  <b>undelete ID</b>       Undelete a post               <b>publish</b>           Publish (current view)
+  <b>edit ID</b>           Edit a post                   <b>ssh</b>               Login to remote server
+  <b>import ASSETS</b>     Import assets (images, etc.)  <b>manage WIDGET</b>     Manage content/layout of a widget
+</pre>
+## Getting started
+But when you first run the REPL, it checks for an existing blog repository under 
+the <font size=+1><tt>.blogs</tt></font> directory. If it doesn't find one, it asks whether you want to create 
+a new blog repo. Enter <font size=+1><tt>y</tt></font>  for yes.
+<p>
+
+You'll then enter the editor (vim for now) to add configuration info to the <font size=+1><tt>global.lt3</tt></font>  file.
+<p>
+
+<!-- <pre><b>FIXME add menu screenshot here</b></pre> -->
+<!-- <pre><b>FIXME add vim screenshot here</b></pre> -->
+<img src="readme/vim-global.png" width="494" height="696" align="center"></img>
+<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. Note that the current view is displayed as part of the prompt.
+<p>
+
+<pre>
+<b>[no view]</b> new view mystuff<br>
+<b>[mystuff]</b>
+</pre>
+<p>
+
+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
+prompted for a title:
+<p>
+
+<pre>
+<b>[mystuff]</b> new post<br>
+<b>Title:</b> This is my first post
+</pre>
+<p>
+
+Then you'll be sent into the editor (currently vim but can be others):
+<p>
+
+<img src="readme/edit-first.png" width="506" height="383" align="center"></img>
+<p>
+
+<pre>
+<b>FIXME wizard?</b>
+(publishing one-time setup - server, ssh keys, etc.)
+preview...
+publish...
+browse...
+(and so on)
+</pre>
+<p>
+
+<b>To be continued</b>
+<p>
+
+## Customizing the default templates and configuration
+You can use the <font size=+1><tt>config</tt></font>  command to choose a file to edit.
+<p>
+
+<img src="readme/config-menu.png" width="700" height="547" align="center"></img>
+<p>
+
+The meaning and interaction of these files will be explained later. <b>FIXME</b>
+<p>
+
+When you make changes, <font size=+1><tt>rebuild</tt></font>  will detect these and regenerate whatever files
+are needed.
+<p>
+
+## The directory structure for a view
+<b>Subject to change</b>
+TBD: Add details
+<p>
+
+<pre>
+    .blogs/views/mystuff/
+    ├── assets
+    ├── posts
+    ├── remote
+    │   ├── assets
+    │   ├── banner
+    │   ├── etc
+    │   ├── permalink
+    │   └── widgets
+    │       ├── ad
+    │       ├── links
+    │       ├── news
+    │       ├── pages
+    │       └── pinned
+    └── themes
+        └── standard
+            ├── banner
+            ├── blog
+            ├── etc
+            ├── post
+            └── widgets
+                ├── ad
+                ├── bydates
+                ├── links
+                ├── news
+                ├── pages
+                ├── pinned
+                ├── search
+                ├── sitemap
+                └── tag-cloud
+</pre>
+<p>
+
+<pre><b>FIXME add details here</b></pre>
+<p>
+
+<p>
+
+## Basics of Livetext
+<b>TBD</b>
+<p>
+
+<b>Bold, italics, etc.</b>
+  single, double, bracketed
+<p>
+
+<b>Common dot commands)
+<pre>
+  .debug
+  .say
+  .nopara
+  .quit
+  indented dot-commands
+</pre>
+<p>
+
+<b>Using external files</b>
+<pre>
+  .mixin
+  .include
+  .copy
+  .seek
+</pre>
+<p>
+
+<b>Predefined functions and variables</b>
+<pre>
+  $File
+  <font size=+1><tt></tt></font>
+  etc.
+</pre>
+<p>
+
+## Runeblog-specific features (Liveblog)</b>
+<b>TBD</b>
+<p>
+
+<b>Dot commands - the basics</b>
+<pre>
+  .mixin liveblog
+  .post
+  .title
+  .views
+  .tags
+  .teaser
+</pre>
+<p>
+
+<b>Dot commands - more advanced</b>
+<pre>
+  .image
+  .inset
+  .dropcap
+  .pin
+</pre>
+<p>
+
+<b>Variables and functions</b>
+<pre>
+  $view, etc.
+  $\[date is undefined], $\[link is undefined], etc.
+</pre>
+<p>
+
+<p>
+
+## Defining your own features
+<b>Dot commands, variables, functions</b>
+<pre>
+  .def/.end
+  .set
+  .variables
+  .heredoc
+  .func
+</pre>
+<p>
+
+<b>Defining these in Ruby</b>
+<p>
+
+<p>
+
+## More topics
+<b>Meta tags, etc.</b>
+<b>CSS</b>
+<p>
+
+<b>Widgets</b>
+<pre>
+  pages
+  links 
+  pinned
+  faq
+  sitemap
+  news
+  etc.
+</pre>
+<p>
+
+<b>Banner and navbar</b>
+<p>
+
+<b>Creating your own widgets</b>
+<p>
+
+<b>Special tags/functions coming "soon"</b>
+<pre>
+  github, gitlab, gist
+  wikipedia
+  youtube, vimeo
+  twitter, instagram
+  etc.
+</pre>
+<p>
+
+<p>
+
+<b>TBD</b>
+<p>
+
+## More later...
+<b>TBD</b>
+<p>
+