diff --git a/History.markdown b/History.markdown index 4c0298cb..9a517b62 100644 --- a/History.markdown +++ b/History.markdown @@ -3,6 +3,9 @@ ### Major Enhancements ### Minor Enhancements ### Bug Fixes +### Development Fixes + * Merge the theme and layout cucumber steps into one step (#1151) + ### Site Enhancements * Add "History" page. * Restructured docs sections to include "Meta" section. @@ -10,6 +13,7 @@ to use Pygments. (#1182) * Update link to the official Maruku repo (#1175) * Add documentation about `paginate_path` to "Templates" page in docs (#1129) + * Give the quick-start guide its own page (#1191) ### Development Fixes diff --git a/features/step_definitions/jekyll_steps.rb b/features/step_definitions/jekyll_steps.rb index 19a8b2c2..7a1c7cd1 100644 --- a/features/step_definitions/jekyll_steps.rb +++ b/features/step_definitions/jekyll_steps.rb @@ -31,14 +31,13 @@ Given /^I have an? "(.*)" file that contains "(.*)"$/ do |file, text| end end -Given /^I have a (.*) layout that contains "(.*)"$/ do |layout, text| - File.open(File.join('_layouts', layout + '.html'), 'w') do |f| - f.write(text) +Given /^I have an? (.*) (layout|theme) that contains "(.*)"$/ do |name, type, text| + folder = if type == 'layout' + '_layouts' + else + '_theme' end -end - -Given /^I have a (.*) theme that contains "(.*)"$/ do |layout, text| - File.open(File.join('_theme', layout + '.html'), 'w') do |f| + File.open(File.join(folder, name + '.html'), 'w') do |f| f.write(text) end end diff --git a/site/_includes/docs_contents.html b/site/_includes/docs_contents.html index fec44c4e..6ed33431 100644 --- a/site/_includes/docs_contents.html +++ b/site/_includes/docs_contents.html @@ -5,6 +5,9 @@
  • Welcome
  • +
  • + Quick-start guide +
  • Installation
  • diff --git a/site/_includes/docs_contents_mobile.html b/site/_includes/docs_contents_mobile.html index 45925591..05cbc85a 100644 --- a/site/_includes/docs_contents_mobile.html +++ b/site/_includes/docs_contents_mobile.html @@ -3,6 +3,7 @@ + diff --git a/site/docs/index.md b/site/docs/index.md index 5129643a..56571186 100644 --- a/site/docs/index.md +++ b/site/docs/index.md @@ -1,7 +1,7 @@ --- layout: docs title: Welcome -next_section: installation +next_section: quickstart permalink: /docs/home/ --- @@ -24,22 +24,6 @@ behind [GitHub Pages](http://pages.github.com), which means you can use Jekyll to host your project’s page, blog, or website from GitHub’s servers **for free**. -## Quick-start guide - -For the impatient, here's how to get a boilerplate Jekyll site up and running. - -{% highlight bash %} -~ $ gem install jekyll -~ $ jekyll new myblog -~ $ cd myblog -~/myblog $ jekyll serve -# => Now browse to http://localhost:4000 -{% endhighlight %} - -That's nothing, though. The real magic happens when you start creating blog -posts, using the front-matter to control templates and layouts, and taking -advantage of all the awesome configuration options Jekyll makes available. - ## ProTips™, Notes, and Warnings Throughout this guide there are a number of small-but-handy pieces of diff --git a/site/docs/installation.md b/site/docs/installation.md index e409129a..b2d1fa96 100644 --- a/site/docs/installation.md +++ b/site/docs/installation.md @@ -1,7 +1,7 @@ --- layout: docs title: Installation -prev_section: home +prev_section: quickstart next_section: usage permalink: /docs/installation/ --- diff --git a/site/docs/quickstart.md b/site/docs/quickstart.md new file mode 100644 index 00000000..f7ee7b4e --- /dev/null +++ b/site/docs/quickstart.md @@ -0,0 +1,21 @@ +--- +layout: docs +title: Quick-start guide +prev_section: home +next_section: installation +permalink: /docs/quickstart/ +--- + +For the impatient, here's how to get a boilerplate Jekyll site up and running. + +{% highlight bash %} +~ $ gem install jekyll +~ $ jekyll new myblog +~ $ cd myblog +~/myblog $ jekyll serve +# => Now browse to http://localhost:4000 +{% endhighlight %} + +That's nothing, though. The real magic happens when you start creating blog +posts, using the front-matter to control templates and layouts, and taking +advantage of all the awesome configuration options Jekyll makes available. \ No newline at end of file