Almace Scaffolding has exactly the same requirements as Jekyll. For more info please refer to Installation - Jekyll.
- Fork or clone the repo.
- Install dependencies with Ruby gem
bundlerand Node.js package manager
grunt initto initialize your project.
grunt serveto fire up a local server.
- Edit and customize your site.
- Change Git remote to your own repo.
- Push and deploy.
So in short for geeks:
$ git clone https://github.com/sparanoid/almace-scaffolding my-site $ cd my-site $ bundle install && npm install $ grunt init $ grunt serve # ...editing $ git remote set-url origin https://github.com/sparanoid/my-site.git $ git push -u origin master # ...publishing $ grunt && grunt deploy:rsync --env=prod
Go to the GitHub repository for downloads, bug reports, and feature requests.
Transfer from Jekyll
You can simply copy all posts from your old Jekyll setup into
_app/_posts, you can also transfer your custom pages into
It will be easy if you’re a casual blogger and keep every core and template file untouched. You can use the following command to update Almace Scaffolding core files:
$ grunt amsf-update
It checks the latest Almace Scaffolding build from GitHub and update core files automatically. Please keep in mind that if you changed some of the AMSF core files this action will override the changes you made. So it’s recommended to keep your project under version control, you will be always be able to compare changes for Almace Scaffolding.
Using Beta Release
By default, when you run
amsf-update you will get updated files from
release branch. However, I’m continuously working on Almace Scaffolding, so there may have testing branches you can try and give me feedback if you’re interested. You can check the AMSF GitHub repository for available branches, and it’s very easy to switch:
$ grunt amsf-update --branch=feat/service-worker
master is the one which is always available to checkout and also has the latest changes:
$ grunt amsf-update --branch=master
If you messed up with the testing branch, don’t worry, you can just run a normal update to revert them back:
$ grunt amsf-update