Romlus is a static site generator (like jekyll) featuring:
a clear folder convention
ejs template processing
generating css from less files
a local development server acting like github pages
Planned:
romulus deploy for github pages deployment
page scripts that run before rendering
github flavored markdown
blogging
You should use romulus if you want a simple tool for creating static github
pages with node.js.
Creating a static page
Create a new directory, and inside this directory create the folder structure below:
Note: Only the pages folder is required, the other folders are optional.
/pages/layouts/public
Now create a file called pages/index.html and put some HTML into it:
<p>Hello World</p>
Run this to generate your static site:
$ romlus my-site
You should now see a new folder called my-site containing your index.html
page exactly as you wrote it.
Alternatively you could run the local development server at
http://localhost:8080/ by typing this:
$ romulus
Layouts
In order to make this more interesting, let's say you want to wrap your
new page in a fancy layout. To do this you need to change you pages/index.html
file like this:
<% this.layout = 'default' %><p>Hello World</p>
Now you need to create the layout itself, so add a file called
layouts/default.html:
That's it, you should now see your page being rendered inside your template!
Generating css from less files
Now that you have this wonderful site, you probably want to style it. To do so,
create a file called public/css/main.css:
body{ h1{ color: #0080FF; }}
Sweet, your headline is now featuring my favorite color!
Static file support
Any file placed in the public folder will be included at the top level of the
build output folder. The local development server also supports serving them.