From e1f04968e8f5a18d9b09a8a86bc048061e77dcbc Mon Sep 17 00:00:00 2001 From: "Benjamin J. Balter" Date: Thu, 18 Apr 2013 10:10:59 -0400 Subject: [PATCH] Use pages for documentation, not posts, fixes #980. --- site/_config.yml | 1 - .../configuration.md} | 1 + .../contributing.md} | 1 + .../deployment-methods.md} | 1 + site/{_posts/2012-07-01-extras.md => docs/extras.md} | 1 + .../2012-07-01-frontmatter.md => docs/frontmatter.md} | 1 + .../github-pages.md} | 1 + site/{_posts/2012-07-01-heroku.md => docs/heroku.md} | 1 + site/docs/index.html | 11 ----------- site/{_posts/2012-07-01-home.md => docs/index.md} | 0 .../installation.md} | 1 + .../2012-07-01-migrations.md => docs/migrations.md} | 1 + site/{_posts/2012-07-01-pages.md => docs/pages.md} | 1 + .../2012-07-01-pagination.md => docs/pagination.md} | 1 + .../2012-07-01-permalinks.md => docs/permalinks.md} | 1 + .../{_posts/2012-07-01-plugins.md => docs/plugins.md} | 1 + site/{_posts/2012-07-01-posts.md => docs/posts.md} | 1 + .../2012-07-01-resources.md => docs/resources.md} | 1 + site/{_posts/2012-07-01-sites.md => docs/sites.md} | 1 + .../2012-07-01-structure.md => docs/structure.md} | 1 + .../2012-07-01-templates.md => docs/templates.md} | 1 + .../troubleshooting.md} | 1 + site/{_posts/2012-07-01-usage.md => docs/usage.md} | 1 + .../2012-07-01-variables.md => docs/variables.md} | 1 + 24 files changed, 21 insertions(+), 12 deletions(-) rename site/{_posts/2012-07-01-configuration.md => docs/configuration.md} (99%) rename site/{_posts/2012-07-01-contributing.md => docs/contributing.md} (99%) rename site/{_posts/2012-07-01-deployment-methods.md => docs/deployment-methods.md} (99%) rename site/{_posts/2012-07-01-extras.md => docs/extras.md} (99%) rename site/{_posts/2012-07-01-frontmatter.md => docs/frontmatter.md} (99%) rename site/{_posts/2012-07-01-github-pages.md => docs/github-pages.md} (98%) rename site/{_posts/2012-07-01-heroku.md => docs/heroku.md} (84%) delete mode 100644 site/docs/index.html rename site/{_posts/2012-07-01-home.md => docs/index.md} (100%) rename site/{_posts/2012-07-01-installation.md => docs/installation.md} (98%) rename site/{_posts/2012-07-01-migrations.md => docs/migrations.md} (99%) rename site/{_posts/2012-07-01-pages.md => docs/pages.md} (99%) rename site/{_posts/2012-07-01-pagination.md => docs/pagination.md} (99%) rename site/{_posts/2012-07-01-permalinks.md => docs/permalinks.md} (99%) rename site/{_posts/2012-07-01-plugins.md => docs/plugins.md} (99%) rename site/{_posts/2012-07-01-posts.md => docs/posts.md} (99%) rename site/{_posts/2012-07-01-resources.md => docs/resources.md} (99%) rename site/{_posts/2012-07-01-sites.md => docs/sites.md} (97%) rename site/{_posts/2012-07-01-structure.md => docs/structure.md} (99%) rename site/{_posts/2012-07-01-templates.md => docs/templates.md} (99%) rename site/{_posts/2012-07-01-troubleshooting.md => docs/troubleshooting.md} (99%) rename site/{_posts/2012-07-01-usage.md => docs/usage.md} (98%) rename site/{_posts/2012-07-01-variables.md => docs/variables.md} (99%) diff --git a/site/_config.yml b/site/_config.yml index 2de2c7ff..a80e7c40 100644 --- a/site/_config.yml +++ b/site/_config.yml @@ -1,3 +1,2 @@ -permalink: /docs/:categories/:title pygments: true gauges_id: 503c5af6613f5d0f19000027 diff --git a/site/_posts/2012-07-01-configuration.md b/site/docs/configuration.md similarity index 99% rename from site/_posts/2012-07-01-configuration.md rename to site/docs/configuration.md index 1556d449..07fc5afc 100644 --- a/site/_posts/2012-07-01-configuration.md +++ b/site/docs/configuration.md @@ -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 diff --git a/site/_posts/2012-07-01-contributing.md b/site/docs/contributing.md similarity index 99% rename from site/_posts/2012-07-01-contributing.md rename to site/docs/contributing.md index dcab4ffa..cc3754a4 100644 --- a/site/_posts/2012-07-01-contributing.md +++ b/site/docs/contributing.md @@ -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 diff --git a/site/_posts/2012-07-01-deployment-methods.md b/site/docs/deployment-methods.md similarity index 99% rename from site/_posts/2012-07-01-deployment-methods.md rename to site/docs/deployment-methods.md index 80b55ae3..dd4369ce 100644 --- a/site/_posts/2012-07-01-deployment-methods.md +++ b/site/docs/deployment-methods.md @@ -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. diff --git a/site/_posts/2012-07-01-extras.md b/site/docs/extras.md similarity index 99% rename from site/_posts/2012-07-01-extras.md rename to site/docs/extras.md index 2ac89e32..5f340fc4 100644 --- a/site/_posts/2012-07-01-extras.md +++ b/site/docs/extras.md @@ -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 diff --git a/site/_posts/2012-07-01-frontmatter.md b/site/docs/frontmatter.md similarity index 99% rename from site/_posts/2012-07-01-frontmatter.md rename to site/docs/frontmatter.md index 337a7388..3591e8e9 100644 --- a/site/_posts/2012-07-01-frontmatter.md +++ b/site/docs/frontmatter.md @@ -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 diff --git a/site/_posts/2012-07-01-github-pages.md b/site/docs/github-pages.md similarity index 98% rename from site/_posts/2012-07-01-github-pages.md rename to site/docs/github-pages.md index 67f49403..fec89e73 100644 --- a/site/_posts/2012-07-01-github-pages.md +++ b/site/docs/github-pages.md @@ -3,6 +3,7 @@ layout: docs title: GitHub Pages prev_section: extras next_section: deployment-methods +permalink: /docs/github-pages/ --- [GitHub Pages](https://pages.github.com) are public web pages for users, diff --git a/site/_posts/2012-07-01-heroku.md b/site/docs/heroku.md similarity index 84% rename from site/_posts/2012-07-01-heroku.md rename to site/docs/heroku.md index 091239c5..84b448b6 100644 --- a/site/_posts/2012-07-01-heroku.md +++ b/site/docs/heroku.md @@ -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. diff --git a/site/docs/index.html b/site/docs/index.html deleted file mode 100644 index 95b00547..00000000 --- a/site/docs/index.html +++ /dev/null @@ -1,11 +0,0 @@ - - - - - - Jekyll - - - - - diff --git a/site/_posts/2012-07-01-home.md b/site/docs/index.md similarity index 100% rename from site/_posts/2012-07-01-home.md rename to site/docs/index.md diff --git a/site/_posts/2012-07-01-installation.md b/site/docs/installation.md similarity index 98% rename from site/_posts/2012-07-01-installation.md rename to site/docs/installation.md index 33f111be..2dd2d60f 100644 --- a/site/_posts/2012-07-01-installation.md +++ b/site/docs/installation.md @@ -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 diff --git a/site/_posts/2012-07-01-migrations.md b/site/docs/migrations.md similarity index 99% rename from site/_posts/2012-07-01-migrations.md rename to site/docs/migrations.md index e4d85dea..c3e6c987 100644 --- a/site/_posts/2012-07-01-migrations.md +++ b/site/docs/migrations.md @@ -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 diff --git a/site/_posts/2012-07-01-pages.md b/site/docs/pages.md similarity index 99% rename from site/_posts/2012-07-01-pages.md rename to site/docs/pages.md index c78d6145..36474677 100644 --- a/site/_posts/2012-07-01-pages.md +++ b/site/docs/pages.md @@ -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 diff --git a/site/_posts/2012-07-01-pagination.md b/site/docs/pagination.md similarity index 99% rename from site/_posts/2012-07-01-pagination.md rename to site/docs/pagination.md index f1710d99..ec76b287 100644 --- a/site/_posts/2012-07-01-pagination.md +++ b/site/docs/pagination.md @@ -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 diff --git a/site/_posts/2012-07-01-permalinks.md b/site/docs/permalinks.md similarity index 99% rename from site/_posts/2012-07-01-permalinks.md rename to site/docs/permalinks.md index b0a7c8cf..7f3b065a 100644 --- a/site/_posts/2012-07-01-permalinks.md +++ b/site/docs/permalinks.md @@ -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 diff --git a/site/_posts/2012-07-01-plugins.md b/site/docs/plugins.md similarity index 99% rename from site/_posts/2012-07-01-plugins.md rename to site/docs/plugins.md index e41f1bbc..e32c6fa8 100644 --- a/site/_posts/2012-07-01-plugins.md +++ b/site/docs/plugins.md @@ -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 diff --git a/site/_posts/2012-07-01-posts.md b/site/docs/posts.md similarity index 99% rename from site/_posts/2012-07-01-posts.md rename to site/docs/posts.md index 80f6256e..27194bbe 100644 --- a/site/_posts/2012-07-01-posts.md +++ b/site/docs/posts.md @@ -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, diff --git a/site/_posts/2012-07-01-resources.md b/site/docs/resources.md similarity index 99% rename from site/_posts/2012-07-01-resources.md rename to site/docs/resources.md index c14c584c..640b2343 100644 --- a/site/_posts/2012-07-01-resources.md +++ b/site/docs/resources.md @@ -2,6 +2,7 @@ layout: docs title: Resources prev_section: sites +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. diff --git a/site/_posts/2012-07-01-sites.md b/site/docs/sites.md similarity index 97% rename from site/_posts/2012-07-01-sites.md rename to site/docs/sites.md index f28c0280..b5f24836 100644 --- a/site/_posts/2012-07-01-sites.md +++ b/site/docs/sites.md @@ -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 diff --git a/site/_posts/2012-07-01-structure.md b/site/docs/structure.md similarity index 99% rename from site/_posts/2012-07-01-structure.md rename to site/docs/structure.md index 4401373d..2b80e08b 100644 --- a/site/_posts/2012-07-01-structure.md +++ b/site/docs/structure.md @@ -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 diff --git a/site/_posts/2012-07-01-templates.md b/site/docs/templates.md similarity index 99% rename from site/_posts/2012-07-01-templates.md rename to site/docs/templates.md index d6792ff6..d3e54256 100644 --- a/site/_posts/2012-07-01-templates.md +++ b/site/docs/templates.md @@ -3,6 +3,7 @@ layout: docs title: Templates prev_section: migrations next_section: permalinks +permalink: /docs/templates/ --- Jekyll uses the [Liquid](http://www.liquidmarkup.org/) templating language to diff --git a/site/_posts/2012-07-01-troubleshooting.md b/site/docs/troubleshooting.md similarity index 99% rename from site/_posts/2012-07-01-troubleshooting.md rename to site/docs/troubleshooting.md index 08dac8e8..dc5ecb50 100644 --- a/site/_posts/2012-07-01-troubleshooting.md +++ b/site/docs/troubleshooting.md @@ -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. diff --git a/site/_posts/2012-07-01-usage.md b/site/docs/usage.md similarity index 98% rename from site/_posts/2012-07-01-usage.md rename to site/docs/usage.md index 7088f8c3..4ff25e02 100644 --- a/site/_posts/2012-07-01-usage.md +++ b/site/docs/usage.md @@ -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 diff --git a/site/_posts/2012-07-01-variables.md b/site/docs/variables.md similarity index 99% rename from site/_posts/2012-07-01-variables.md rename to site/docs/variables.md index 3188ec28..d4539cc0 100644 --- a/site/_posts/2012-07-01-variables.md +++ b/site/docs/variables.md @@ -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