A blog posting tool. Creates static HTML and ATOM feeds from Markdown posts.
It should be considered pre-alpha quality. You probably will not like it. It is
only for fulfilling my personal blogging needs.
Requirements
Uses NodeJS to run.
Installing
- Clone this repository, or a fork of it.
- cd delposto
- npm link
You may need to run sudo npm link
for it to work.
Now you can type delposto
to see a list of commands. Right now the command
help is not really useful.
Commands
create
delposto create foo
This will create a new directory called foo
with the templates and metadata
for the blog. It will ask you a few questions to set up the blog.
draft
delposto draft bar
Creates a drafts/bar.md
file for a new draft. Fill in the title, tags, and
any comment link above the ~
separator, with the contents of the post going
after the '~'.
Anything above the ~
is treated as YAML, so it should be formatted
appropriately.
Typing this:
delposto draft bar/
will create a drafts/bar
directory, with a drafts/bar/index.md
for the
post's contents. This directory creation allows you to put any images or other
assets for the post along with the post's contents.
preview
delposto preview drafts/bar.md
This will preview the post in published/preview/month/day/slugged-title/
, and
it will watch drafts/bar.md
for changes and regenerate the preview as the
draft changes. You will need to manually reload the preview in the browser
though.
If you used delposto draft bar/
to create a directory-based draft, then type
delposto preview drafts/bar
publish
delposto publish drafts/bar.md
Publishes the drafts/bar.md
file. Puts the post in a YYY/MM/DD directory, and
uses the title
inside bar.md to generate a slugged title directory to hold
the output.
If you used delposto draft bar/
to create a directory-based draft, then type
delposto publish drafts/bar
If you want to change the templates in the templates
directory and the reapply
them to the published
directory, then just type:
delposto publish
Now, you can push the published
directory to your static file host of your
choice. If you want to push it to GitHubPages, then
volo-ghdeploy can be useful if you
have volo installed.
Example sites
This tool was created to generate http://jrburke.com
Dev Notes
Updating Prism
Prism is used for the HTML/CSS/JS code snippet syntax highlighting.
- Copy prism.css into templates/css/index.css, after START PRISM and before END PRISM
- Remove all the
class*="language-"
selector parts in prism.css - Remove any
text-shadow
use in prism.css - Copy prism.js into templates/js/index.js