diff --git a/Makefile b/Makefile deleted file mode 100644 index 3c09a5216..000000000 --- a/Makefile +++ /dev/null @@ -1,30 +0,0 @@ -.PHONY: list serve serve-drafts build deploy publish outdated - -list: - @echo "Usage (Quick):" - @echo " make build" - @echo " make deploy" - @echo - @echo "Usage (Makefile):" - @grep '^[^#[:space:]].*:' Makefile - @echo - @echo "Usage (./bin):" - @ls ./bin - -serve: - ./bin/serve - -serve-drafts: - ./bin/serve-drafts - -build: - ./bin/build - -deploy: - ./bin/deploy - -publish: - bundle exec jekyll publish "$1" - -outdated: - bundle outdated diff --git a/PUBLISHING.md b/PUBLISHING.md deleted file mode 100644 index 33443cfb8..000000000 --- a/PUBLISHING.md +++ /dev/null @@ -1,15 +0,0 @@ -# Publishing - -Some useful commands to remember: - -## Posts - -* `jekyll draft "Name of Post"` -* `jekyll serve --incremental --drafts` -* `jekyll publish ./_drafts/post-name.md` -* `jekyll unpublish ./_posts/post-name.md` - -## Build & Deploy - -* `bin/build` -* `bin/deploy` diff --git a/README.md b/README.md index 6f428d931..4535faa67 100644 --- a/README.md +++ b/README.md @@ -6,16 +6,43 @@ This is the [Jekyll](https://jekyllrb.com/) source for http://www.devalias.net/ Feel free to create an issue/pull request for any typo's/bugs you might find :) <3 -## Cheatsheet - -* Link to other posts - * `[other post]({% post_url 2017-01-01-other-post %})` -* Embed an image with [jekyll-postfiles](https://github.com/nhoizey/jekyll-postfiles#how-does-it-work) - * create a folder under `_posts` named the same as your post's markdown file - * add any images for your post there, along with the post's markdown file - * use a relative markdown image tag to reference and embed the images - * eg. `![a title or something](foo.jpg)` -* Embed a gist with [jekyll-gist](https://github.com/jekyll/jekyll-gist) - * `{% gist foo/12345678901234567890 %} ` -* Embed a tweet with [jekyll-twitter-plugin](https://github.com/rob-murray/jekyll-twitter-plugin) - * `{% twitter https://twitter.com/rubygems/status/518821243320287232 %}` + +- [Quick Start](#quick-start) +- [Managing Posts and Drafts](#managing-posts-and-drafts) + - [Drafts](#drafts) + - [Tips and Tricks](#tips-and-tricks) +- [Additional Commands](#additional-commands) + + +## Quick Start + +To get started quickly, use the following commands: + +- Serve the site locally: `./bin/serve` or `./bin/serve-drafts` (includes drafts) +- Build the site: `./bin/build` +- Deploy the site: `./bin/deploy` + +## Managing Posts and Drafts + +### Drafts + +- Create a new draft: `jekyll draft "Name of Post"` +- Serve drafts locally: `./bin/serve-drafts` or `jekyll serve --incremental --drafts` +- Promote a draft to a published post: `./bin/publish ./_drafts/post-name.md` or `jekyll publish ./_drafts/post-name.md` + - This will move the specified draft post to the `_posts` directory, making it a published post (though it won't be built or deployed automatically). +- Unpublish a post: `jekyll unpublish ./_posts/post-name.md` + - This will move the specified post from the `_posts` directory back to the `_drafts` directory, making it a draft again. + +### Tips and Tricks + +- Link to other posts: `[other post]({% post_url 2017-01-01-other-post %})` +- Embed an image with [jekyll-postfiles](https://github.com/nhoizey/jekyll-postfiles#how-does-it-work) + - Create a folder under `_posts` named the same as your post's markdown file + - Add images to that folder and use a relative markdown image tag: `![a title or something](foo.jpg)` +- Embed a gist with [jekyll-gist](https://github.com/jekyll/jekyll-gist): `{% gist foo/12345678901234567890 %}` +- Embed a tweet with [jekyll-twitter-plugin](https://github.com/rob-murray/jekyll-twitter-plugin): `{% twitter https://twitter.com/rubygems/status/518821243320287232 %}` + +## Additional Commands + +- Check outdated dependencies: `./bin/outdated` + - This will list all outdated dependencies for your project.