Turns out that lineman makes a great blogging engine!
Here's a screencast to demo usage for an older variant of Test Double's blog, Double Takes.
Here's how to publish a new blog to the web using github pages in minutes:
- Clone this repository with
npx degit linemanjs/lineman-blog-template
- Install lineman if you haven't yet.
- Run
npm install
to install required project dependencies. - Run
npm start
while you work on writing markdown files underapp/posts
. - Turn on github pages for your repo.
- Customize the
email
withingh-pages-deploy.yml
to the one you use for your github account and put it inside a.github/workflows
folder in your repo. - Commit your post and
git push main
, and your blog will be hosted on github pages once the actions workflow completes!
First, consider reading about grunt-markdown-blog, our grunt task that's doing almost all the heavy lifting here.
- Just add markdown posts with an ".md" extension to
app/posts
and when younpm start
ornpm run build
, they'll be rendered. - Configure your blog in
config/application.coffee
- Customize your blog templates in
app/templates
. - RSS is generated for you at
/index.xml
and a JSON Feed at/index.json
(setmarkdown.options.feedCount
to0
to disable both of these features) - Disqus support is included if you configure it.
- You can, of course, add any Less/CSS or CoffeeScript/JavaScript as you can with any other Lineman application. See Lineman's documentation.
- To build static assets to deploy some other way, just run
npm run build
and put thedist
directory's contents somewhere.