The cappuccino.org from cappuccino

cappuccino.org's Introduction

Cappuccino Website

This is the new GitHub forkable and pull-request ready, static HTML & JS modern Cappuccino website.

How to Contribute to this Site

You will need Docker.

Build the site

docker build -t middleman .
docker run --rm --volume "$PWD":/app -t middleman bundle _1.17.3_ exec middleman build

Preview the site

docker run --rm --publish 4567:4567 --volume "$PWD":/app -t middleman bundle _1.17.3_ exec middleman server

Open http://localhost:4567/ to view the site. When you're done stop the Docker container with Ctrl-C.

While it's running you can simply edit the markdown, HAML, CSS, JavaScript and so on which makes up the site. Middleman will automatically compile it as needed and you can preview the results in your browser.

When you are done, create a fork of this repository, make a branch of master, commit your changes, and make a pull request.

How to Add a Blog Post

Copy an existing blog post to a file with a new name in the right folder. Then modify the preamble (the bit on the top of the post) to indicate the right date and author.

How to Deploy

Rsync the contents of build/ to the hosting server.
Clear the Cloudflare cache.

Notes

Why is `pygments-main` copied into the `vendor` folder?

I didn't find a git repo for this to clone so I checked out the mercurial version and hacked it to improve Objective-J support. Ideally we go to some less hacky solution in the long run.

Credits

Bootstrap
1154865_61618748.jpeg http://www.sxc.hu/photo/1154865
furley_bg.png Dan Kruse

Based on Measure Bootstrap Theme, which in turn includes:

Lato Google webfont http://www.google.com/webfonts/specimen/Lato
Icons by Brankic1979 http://www.brankic1979.com/icons/
Social icons from http://medialoot.com/item/round-social-media-icons/

cappuccino.org's People

Contributors

Stargazers

Watchers

cappuccino.org's Issues

Documentation is outdated

Documentation is outdated on the website. Not the good theme or version

Switch to Github Actions for building and Github Pages for hosting

I have created a github action which builds the site and deploys it to our existing (unused) Github Pages hosting:

https://cappuccino.github.io

Something about the generation of our tag cloud has changed so now tags appear in a different order. The tag cloud wasn't great to begin with though (not sorted by anything, the tag "cappuccino" appearing twice, once with a capital C, etc) so I feel like this might not matter.

Anyhow feedback welcome. Let me know if you see anything that's substantially different between the two sites:

https://www.cappuccino.dev
https://cappuccino.github.io

If there is we will need to fix that before switching cappuccino.dev to point to the new hosting.

We also need to figure out how to deal with old redirects like these:

rewrite ^/2010/04/cappuccino-0-8-tools/?$ http://$host/blog/2010/04/cappuccino-0-8-tools.html permanent;
rewrite ^/2011/05/cappcon-tickets-now-available/?$ http://$host/blog/2011/05/cappcon-tickets-now-available.html permanent;
rewrite ^/2012/04/cappuccino-news-2/?$ http://$host/blog/2012/04/cappuccino-news-2.html permanent;

Maybe replace them with HTML files and meta redirect headers?

Recommend Projects

cappuccino / cappuccino.org Goto Github PK