octopus | the octopress commander


The post command generates a new post Markdown file in the source/_posts directory of your Octopress site. You specify the name of your post as the argument for this command.

Meta Tags

The post command adds the SEO meta fields description & keywords to the standard Octopress YAML frontmatter in your Markdown file. Your HTML file will include the following meta tags in the head section when you generate your static files:

<meta name="description" content=" ">
<meta name="keywords" content=" ">

Add a sentence or two that describes your post and a comma delimited keyword list to the YAML fields in order to populate these meta tags when your static files are generated

Draft Posts

The post command also adds a YAML field that allows you to indicate that the post is a draft (the published field) so that it is not pushed to your remote server the next time that you use the publish command. By default, the post is not considered a draft post. To make the post a draft, change the published YAML field to:

published: false


Octopus automatically includes the date of origin in the Markdown filename string and YAML front matter. This date is carried forward to the final static HTML file name when you use the generate or publish commands.


oc post <post name>


Argument Description
post name the title of your post


Option Description
--opress use the default Octopress/Jekyll post generator


Default Octopus Post Generator

To create the Markdown filename [DATE]-this-is-my-post-title.markdown which will generate the HTML post [DATE]-this-is-my-post-title.html on your site, use the following command:

oc post "This is My Post Title"

The Markdown file creation date is automatically added to the post filename string. This date is also used in the filename string for the static HTML file that is generated from your Markdown.

The character cases that you use in the post name argument are used in the title YAML field of your Markdown file. This will be the <title> tag in your deployed static HTML file. Octopus automatically converts all characters to lower case and replaces spaces with dashes for the Markdown filename.

Note this filename format if you use the find command or any of the commands that allow you to work with files by Markdown filename substring.

Octopress Generator

If you would prefer to use the default Octopress new post generator, use the --opress switch with this syntax:

oc post --opress "This is My Post Title"

This switch eliminates the additional YAML frontmatter information that Octopus adds to your post. Your new post Markdown is generated as if you entered the following Octopress/Jekyll command:

rake new_post["This is My Post Title"]