Merge benbalter:docs-pages #985
This commit is contained in:
		
						commit
						628f8280d0
					
				| 
						 | 
				
			
			@ -1,3 +1,2 @@
 | 
			
		|||
permalink: /docs/:categories/:title
 | 
			
		||||
pygments: true
 | 
			
		||||
gauges_id: 503c5af6613f5d0f19000027
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Configuration
 | 
			
		||||
prev_section: structure
 | 
			
		||||
next_section: frontmatter
 | 
			
		||||
permalink: /docs/configuration/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Jekyll allows you to concoct your sites in any way you can dream up, and it’s
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Contributing
 | 
			
		||||
prev_section: deployment-methods
 | 
			
		||||
next_section: troubleshooting
 | 
			
		||||
permalink: /docs/contributing/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
So you've got an awesome idea to throw into Jekyll. Great! Please keep the
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Deployment methods
 | 
			
		||||
prev_section: github-pages
 | 
			
		||||
next_section: contributing
 | 
			
		||||
permalink: /docs/deployment-methods/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Sites built using Jekyll can be deployed in a large number of ways due to the static nature of the generated output. A few of the most common deployment techniques are described below.
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Extras
 | 
			
		||||
prev_section: plugins
 | 
			
		||||
next_section: github-pages
 | 
			
		||||
permalink: /docs/extras/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
There are a number of (optional) extra features that Jekyll supports that you
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Front-matter
 | 
			
		||||
prev_section: configuration
 | 
			
		||||
next_section: posts
 | 
			
		||||
permalink: /docs/frontmatter/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
The front-matter is where Jekyll starts to get really cool. Any file that
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: GitHub Pages
 | 
			
		||||
prev_section: extras
 | 
			
		||||
next_section: deployment-methods
 | 
			
		||||
permalink: /docs/github-pages/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
[GitHub Pages](http://pages.github.com) are public web pages for users,
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Heroku
 | 
			
		||||
prev_section: github-pages
 | 
			
		||||
next_section: manual-deployment
 | 
			
		||||
permalink: /docs/heroku/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Move along, people. Nothing to see here.
 | 
			
		||||
| 
						 | 
				
			
			@ -1,11 +0,0 @@
 | 
			
		|||
<!DOCTYPE HTML>
 | 
			
		||||
<html lang="en-US">
 | 
			
		||||
<head>
 | 
			
		||||
  <meta charset="UTF-8">
 | 
			
		||||
  <meta http-equiv="refresh" content="0;url=home">
 | 
			
		||||
  <title>Jekyll</title>
 | 
			
		||||
</head>
 | 
			
		||||
<body style="background: #333;">
 | 
			
		||||
 | 
			
		||||
</body>
 | 
			
		||||
</html>
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Installation
 | 
			
		||||
prev_section: home
 | 
			
		||||
next_section: usage
 | 
			
		||||
permalink: /docs/installation/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Getting Jekyll installed and ready-to-go should only take a few minutes. If it
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Blog migrations
 | 
			
		||||
prev_section: variables
 | 
			
		||||
next_section: templates
 | 
			
		||||
permalink: /docs/migrations/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
If you’re switching to Jekyll from another blogging system, Jekyll’s importers
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Creating pages
 | 
			
		||||
prev_section: posts
 | 
			
		||||
next_section: variables
 | 
			
		||||
permalink: /docs/pages/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
In addition to [writing posts](../posts), another thing you may want to do with
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Pagination
 | 
			
		||||
prev_section: permalinks
 | 
			
		||||
next_section: plugins
 | 
			
		||||
permalink: /docs/pagination/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
With many websites—especially blogs—it’s very common to break the main listing
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Permalinks
 | 
			
		||||
prev_section: templates
 | 
			
		||||
next_section: pagination
 | 
			
		||||
permalink: /docs/permalinks/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Jekyll supports a flexible way to build your site’s URLs. You can specify the
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Plugins
 | 
			
		||||
prev_section: assets
 | 
			
		||||
next_section: extras
 | 
			
		||||
permalink: /docs/plugins/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Jekyll has a plugin system with hooks that allow you to create custom generated
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Writing posts
 | 
			
		||||
prev_section: frontmatter
 | 
			
		||||
next_section: pages
 | 
			
		||||
permalink: /docs/posts/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
One of Jekyll’s best aspects is that it is “blog aware”. What does this mean,
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Resources
 | 
			
		||||
prev_section: sites
 | 
			
		||||
next_section: upgrading
 | 
			
		||||
permalink: /docs/resources/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Jekyll’s growing use is producing a wide variety of tutorials, frameworks, extensions, examples, and other resources that can be very helpful. Below is a collection of links to some of the most popular Jekyll resources.
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Sites using Jekyll
 | 
			
		||||
prev_section: troubleshooting
 | 
			
		||||
next_section: resources
 | 
			
		||||
permalink: /docs/sites/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
It’s interesting to see what designs and features others have come up
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Directory structure
 | 
			
		||||
prev_section: usage
 | 
			
		||||
next_section: configuration
 | 
			
		||||
permalink: /docs/structure/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Jekyll is, at its core, a text transformation engine. The concept behind the
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Templates
 | 
			
		||||
prev_section: migrations
 | 
			
		||||
next_section: permalinks
 | 
			
		||||
permalink: /docs/templates/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Jekyll uses the [Liquid](http://wiki.shopify.com/Liquid) templating language to
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Troubleshooting
 | 
			
		||||
prev_section: contributing
 | 
			
		||||
next_section: sites
 | 
			
		||||
permalink: /docs/troubleshooting/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
If you ever run into problems installing or using Jekyll, here’s a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please [report an issue](https://github.com/mojombo/jekyll/issues/new) so the Jekyll community can make everyone’s experience better.
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Basic Usage
 | 
			
		||||
prev_section: installation
 | 
			
		||||
next_section: structure
 | 
			
		||||
permalink: /docs/usage/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
The Jekyll gem makes a `jekyll` executable available to you in your Terminal
 | 
			
		||||
| 
						 | 
				
			
			@ -3,6 +3,7 @@ layout: docs
 | 
			
		|||
title: Variables
 | 
			
		||||
prev_section: pages
 | 
			
		||||
next_section: migrations
 | 
			
		||||
permalink: /docs/variables/
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Jekyll traverses your site looking for files to process. Any files with [YAML
 | 
			
		||||
		Loading…
	
		Reference in New Issue