|
@@ -1,4 +1,4 @@
|
|
|
-#+OPTIONS: H:3 num:nil toc:2 \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:t skip:nil d:(HIDE) tags:not-in-toc
|
|
|
+#+OPTIONS: H:3 num:nil toc:2 \n:nil ::t |:t ^:{} -:t f:t *:t tex:t d:(HIDE) tags:not-in-toc
|
|
|
#+STARTUP: align fold nodlcheck hidestars oddeven lognotestate
|
|
|
#+SEQ_TODO: TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
|
|
|
#+TAGS: Write(w) Update(u) Fix(f) Check(c)
|
|
@@ -40,7 +40,7 @@ creates interactive web pages with [[http://orgmode.org][Org-Mode]].
|
|
|
recently edited pages, and/or directory listings can optionally
|
|
|
be presented in a sidebar. These are controlled through the
|
|
|
=recent= and =dir_list= configuration options.
|
|
|
-5) *Themes* The [[http://github.com/eschulte/blorgit_themes/tree/master][blorgit\_themes]] git repository holds prepackaged
|
|
|
+5) *Themes* The [[http://github.com/eschulte/blorgit_themes/tree/master][blorgit_themes]] git repository holds prepackaged
|
|
|
themes for blorgit. These can be applied to your installation
|
|
|
using the supplied rake commands. For a list of available themes
|
|
|
run =rake themes= from the root of your blorgit installation.
|
|
@@ -77,8 +77,8 @@ creates interactive web pages with [[http://orgmode.org][Org-Mode]].
|
|
|
#+end_src
|
|
|
|
|
|
Update the submodules of blorgit to provide file based persistence
|
|
|
- ([[http://github.com/eschulte/active_file/tree/master][active\_file]]), org-mode interaction ([[http://github.com/eschulte/acts_as_org/tree/master][acts\_as\_org]]), and themes
|
|
|
- ([[http://github.com/eschulte/blorgit_themes/tree/master][blorgit\_themes]]).
|
|
|
+ ([[http://github.com/eschulte/active_file/tree/master][active_file]]), org-mode interaction ([[http://github.com/eschulte/acts_as_org/tree/master][acts_as_org]]), and themes
|
|
|
+ ([[http://github.com/eschulte/blorgit_themes/tree/master][blorgit_themes]]).
|
|
|
|
|
|
#+begin_src sh
|
|
|
cd blorgit
|
|
@@ -155,12 +155,12 @@ rake themes:org # an org-mode theme featuring the folding unicorn
|
|
|
The configuration is controlled through a [[http://www.yaml.org][YAML]] file located at
|
|
|
=blorgit.yml= in the base of your blorgit installation. Configuration
|
|
|
variables can be used to control the *title*, *index page*,
|
|
|
-*stylesheet*, the number of *recent entries* and *directory\_listings*
|
|
|
+*stylesheet*, the number of *recent entries* and *directory_listings*
|
|
|
shown in the sidebar, automatic synchronization with a *git*
|
|
|
repository, *commentability*, *editability* and optional *password
|
|
|
protection* for posting edits, . The default configuration is...
|
|
|
|
|
|
-#<<configuration_options>>
|
|
|
+#+name: configuration_options
|
|
|
#+begin_src sh
|
|
|
---
|
|
|
title: Blorgit
|
|
@@ -227,31 +227,31 @@ from this Emacs instance as follows...
|
|
|
|
|
|
1) ssh into your remote server
|
|
|
2) start your screen session with the =screen= command
|
|
|
-#+begin_src sh
|
|
|
-screen
|
|
|
-#+end_src
|
|
|
+ #+begin_src sh
|
|
|
+ screen
|
|
|
+ #+end_src
|
|
|
3) cd to your blorgit directory
|
|
|
-#+begin_src sh
|
|
|
-cd ~/src/blorgit
|
|
|
-#+end_src
|
|
|
+ #+begin_src sh
|
|
|
+ cd ~/src/blorgit
|
|
|
+ #+end_src
|
|
|
4) start emacs loading the =org-interaction.el= file
|
|
|
-#+begin_src sh
|
|
|
-emacs -l backend/acts_as_org/elisp/org-interaction.el
|
|
|
-#+end_src
|
|
|
+ #+begin_src sh
|
|
|
+ emacs -l backend/acts_as_org/elisp/org-interaction.el
|
|
|
+ #+end_src
|
|
|
5) optionally run your webserver through screen as well by
|
|
|
1) switching to a new screen window with =\C-a c=
|
|
|
2) start your webserver
|
|
|
-#+begin_src sh
|
|
|
-./run.ru -sthin
|
|
|
-#+end_src
|
|
|
+ #+begin_src sh
|
|
|
+ ./run.ru -sthin
|
|
|
+ #+end_src
|
|
|
6) disconnect form screen leaving emacs and the webserver running with
|
|
|
=\C-a d=
|
|
|
7) logoff from the server
|
|
|
8) at any later date you can log back into the server and reattach to
|
|
|
the original screen session with
|
|
|
-#+begin_src sh
|
|
|
-screen -r
|
|
|
-#+end_src
|
|
|
+ #+begin_src sh
|
|
|
+ screen -r
|
|
|
+ #+end_src
|
|
|
|
|
|
** Extending Blorgit
|
|
|
Simplicity and a small hackable code base were key goals in the
|
|
@@ -289,9 +289,13 @@ used with blorgit.
|
|
|
mv blorgit foods
|
|
|
#+end_src
|
|
|
5) Configure blorgit as you would normally (see [[* Getting Started (installation and use)][Getting Started (installation and use)]])
|
|
|
-6) Add your new blorgit site to Passenger Pane. [[file:images/blorgit/Passenger.png]]
|
|
|
+6) Add your new blorgit site to Passenger Pane.
|
|
|
+
|
|
|
+ [[file:images/blorgit/Passenger.png]]
|
|
|
7) Restart Apache
|
|
|
#+begin_src sh
|
|
|
sudo apachectl restart
|
|
|
#+end_src
|
|
|
-8) Point your browser at the url displayed in the Passenger Pane. [[file:images/blorgit/foods.png]]
|
|
|
+8) Point your browser at the url displayed in the Passenger Pane.
|
|
|
+
|
|
|
+ [[file:images/blorgit/foods.png]]
|