Updated posts.
This commit is contained in:
Barry Clark
parent
7e93b3bf65
commit
7864db4919
|
|
@ -74,7 +74,6 @@ This wasn't what you were looking for? Here are some other Jekyll starting point
|
|||
|
||||
## License
|
||||
|
||||
```
|
||||
The MIT License (MIT)
|
||||
|
||||
Copyright (c) 2014 Barry Clark
|
||||
|
|
@ -96,4 +95,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
THE SOFTWARE.
|
||||
```
|
||||
|
|
@ -1,64 +0,0 @@
|
|||
---
|
||||
layout: post
|
||||
title: Markdown Style Guide
|
||||
---
|
||||
|
||||
A demo of all styled markdown elements in Jekyll Boilerplate.
|
||||
|
||||
This is a paragraph, it's surrounded by whitespace. Next up are some headers, they're heavily influenced by GitHub's markdown style.
|
||||
|
||||
## Header 2 (H1 is reserved for post titles)##
|
||||
### Header 3 ###
|
||||
#### Header 4 ####
|
||||
##### Header 5 #####
|
||||
|
||||
A link to [Jekyll Boilerplate](http://github.com/barryclark/jekyll-boilerplate/). A big ass literal link <http://github.com/barryclark/jekyll-boilerplate/>
|
||||
|
||||
An image, located within /images
|
||||
|
||||
|
||||
|
||||
* A bulletted list
|
||||
- alternative syntax 1
|
||||
+ alternative syntax 2
|
||||
- an indented list item
|
||||
|
||||
1. An
|
||||
2. ordered
|
||||
3. list
|
||||
|
||||
Inline markup styles:
|
||||
|
||||
- _italics_
|
||||
- **bold**
|
||||
- `code()`
|
||||
|
||||
> Blockquote
|
||||
>> Nested Blockquote
|
||||
|
||||
Syntax highlighting can be used by wrapping your code in a liquid tag like so:
|
||||
|
||||
{{ "{% highlight javascript " }}%}
|
||||
/* Some pointless Javascript */
|
||||
var rawr = ["r", "a", "w", "r"];
|
||||
{{ "{% endhighlight " }}%}
|
||||
|
||||
creates...
|
||||
|
||||
{% highlight javascript %}
|
||||
|
||||
/* Some pointless Javascript */
|
||||
var rawr = ["r", "a", "w", "r"];
|
||||
|
||||
{% endhighlight %}
|
||||
|
||||
Use two trailing spaces
|
||||
on the right
|
||||
to create linebreak tags
|
||||
|
||||
Finally, horizontal lines
|
||||
|
||||
----
|
||||
****
|
||||
|
||||
Enjoy!
|
||||
|
|
@ -1,8 +1,10 @@
|
|||
---
|
||||
layout: post
|
||||
title: Oh, Hi!
|
||||
title: Hello World!
|
||||
---
|
||||
|
||||
|
||||
|
||||
This is a demo site for Jekyll Boilerplate. It was made in just a few minutes—by forking [Jekyll Boilerplate](http://github.com/barryclark/jekyll-boilerplate/)!
|
||||
|
||||
Jekyll boilerplate is a starting point for creating your blog using Jekyll and GitHub Pages. It make it _really easy_.
|
||||
|
|
@ -1,85 +0,0 @@
|
|||
---
|
||||
layout: post
|
||||
title: Jekyll The Easy Way
|
||||
---
|
||||
|
||||
I just migrated my blog over to this Jekyll powered static site that you're currently reading. Finding a good workflow with Jekyll took me longer than I expected.
|
||||
|
||||
|
||||
|
||||
When you understand how Jekyll works, it's _extremely_ fast to set up. However when learning I came across lot of articles, repos and stack overflow threads that made the setup much more complicated than it needs to be.
|
||||
|
||||
### Jekyll is built for one specific purpose
|
||||
|
||||
Tom Preston Warner of Github build Jekyll to [[INSERT HERE EXCERT FROM TPW's blog]]
|
||||
|
||||
This also the way that Jekyll was built to be used!
|
||||
|
||||
It was built for one purpose. To make blogging on Github Pages extremely quick and easy.
|
||||
|
||||
If you want more than a simple blog hosted on Github Pages, don't use Jekyll! Sure, it can be used for other things too. But if you try to use them for those, you're probably going to have a bad time.
|
||||
|
||||
### Use your named account on Github Pages (barryclark.github.io)
|
||||
|
||||
This eliminates the need for a seperate gh-pages branch workflow, making things really simple!
|
||||
|
||||
You just commit your Jekyll layout files and your markdown blog posts and content to the master branch of your barryclark.github.io, and Github Pages AUTOMATICALLY compiles it.
|
||||
|
||||
Fun fact: Github Pages processes ALL files through Jekyll. You mostly just don't notice this if you're using Github Pages for static content as flat .html content just passes through and doesn't get compiled.
|
||||
|
||||
If you wanted to, you wouldn't actually ever hard to install or run jekyll locally. You could just push up to your barryclark.github.io and everything would be taken care of for you.
|
||||
|
||||
That is awesome. And that's the first way that Jekyll is supposed to be used.
|
||||
|
||||
### Don't use plugins
|
||||
|
||||
Github Pages builds Jekyll sites in "safe mode". This means that when compiling your site, Github Pages won't run any of your plugins, it'll only use the standard Jekyll build. If you want to use plugins to
|
||||
|
||||
That means you can't compile SASS, etc, etc.
|
||||
|
||||
Using plugins means that you can't use your Github Pages account. There are other ways to do this. But they add lots of extra complexity.
|
||||
|
||||
### Pre-process css/js yourself
|
||||
|
||||
Use a guard or grunt script while you're theming. Don't try to do it within the jekyll build process.
|
||||
|
||||
You should be using grunt anyway.
|
||||
|
||||
Then just push the .css and .js and Jekyll will have no problems with it. No need to install jekyll-asset-manager, which has a whole host of complications with it.
|
||||
|
||||
### Have a workflow for blogging, and a separate workflow for theming
|
||||
|
||||
Updating content is CRAZY easy... and that's the whole point of Jekyll. You just write a markdown post and commit it to the repo, and you're done. Amazing.
|
||||
|
||||
2 of the simplest theming workflows I found:
|
||||
|
||||
- Build your site statically and theme that.
|
||||
-
|
||||
|
||||
Don't try to mix things in to the jekyll build process. It's not worth it, and you likely won't be able to use that workflow on barryclark.github.io
|
||||
|
||||
### To get started, fork a good repo
|
||||
|
||||
Following all of the about tips, you'll have a much easier time setting up Jekyll... and hell, if you want to do some fancy things, add them in later.
|
||||
|
||||
There are a number of repos that already follow the rules above. Forking one of them will put you on the right tracks, and save you a TON of time. You'll be able to get up and running extremely quickly.
|
||||
|
||||
Give a list of my favorite repos to fork.
|
||||
|
||||
- Tom Preston Warner
|
||||
- Zach Holman
|
||||
|
||||
I've also shared my base theme repo, which abides by each of the things I've covered in this post. It includes grunt scripts to do your pre-processing, and the same layout as you see here on this blog, with easy options for customization.
|
||||
|
||||
- Mine (Jekyllstrap? Jekyll-base?) :>
|
||||
|
||||
### Forking Jekyllstrap
|
||||
|
||||
Give instructions on exactly how to fork the repo. Step through each step to have your Jekyll site running on your name.com domain name.
|
||||
|
||||
1. Fork
|
||||
2. Write your CSS
|
||||
3.
|
||||
|
||||
I should create this, and fork my own repo.
|
||||
|
||||
Loading…
Reference in a new issue