![]() |
![]()
| ![]() |
![]()
NAME
SYNOPSIS
DESCRIPTIONEphemera is an event-driven SCGI application server dedicated to serving-up a single blog with no comment facility. Ephemera is for people who have their own hosts on which they can install software, who know HTML5 and CSS, and who prefer working with text-based tools. Posts are stored in an in-memory SQLite database that is read from disk at startup. Yes, Sunshine, you can afford to keep the database in memory. The complete works of Shakespeare in plain text are less than 6 MiB. MANAGING CONTENTYou write your posts in HTML5. You can put whatever elements you like into your posts, but the database stores only the HTML. If you want to reference other resources, you will need to create web-visible directories to hold those resources. There is no web interface for managing content because I would rather be rolled in seal oil and exposed to polar bears than use web-based tools. You manage the on-disk database with six munger(1) scripts that work with plain text. Five are command-line tools that can be used for one-off operations or shell scripting. The sixth is an interactive fullscreen database editor. The scripts send the server a SIGHUP to notify it to reload the database. For example, you can add posts from remote hosts like this: ssh user@host '/usr/local/bin/add.munger /path/to/db/ephemera.sqlite' < post.txt My goodness. That is a prime candidate for a shell alias. The munger scripts are located in /usr/local/bin and are documented internally with comments. All scripts require the path to the database file to be passed as a command line argument. Ephemera serves up UTF-8 encoded web pages, but munger does not understand UTF-8. This means that you can use the munger scripts to manipulate UTF-8 articles, but the motion and search commands in edit.munger will move to the wrong locations on lines with multibyte characters. The five command-line scripts are named create.munger, add.munger, replace.munger, delete.munger, and extract.munger. The sixth script, edit.munger, is an interactive console program to view, add, delete, edit, and search for posts in the database. The following commands are available.
CONFIGURATIONIf it cannot allocate memory from the system, ephemera exits. You need to set the maximum number of simultaneous connections with the -m option to a value that is suitable for your host's resources. To configure ephemera:
SERVER OPTIONSThe following command line options are available. To use an option, insert it into the value of the ephemera_flags variable in /etc/rc.conf. For example, ephemera_enable="YES" ephemera_flags="-u www -g www -l /var/run/ephemera.socket"
AUTHORSJames Bailie
⟨jimmy@mammothcheese.ca⟩
|