From 39e2c576d508d83561ddaa13b879fd2ed3be4a73 Mon Sep 17 00:00:00 2001 From: seiyria Date: Fri, 5 Aug 2016 09:50:23 -0500 Subject: [PATCH] adding scaffolding, macro guide --- Gemfile.lock | 2 - _classes/root.md | 9 + _config.yml | 58 +- _data/authors.yml | 18 - _data/navigation.yml | 151 +++-- _docs/01-quick-start-guide.md | 47 -- _docs/02-structure.md | 54 -- _docs/03-installation.md | 80 --- _docs/04-upgrading.md | 50 -- _docs/05-configuration.md | 564 ------------------ _docs/06-navigation.md | 72 --- _docs/07-ui-text.md | 21 - _docs/08-authors.md | 41 -- _docs/09-layouts.md | 453 -------------- _docs/10-posts.md | 39 -- _docs/11-pages.md | 45 -- _docs/12-collections.md | 48 -- _docs/13-helpers.md | 255 -------- _docs/14-utility-classes.md | 176 ------ _docs/15-stylesheets.md | 169 ------ _docs/16-javascript.md | 50 -- _docs/17-history.md | 463 -------------- _docs/18-contributing.md | 16 - _docs/19-docs-2-2.md | 302 ---------- _docs/20-license.md | 28 - _drafts/post-draft.md | 19 - _includes/footer.html | 23 +- _includes/sidebar.html | 3 +- _layouts/default.html | 12 - _layouts/single.html | 4 +- _other/macros.md | 146 +++++ _other/root.md | 9 + _pages/about.md | 84 --- _pages/home.md | 17 +- _pets/lhasa-apso.md | 8 - _pets/tabby.md | 8 - _portfolio/foo-bar-website.md | 30 - ...-05-15-edge-case-nested-and-mixed-lists.md | 60 -- _posts/2009-06-01-edge-case-many-tags.md | 49 -- .../2009-07-02-edge-case-many-categories.md | 23 - .../2009-08-06-edge-case-no-body-content.md | 9 - _posts/2009-09-05-edge-case-no-yaml-title.md | 10 - ...le-should-not-overflow-the-content-area.md | 27 - .../2009-10-05-edge-case-very-long-title.md | 14 - _posts/2010-01-07-post-modified.md | 14 - _posts/2010-01-07-post-standard.md | 32 - _posts/2010-01-08-post-chat.md | 134 ----- _posts/2010-02-05-post-notice.md | 68 --- _posts/2010-02-05-post-quote.md | 12 - _posts/2010-03-07-post-link.md | 15 - _posts/2010-06-02-post-video-youtube.md | 11 - _posts/2010-08-05-post-image-linked.md | 10 - _posts/2010-08-05-post-image-standard.md | 44 -- .../2010-08-06-post-image-linked-caption.md | 21 - _posts/2010-08-07-post-image-caption.md | 19 - _posts/2010-09-09-post-gallery.md | 134 ----- _posts/2010-09-10-post-twitter-embeds.md | 15 - _posts/2010-10-25-post-future-date.md | 8 - _posts/2012-01-02-layout-comments-disabled.md | 14 - _posts/2012-01-02-layout-comments.md | 12 - .../2012-01-02-layout-read-time-disabled.md | 18 - _posts/2012-01-02-layout-read-time.md | 18 - ...012-01-02-layout-related-posts-disabled.md | 14 - _posts/2012-01-02-layout-related-posts.md | 12 - _posts/2012-01-02-layout-sharing-disabled.md | 14 - _posts/2012-01-02-layout-sharing.md | 12 - ...comments-sharing-related-posts-disabled.md | 19 - ...012-01-03-layout-table-of-contents-post.md | 100 ---- ...012-03-14-layout-code-excerpt-generated.md | 14 - _posts/2012-03-14-layout-excerpt-defined.md | 15 - _posts/2012-03-14-layout-excerpt-generated.md | 17 - _posts/2012-03-15-layout-author-override.md | 38 -- ...12-03-15-layout-author-sidebar-disabled.md | 9 - ...2012-03-15-layout-header-image-external.md | 17 - ...12-03-15-layout-header-image-horizontal.md | 20 - ...15-layout-header-image-text-readability.md | 49 -- ...2012-03-15-layout-header-image-vertical.md | 20 - .../2012-03-15-layout-header-overlay-color.md | 18 - .../2012-03-15-layout-header-overlay-image.md | 53 -- _posts/2012-03-15-layout-more-tag.md | 18 - _posts/2012-03-15-layout-sidebar-custom.md | 26 - _posts/2012-05-22-markup-text-readability.md | 45 -- _posts/2013-01-05-markup-title-with-markup.md | 14 - ...05-markup-title-with-special-characters.md | 432 -------------- _posts/2013-01-09-markup-text-alignment.md | 34 -- _posts/2013-01-10-markup-image-alignment.md | 72 --- ...3-01-11-markup-html-tags-and-formatting.md | 222 ------- _posts/2013-05-22-markup-more-images.md | 65 -- .../2013-08-16-markup-syntax-highlighting.md | 79 --- _posts/2016-02-24-welcome-to-jekyll.md | 29 - _recipes/chocolate-chip-cookies.md | 31 - _recipes/oatmeal-cookies.md | 23 - _recipes/peanut-butter-cookies.md | 23 - _scenarios/root.md | 10 + start.sh | 1 + 95 files changed, 295 insertions(+), 5635 deletions(-) create mode 100644 _classes/root.md delete mode 100644 _data/authors.yml delete mode 100644 _docs/01-quick-start-guide.md delete mode 100644 _docs/02-structure.md delete mode 100644 _docs/03-installation.md delete mode 100644 _docs/04-upgrading.md delete mode 100644 _docs/05-configuration.md delete mode 100644 _docs/06-navigation.md delete mode 100644 _docs/07-ui-text.md delete mode 100644 _docs/08-authors.md delete mode 100644 _docs/09-layouts.md delete mode 100644 _docs/10-posts.md delete mode 100644 _docs/11-pages.md delete mode 100644 _docs/12-collections.md delete mode 100644 _docs/13-helpers.md delete mode 100644 _docs/14-utility-classes.md delete mode 100644 _docs/15-stylesheets.md delete mode 100644 _docs/16-javascript.md delete mode 100644 _docs/17-history.md delete mode 100644 _docs/18-contributing.md delete mode 100644 _docs/19-docs-2-2.md delete mode 100644 _docs/20-license.md delete mode 100644 _drafts/post-draft.md create mode 100644 _other/macros.md create mode 100644 _other/root.md delete mode 100644 _pages/about.md delete mode 100644 _pets/lhasa-apso.md delete mode 100644 _pets/tabby.md delete mode 100644 _portfolio/foo-bar-website.md delete mode 100644 _posts/2009-05-15-edge-case-nested-and-mixed-lists.md delete mode 100644 _posts/2009-06-01-edge-case-many-tags.md delete mode 100644 _posts/2009-07-02-edge-case-many-categories.md delete mode 100644 _posts/2009-08-06-edge-case-no-body-content.md delete mode 100644 _posts/2009-09-05-edge-case-no-yaml-title.md delete mode 100644 _posts/2009-10-05-edge-case-title-should-not-overflow-the-content-area.md delete mode 100644 _posts/2009-10-05-edge-case-very-long-title.md delete mode 100644 _posts/2010-01-07-post-modified.md delete mode 100644 _posts/2010-01-07-post-standard.md delete mode 100644 _posts/2010-01-08-post-chat.md delete mode 100644 _posts/2010-02-05-post-notice.md delete mode 100644 _posts/2010-02-05-post-quote.md delete mode 100644 _posts/2010-03-07-post-link.md delete mode 100644 _posts/2010-06-02-post-video-youtube.md delete mode 100644 _posts/2010-08-05-post-image-linked.md delete mode 100644 _posts/2010-08-05-post-image-standard.md delete mode 100644 _posts/2010-08-06-post-image-linked-caption.md delete mode 100644 _posts/2010-08-07-post-image-caption.md delete mode 100644 _posts/2010-09-09-post-gallery.md delete mode 100644 _posts/2010-09-10-post-twitter-embeds.md delete mode 100644 _posts/2010-10-25-post-future-date.md delete mode 100644 _posts/2012-01-02-layout-comments-disabled.md delete mode 100644 _posts/2012-01-02-layout-comments.md delete mode 100644 _posts/2012-01-02-layout-read-time-disabled.md delete mode 100644 _posts/2012-01-02-layout-read-time.md delete mode 100644 _posts/2012-01-02-layout-related-posts-disabled.md delete mode 100644 _posts/2012-01-02-layout-related-posts.md delete mode 100644 _posts/2012-01-02-layout-sharing-disabled.md delete mode 100644 _posts/2012-01-02-layout-sharing.md delete mode 100644 _posts/2012-01-03-layout-read-time-comments-sharing-related-posts-disabled.md delete mode 100644 _posts/2012-01-03-layout-table-of-contents-post.md delete mode 100644 _posts/2012-03-14-layout-code-excerpt-generated.md delete mode 100644 _posts/2012-03-14-layout-excerpt-defined.md delete mode 100644 _posts/2012-03-14-layout-excerpt-generated.md delete mode 100644 _posts/2012-03-15-layout-author-override.md delete mode 100644 _posts/2012-03-15-layout-author-sidebar-disabled.md delete mode 100644 _posts/2012-03-15-layout-header-image-external.md delete mode 100644 _posts/2012-03-15-layout-header-image-horizontal.md delete mode 100644 _posts/2012-03-15-layout-header-image-text-readability.md delete mode 100644 _posts/2012-03-15-layout-header-image-vertical.md delete mode 100644 _posts/2012-03-15-layout-header-overlay-color.md delete mode 100644 _posts/2012-03-15-layout-header-overlay-image.md delete mode 100644 _posts/2012-03-15-layout-more-tag.md delete mode 100644 _posts/2012-03-15-layout-sidebar-custom.md delete mode 100644 _posts/2012-05-22-markup-text-readability.md delete mode 100644 _posts/2013-01-05-markup-title-with-markup.md delete mode 100644 _posts/2013-01-05-markup-title-with-special-characters.md delete mode 100644 _posts/2013-01-09-markup-text-alignment.md delete mode 100644 _posts/2013-01-10-markup-image-alignment.md delete mode 100644 _posts/2013-01-11-markup-html-tags-and-formatting.md delete mode 100644 _posts/2013-05-22-markup-more-images.md delete mode 100644 _posts/2013-08-16-markup-syntax-highlighting.md delete mode 100644 _posts/2016-02-24-welcome-to-jekyll.md delete mode 100644 _recipes/chocolate-chip-cookies.md delete mode 100644 _recipes/oatmeal-cookies.md delete mode 100644 _recipes/peanut-butter-cookies.md create mode 100644 _scenarios/root.md create mode 100644 start.sh diff --git a/Gemfile.lock b/Gemfile.lock index 6a5ea60..c84a251 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -123,7 +123,6 @@ GEM ethon (>= 0.8.0) tzinfo (1.2.2) thread_safe (~> 0.1) - wdm (0.1.1) PLATFORMS ruby @@ -131,7 +130,6 @@ PLATFORMS DEPENDENCIES github-pages - wdm (~> 0.1.0) BUNDLED WITH 1.12.5 diff --git a/_classes/root.md b/_classes/root.md new file mode 100644 index 0000000..efd24d0 --- /dev/null +++ b/_classes/root.md @@ -0,0 +1,9 @@ +--- +title: "Class Information" +permalink: /classes/ +excerpt: "Class Information" +--- + +{% include base_path %} + +This section contains information on all of the classes in the game, including the disciplines, tiers, and maxes of each. diff --git a/_config.yml b/_config.yml index e1f3a47..ea634aa 100644 --- a/_config.yml +++ b/_config.yml @@ -20,7 +20,7 @@ words_per_minute : 200 comments: provider : "disqus" disqus: - shortname : "drakkar" + shortname : discourse: server : # https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963 , e.g.: meta.discourse.org facebook: @@ -32,7 +32,7 @@ atom_feed: path : # blank (default) uses feed.xml # SEO Related -google_site_verification : "UQj93ERU9zgECodaaXgVpkjrFn9UrDMEzVamacSoQ8Y" +google_site_verification : bing_site_verification : alexa_site_verification : yandex_site_verification : @@ -58,7 +58,7 @@ social: analytics: provider : false # false (default), "google", "google-universal", "custom" google: - tracking_id : "UA-2011187-3" + tracking_id : # Site Author @@ -149,16 +149,15 @@ kramdown: # Collections collections: - docs: + scenarios: output: true permalink: /:collection/:path/ - recipes: - output: true - permalink: /:collection/:path/ - pets: + + other: output: true permalink: /:collection/:path/ - portfolio: + + classes: output: true permalink: /:collection/:path/ @@ -176,17 +175,17 @@ defaults: comments: true share: true related: true - # _pages + - scope: path: "" type: pages values: layout: single author_profile: true - # _docs + - scope: path: "" - type: docs + type: scenarios values: layout: single read_time: false @@ -194,34 +193,31 @@ defaults: share: false comments: false sidebar: - nav: "docs" - # _recipes - - scope: - path: "" - type: recipes - values: - layout: single - author_profile: true - share: true - comments: true - # _pets + nav: "scenarios" + - scope: path: "" - type: pets + type: classes values: layout: single - author_profile: true - share: true - comment: true - # _portfolio + read_time: false + author_profile: false + share: false + comments: false + sidebar: + nav: "classes" + - scope: path: "" - type: portfolio + type: other values: layout: single + read_time: false author_profile: false - share: true - + share: false + comments: false + sidebar: + nav: "other" # Outputting permalink: /:categories/:title/ diff --git a/_data/authors.yml b/_data/authors.yml deleted file mode 100644 index 0ea8a64..0000000 --- a/_data/authors.yml +++ /dev/null @@ -1,18 +0,0 @@ -# Authors - -Billy Rick: - name : "Billy Rick" - uri : "http://thewhip.com" - email : "billy@rick.com" - bio : "What do you want, jewels? I am a very extravagant man." - avatar : "bio-photo-2.jpg" - twitter : "extravagantman" - google_plus : "BillyRick" - -Cornelius Fiddlebone: - name : "Cornelius Fiddlebone" - email : "cornelius@thewhip.com" - bio : "I ordered what?" - avatar : "bio-photo.jpg" - twitter : "rhymeswithsackit" - google_plus : "CorneliusFiddlebone" \ No newline at end of file diff --git a/_data/navigation.yml b/_data/navigation.yml index 84976da..6393d37 100644 --- a/_data/navigation.yml +++ b/_data/navigation.yml @@ -1,97 +1,88 @@ -# example navigation -foo: - - title: "Parent Link 1" - url: /parent-1-page-url/ - children: - - title: "Child Link 1" - url: /child-1-page-url/ - - title: "Child Link 2" - url: /child-2-page-url/ - - - title: "Parent Link 2" - url: /parent-2-page-url/ - children: - - title: "Child Link 1" - url: /child-1-page-url/ - - title: "Child Link 2" - url: /child-2-page-url/ - - title: "Child Link 3" - url: /child-3-page-url/ - # main links links main: - - title: "Quick-Start Guide" - url: /docs/quick-start-guide/ + - title: "Scenario Information" + url: /scenarios/ - - title: "About" - url: /about/ + - title: "Class Information" + url: /classes/ - - title: "Sample Posts" - url: /year-archive/ + - title: "Other" + url: /other/ - - title: "Sample Collections" - url: /collection-archive/ - - - title: "Terms & Privacy Policy" - url: /terms/ +other: + - title: "Other" + children: + - title: "EXP Chart" + url: /other/exp + - title: "Fating" + url: /other/fate + - title: "Macros" + url: /other/macros + - title: "Tier Locations" + url: /other/tiers +classes: + - title: "Healer" + children: + - title: "Information" + - title: "Disciplines" + - title: "Tiers" + - title: "Quirks" -# documentation links -docs: - - title: Getting Started +# scenario links +scenarios: + - title: "Nameless Lands" children: - - title: "Quick-Start Guide" - url: /docs/quick-start-guide/ - - title: "Structure" - url: /docs/structure/ - - title: "Installation" - url: /docs/installation/ - - title: "Upgrading" - url: /docs/upgrading/ + - title: "Scenario Information" + url: /scenarios/nl/ + - title: "Places" + url: /scenarios/nl/places + - title: "Quests" + url: /scenarios/nl/quests + - title: "Items" + url: /scenarios/nl/items - - title: Customization + - title: "Green Dragon Hatcheries" children: - - title: "Configuration" - url: /docs/configuration/ - - title: "Navigation" - url: /docs/navigation/ - - title: "UI Text" - url: /docs/ui-text/ - - title: "Authors" - url: /docs/authors/ - - title: "Layouts" - url: /docs/layouts/ + - title: "Scenario Information" + url: /scenarios/gdh/ + - title: "Places" + url: /scenarios/gdh/places + - title: "Quests" + url: /scenarios/gdh/quests + - title: "Items" + url: /scenarios/gdh/items - - title: Content + - title: "Black Dragon Consort" children: - - title: "Working with Posts" - url: /docs/posts/ - - title: "Working with Pages" - url: /docs/pages/ - - title: "Working with Collections" - url: /docs/collections/ - - title: "Helpers" - url: /docs/helpers/ - - title: "Utility Classes" - url: /docs/utility-classes/ + - title: "Scenario Information" + url: /scenarios/bdc/ + - title: "Places" + url: /scenarios/bdc/places + - title: "Quests" + url: /scenarios/bdc/quests + - title: "Items" + url: /scenarios/bdc/items - - title: Extras + - title: "Silver Dragon Consort" children: - - title: "Stylesheets" - url: /docs/stylesheets/ - - title: "JavaScript" - url: /docs/javascript/ + - title: "Scenario Information" + url: /scenarios/sdc/ + - title: "Places" + url: /scenarios/sdc/places + - title: "Quests" + url: /scenarios/sdc/quests + - title: "Items" + url: /scenarios/sdc/items - - title: Meta + - title: "Sullen Keep" children: - - title: "History" - url: /docs/history/ - - title: "Contributing" - url: /docs/contributing/ - - title: "Old 2.2 Docs" - url: /docs/docs-2-2/ - - title: "License" - url: /docs/license/ - - title: "Terms & Privacy Policy" - url: /terms/ \ No newline at end of file + - title: "Scenario Information" + url: /scenarios/sk/ + - title: "Places" + url: /scenarios/sk/places + - title: "Quests" + url: /scenarios/sk/quests + - title: "Items" + url: /scenarios/sk/items diff --git a/_docs/01-quick-start-guide.md b/_docs/01-quick-start-guide.md deleted file mode 100644 index 2ed16ac..0000000 --- a/_docs/01-quick-start-guide.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: "Quick-Start Guide" -permalink: /docs/quick-start-guide/ -excerpt: "How to quickly install and setup Minimal Mistakes for use with GitHub Pages." -modified: 2016-04-13T15:54:02-04:00 -redirect_from: - - /theme-setup/ ---- - -{% include base_path %} - -Minimal Mistakes has been developed to be 100% compatible with hosting a site on [GitHub Pages](https://pages.github.com/). To get up and running with a new GitHub repository quickly, follow these steps or jump ahead to the [full installation guide]({{ base_path }}/docs/installation/). - -## Fork the Theme - -Fork the [Minimal Mistakes theme](https://github.com/mmistakes/minimal-mistakes/fork), then rename the repo to **USERNAME.github.io** --- replacing **USERNAME** with your GitHub username. - -
- fork Minimal Mistakes -
- -**Note:** Your Jekyll site should be viewable immediately at . If it's not, you can force a rebuild by **Customizing Your Site** (see below for more details). -{: .notice--warning} - -If you're hosting several Jekyll based sites under the same GitHub username you will have to use Project Pages instead of User Pages. Essentially you rename the repo to something other than **USERNAME.github.io** and create a `gh-pages` branch off of `master`. For more details on how to set things up check [GitHub's documentation](https://help.github.com/articles/user-organization-and-project-pages/). - -
- creating a new branch on GitHub -
- -**ProTip:** Be sure to [delete](https://github.com/blog/1377-create-and-delete-branches) the `gh-pages` branch if you forked Minimal Mistakes. This branch contains the documentation and demo site for the theme and you probably don't want that showing up in your repo. -{: .notice--info} - -## Customize Your Site - -Open up `_config.yml` found in the root of the repo and edit anything under **Site Settings**. For a full explanation of every setting be sure to read the [**Configuration**]({{ base_path }}/docs/configuration/) section, but for now let's just change the site's title. - -
- editing _config.yml file -
Edit text files without leaving GitHub.com
-
- -Committing a change to `_config.yml` (or any file in your repository) will force GitHub Pages to rebuild your site with Jekyll. It should then be viewable a few seconds later at `https://USERNAME.github.io`. - ---- - -Congratulations! You've successfully forked the theme and are up an running with GitHub Pages. Now you're ready to add content and customize the site further. diff --git a/_docs/02-structure.md b/_docs/02-structure.md deleted file mode 100644 index 4f03c3e..0000000 --- a/_docs/02-structure.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: "Structure" -permalink: /docs/structure/ -excerpt: "How the theme is organized and what all of the files are for." -modified: 2016-04-13T15:54:02-04:00 ---- - -Nothing clever here :wink:. Layouts, data files, and includes are all placed in their default locations. Stylesheets and scripts in `assets`, and a few development related files in the project's root directory. - -```bash -minimal-mistakes -├── _data # data files for customizing the theme -| ├── navigations.yml # main navigation links -| └── ui-text.yml # text used throughout the theme's UI -├── _includes -| ├── analytics-providers # snippets for analytics (Google and custom) -| ├── comments-providers # snippets for comments (Disqus, Facebook, Google+, and custom) -| ├── footer # custom snippets to add to site footer -| ├── head # custom snippets to add to site head -| ├── base_path # site.url + site.baseurl shortcut -| ├── feature_row # feature row helper -| ├── gallery # image gallery helper -| ├── group-by-array # group by array helper for archives -| ├── nav_list # navigation list helper -| ├── toc # table of contents helper -| └── ... -├── _layouts -| ├── archive-taxonomy.html # tag/category archive for Jekyll Archives plugin -| ├── archive.html # archive listing documents in an array -| ├── compress.html # compresses HTML in pure Liquid -| ├── default.html # base for all other layouts -| ├── single.html # single document (post/page/etc) -| └── splash.html # splash page -├── assets -| ├── _scss # stylesheet source files -| | ├── vendor # vendor SCSS partials -| | ├── main.scss # imports all SCSS partials -| | └── ... # theme SCSS partials -| ├── css -| | └── main.css # optimized stylesheet loaded in -| ├── fonts -| | └── fontawesome-webfont # Font Awesome webfonts -| ├── js -| | ├── plugins # jQuery plugins -| | ├── vendor # vendor scripts -| | ├── _main.js # plugin settings and other scripts to load after jQuery -| | └── main.min.js # optimized and concatenated script file loaded before -├── images # image assets for posts/pages/collections/etc. -├── _config.yml # site configuration -├── Gemfile # gem file dependencies -├── Gemfile.lock # gem file dependencies -├── index.html # paginated home page showing recent posts -└── package.json # NPM build scripts -``` \ No newline at end of file diff --git a/_docs/03-installation.md b/_docs/03-installation.md deleted file mode 100644 index c2d53e5..0000000 --- a/_docs/03-installation.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: "Installation" -permalink: /docs/installation/ -excerpt: "Instructions for installing the theme for new and existing Jekyll based sites." -modified: 2016-08-01T09:36:36-04:00 ---- - -{% include base_path %} - -## Install the Theme - -There are several ways to install the theme: - -**1.** For a **new site**, fork the Minimal Mistakes repo on GitHub. If you plan on hosting your site with GitHub Pages follow the steps outlined in the [*Quick-Start Guide*]({{ base_path }}/docs/quick-start-guide/). - -**2.** For an **existing site** you have some more work ahead of you. What I suggest is to fork and rename the theme's repo as before, then clone it locally by running `git clone https://github.com/USERNAME/REPONAME.git` --- replacing **USERNAME** and **REPONAME** with your own. - -
- copy GitHub repo URL -
Tap the copy to clipboard button (outlined in red above) to grab your GitHub repo's path.
-
- -**3.** And for those who don't want to mess with Git, you can download the theme as a ZIP file to work with locally. - -[ Download Minimal Mistakes Theme](https://github.com/mmistakes/minimal-mistakes/archive/master.zip){: .btn .btn--success} - -**ProTip:** Be sure to [delete](https://github.com/blog/1377-create-and-delete-branches) the `gh-pages` branch if you forked Minimal Mistakes. This branch contains the documentation and demo site for the theme and you probably don't want that showing up in your repo. -{: .notice--info} - ---- - -To move over any existing content you'll want to copy the contents of your `_posts` folder to the new site. Along with any pages, collections, data files, images, or other assets you may have. - -Next you'll need to convert posts and pages to use the proper layouts and settings. In most cases you simply need to update `_config.yml` to your liking and set the correct `layout` in their YAML Front Matter. - -[**Front Matter defaults**](https://jekyllrb.com/docs/configuration/#front-matter-defaults) are your friend and I encourage you to leverage them instead of setting a layout and other global options in each post/page's YAML Front Matter. - -Posts can be configured to use the `single` layout --- with reading time, comments, social sharing links, and related posts enabled. Adding the following to `_config.yml` will set these defaults for all posts: - -```yaml -defaults: - # _posts - - scope: - path: "" - type: posts - values: - layout: single - read_time: true - comments: true - share: true - related: true -``` - -**Post/Page Settings**: Be sure to read through the "Working with..." documentation to learn about all the options available to you. The theme has been designed to be flexible --- with numerous settings for each. -{: .notice--info} - -## Install Dependencies - -If this is your first time using Jekyll be sure to read through the [official documentation](https://jekyllrb.com/docs/home/) before jumping in. This guide assumes you have Ruby v2 installed and a basic understanding of how Jekyll works. - -To keep your sanity and better manage dependencies I strongly urge you to [install Bundler](http://bundler.io/) with `gem install bundler` and use the included [`Gemfile`](https://github.com/{{ site.repository }}/blob/master/Gemfile). The theme's Gemfile includes the `github-pages` gem to maintain a local Jekyll environment in sync with GitHub Pages. - -If you're not planning to host with GitHub Pages and want to leverage features found in the latest version of Jekyll, uncomment the `gem "jekyll"` line in your `Gemfile`. In either case run the following: - -```bash -$ bundle install -``` - -**Note:** The [GitHub Pages gem](https://github.com/github/pages-gem) installs additional dependencies that may need to be added to your `Gemfile` if you decide to remove the `gem "github-pages"`. -{: .notice--warning} - -
- bundle install in Terminal window -
- -Depending on what gems you already have installed you may have to run `bundle update` to clear up any dependency issues. Bundler is usually pretty good at letting you know what gems need updating or have issues installing, to further investigate. - -When using Bundler to manage gems you'll want to run Jekyll using `bundle exec jekyll serve` and `bundle exec jekyll build`. - -Doing so executes the gem versions specified in `Gemfile.lock`. Sure you can test your luck with a naked `jekyll serve`, but I wouldn't suggest it. A lot of Jekyll errors originate from outdated or conflicting gems fighting with each other. So do yourself a favor and just use Bundler. \ No newline at end of file diff --git a/_docs/04-upgrading.md b/_docs/04-upgrading.md deleted file mode 100644 index 66ecefa..0000000 --- a/_docs/04-upgrading.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: "Upgrading" -permalink: /docs/upgrading/ -excerpt: "Instructions and suggestions for upgrading the theme." -modified: 2016-08-01T09:43:46-04:00 ---- - -{% include base_path %} - -Currently there is no good way of upgrading the theme without doing a bit of manual work. The future looks promising now that [**gem based themes**](https://jekyllrb.com/docs/themes/) have landed with Jekyll `v3.2`, but for now here's some suggestions on how to handle updates. - -**Gemified Theme**: A future version of Minimal Mistakes will suppor the new Jekyll theme system. A few key features like theme assets (eg. fonts, images, and JavaScript) and support for GitHub Pages are currently missing for this enhancement to happen now. Stay tuned! -{: .notice--info} - -## Use Git - -If you want to get the most out of the Jekyll + GitHub Pages workflow, then you'll need to utilize Git. To pull down theme updates you must first ensure there's an upstream remote. If you forked the theme's repo then you're likely good to go. - -To double check, run `git remote -v` and verify that you can fetch from `origin https://github.com/{{ site.repository }}.git`. - -To add it you can do the following: - -```bash -$ git remote add upstream https://github.com/{{ site.repository }}.git -``` - -### Pull Down Updates - -Now you can pull any commits made to theme's `master` branch with: - -```bash -$ git pull upstream master -``` - -Depending on the amount of customizations you've made after forking, there's likely to be merge conflicts. Work through any conflicting files Git flags, staging the changes you wish to keep, and then commit them. - -## Update Files Manually - -Another way of dealing with updates is [downloading the theme](https://github.com/{{ site.repository }}/archive/master.zip) --- replacing your layouts, includes, and assets with the newer ones manually. To be sure that you don't miss any changes it's probably a good idea to review the theme's [commit history](https://github.com/{{ site.repository }}/commits/master) to see what's changed since. - -Here's a quick checklist of the important folders/files you'll want to be mindful of: - -| Name | | -| ---- | --- | -| `_layouts` | Replace all. Apply edits if you customized any layouts. | -| `_includes` | Replace all. Apply edits if you customized any includes. | -| `assets` | Replace all. Apply edits if you customized stylesheets or scripts. | -| `_data/navigation.yml` | Safe to keep. Verify that there were no major structural changes or additions. | -| `_data/ui-text.yml` | Safe to keep. Verify that there were no major structural changes or additions. | -| `_config.yml` | Safe to keep. Verify that there were no major structural changes or additions. | diff --git a/_docs/05-configuration.md b/_docs/05-configuration.md deleted file mode 100644 index 252852d..0000000 --- a/_docs/05-configuration.md +++ /dev/null @@ -1,564 +0,0 @@ ---- -title: "Configuration" -permalink: /docs/configuration/ -excerpt: "Settings for configuring and customizing the theme." -modified: 2016-08-02T12:14:38-04:00 ---- - -{% include base_path %} - -Settings that affect your entire site can be changed in [Jekyll's configuration file](https://jekyllrb.com/docs/configuration/): `_config.yml`, found in the root of your project. - -**Note:** for technical reasons, `_config.yml` is NOT reloaded automatically when used with `jekyll serve`. If you make any changes to this file, please restart the server process for them to be applied. -{: .notice--warning} - -Take a moment to look over the configuration file included with the theme. Comments have been added to provide examples and default values for most settings. Detailed explanations of each can be found below. - -## Site Settings - -### Site Locale - -`site.locale` is used to declare the primary language for each web page within the site. - -*Example:* `locale: "en-US"` sets the `lang` attribute for the site to the *United States* flavor of English, while `en-GB` would be for the `United Kingdom` style of English. Country codes are optional and the shorter `locale: "en"` is also acceptable. To find your language and country codes check this [reference table](https://msdn.microsoft.com/en-us/library/ee825488(v=cs.20).aspx). - -Properly setting the locale is important for associating localized text found in the [**UI Text**]({{ base_path }}/docs/ui-text/) data file. An improper match will cause parts of the UI to disappear (eg. button labels, section headings, etc). - -**Note:** The theme comes with localized text in English (`en`, `en-US`, `en-GB`). If you change `locale` in `_config.yml` to something else, most of the UI text will go blank. Be sure to add the corresponding locale key and translated text to `_data/ui-text.yml` to avoid this. -{: .notice--warning} - -### Site Title - -The name of your site. Is used throughout the theme in places like the site masthead and `` tags. - -*Example:* `title: "My Awesome Site"` - -You also have the option of customizing the separation character used in SEO-friendly page titles. - -*Example:* `title_separator: "|"` would produce page titles like `Sample Page | My Awesome Site`. - -### Site Name - -Used to assign a site author. Don't worry, you can override the site author with different ones on specific posts, pages, or collection documents. - -*Example:* `name: "Michael Rose"`. - -**ProTip:** If you want to get crafty with your YAML you can use [anchors](http://www.yaml.org/spec/1.2/spec.html#id2785586) to reuse values. For example `foo: &var "My String"` allows you to reuse `"My String"` elsewhere in `_config.yml` like so... `bar: *var`. You'll see a few examples of this in the provided Jekyll config. -{: .notice--info} - -### Site Description - -Fairly obvious. `site.description` describes the site. Used predominantly in meta descriptions as part of SEO efforts. - -*Example:* `description: "A flexible Jekyll theme for your blog or site with a minimalist aesthetic."` - -### Site URL - -The base hostname and protocol for your site. If you're hosting with GitHub Pages this will be something like `url: "https://github.io.mmistakes"` or `url: "https://mademistakes.com"` if you have a custom domain name. - -**Note:** It's important to remember that when testing locally you need to change the `site.url`. Ideally you'd use [multiple config files](https://mademistakes.com/articles/using-jekyll-2016/#environments-and-configurations) with `bundle exec jekyll serve --config _config.yml,_config.dev.yml` to apply development overrides. Simply commenting out the line works as well `# url: "https://mmistakes.github.io"`. Just remember to uncomment it before pushing or else you'll have broken assets and links all over the place! -{: .notice--warning} - -**ProTip:** To force GitHub hosted sites to [redirect http traffic to https](https://konklone.com/post/github-pages-now-sorta-supports-https-so-use-it) use a service like [Cloudflare](https://www.cloudflare.com/). -{: .notice--info} - -### Site Base URL - -This little option causes all kinds of confusion in the Jekyll community. If you're not hosting your site as a GitHub Pages Project or in a subfolder (eg: `/blog`), then don't mess with it. - -In the case of the Minimal Mistakes demo site it's hosted on GitHub at <https://mmistakes.github.io/minimal-mistakes>. To correctly set this base path I'd use `url: "https://mmistakes.github.io"` and `baseurl: "/minimal-mistakes"`. - -For more information on how to properly use `site.url` and `site.baseurl` as intended by the Jekyll maintainers, check [Parker Moore's post on the subject](https://byparker.com/blog/2014/clearing-up-confusion-around-baseurl/). - -**Note:** When using `baseurl` remember to include it as part of your path when testing your site locally. Values of `url: ` and `baseurl: "/blog"` would make your local site visible at `http://localhost:4000/blog` and not `http://localhost:4000`. -{: .notice--warning} - -### Site Repository - -Add your repository name with organization to your site's configuration file, `_config.yml`. - -```yaml -repository: "username/repo-name" -``` - -"NWO" stands for "name with owner." It is GitHub lingo for the username of the owner of the repository plus a forward slash plus the name of the repository, e.g. '**mmistakes/minimal-mistakes**', where '**mmistakes**' is the owner and **'minimal-mistakes**' is the repository name. - -Your `site.github.*` fields should fill in like normal. If you run Jekyll with the --verbose flag, you should be able to see all the API calls made. - -If you don't set `repository` correctly you may see the following error when trying to `serve` or `build` your Jekyll site: - -**Liquid Exceptions:** No repo name found. Specify using `PAGES_REPO_NWO` environment variables, `repository` in your configuration, or set up `origin` git remote pointing to your github.com repository. -{: .notice--danger} - -For more information on how `site.github` data can be used with Jekyll check out [`github-metadata`'s documentation](https://github.com/jekyll/github-metadata). - -### Site Default Teaser Image - -To assign a fallback teaser image used in the "**Related Posts**" module, place a graphic in the `/images/` directory and add the filename to `_config.yml` like so: - -```yaml -teaser: "500x300.png" -``` - -This image can be overridden at anytime by applying the following to a document's YAML Front Matter. - -```yaml -header: - teaser: my-awesome-post-teaser.jpg -``` - -<figure> - <img src="{{ base_path }}/images/mm-teaser-images-example.jpg" alt="teaser image example"> - <figcaption>Example of teaser images found in the related posts module.</figcaption> -</figure> - -### Breadcrumb Navigation (Beta) - -Enable breadcrumb links to help visitors better navigate deep sites. Because of the fragile method of implementing them they don't always produce accurate links reliably. For best results: - -1. Use a category based permalink structure e.g. `permalink: /:categories/:title/` -2. Manually create pages for each category or use a plugin like [jekyll-archives][jekyll-archives] to auto-generate them. If these pages don't exist breadcrumb links to them will be broken. - -![breadcrumb navigation example]({{ base_path }}/images/mm-breadcrumbs-example.jpg) - -```yaml -breadcrumbs: true # disabled by default -``` - -Breadcrumb start link text and separator character can both be changed in the [UI Text data file]({{ base_path }}/docs/ui-text/). - -### Reading Time - -Enable estimated reading time snippets with `read_time: true` in YAML Front Matter. `200` has been set as the default words per minute value --- which can be changed by adjusting `words_per_minutes: ` in `_config.yml`. - -![reading time example]({{ base_path }}/images/mm-read-time-example.jpg) - -Instead of adding `read_time: true` to each post, apply as a default in `_config.yml` like so: - -```yaml -defaults: - # _posts - - scope: - path: "" - type: posts - values: - read_time: true -``` - -To disable reading time for a post, add `read_time: false` its YAML Front Matter to override what was set in `_config.yml`. - -### Comments - -Commenting for [**Disqus**](https://disqus.com/), [**Discourse**](https://www.discourse.org/), [**Facebook**](https://developers.facebook.com/docs/plugins/comments), and **Google+** are built into the theme. First set the comment provider you'd like to use: - -| Name | Comment Provider | -| ---- | ---------------- | -| **disqus** | Disqus | -| **discourse** | Discourse | -| **facebook** | Facebook Comments | -| **google-plus** | Google+ Comments | -| **custom** | Other | - -Then add `comments: true` to each document you want comments visible on. - -Instead of adding YAML Front Matter to each document, apply as a default in `_config.yml`. To enable comments for all posts: - -```yaml -defaults: - # _posts - - scope: - path: "" - type: posts - values: - comments: true -``` - -If you add `comments: false` to a post's YAML Front Matter it will override the default and disable comments for just that post. - -##### Disqus - -To use Disqus you'll need to create an account and [shortname](https://help.disqus.com/customer/portal/articles/466208-what-s-a-shortname-). Once you have both update `_config.yml` to: - -```yaml -comments: - provider: "disqus" - disqus: - shortname: "your-disqus-shortname" -``` - -##### Discourse - -For guidance on how to set up Discourse for embedding comments from a topic on a post page, [consult this guide](https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963). - -```yaml -comments: - provider : "discourse" - discourse: - server : # meta.discourse.org -``` - - -##### Facebook Comments - -To enable Facebook Comments choose how many comments you'd like visible per post and the color scheme of the widget. - -```yaml -comments: - provider : "facebook" - facebook: - appid : # optional - num_posts : # 5 (default) - colorscheme : # "light" (default), "dark" -``` - -##### Other Comment Providers - -To use another provider not included with the theme set `provider: "custom"` then add their embed code to `_includes/comments-providers/custom.html`. - -### Custom Feed URL - -By default the theme links to `feed.xml` generated in the root of your site by the **jekyll-feed** plugin. To link to an externally hosted feed update `atom_feed` in `_config.yml` like so: - -```yaml -atom_feed: - path: "http://feeds.feedburner.com/youFeedname" -``` - -**Note:** By default the site feed is linked in two locations: inside the [`<head>` element]({{ gh_repo }}/master/_includes/head.html) and at the bottom of every page in the [site footer](https://github.com/{{ site.repository }}/master/_includes/footer.html). -{: .notice--info} - -### SEO, Social Sharing, and Analytics Settings - -All optional, but a good idea to take the time setting up to improve SEO and links shared from the site. - -#### Google Search Console - -Formerly known as [Google Webmaster Tools](https://www.google.com/webmasters/tools/), add your [verification code](https://support.google.com/analytics/answer/1142414?hl=en) like so: `google_site_verification: "yourVerificationCode"`. - -**Note:** You likely won't have to do this if you verify site ownership through **Google Analytics** instead. -{: .notice--warning} - -#### Bing Webmaster Tools - -There are several ways to [verify site ownership](https://www.bing.com/webmaster/help/how-to-verify-ownership-of-your-site-afcfefc6) --- the easiest adding an authentication code to your config file. - -Copy and paste the string inside of `content`: - -```html -<meta name="msvalidate.01" content="0FC3FD70512616B052E755A56F8952D" /> -``` - -Into `_config.yml` - -```yaml -bing_site_verification: "0FC3FD70512616B052E755A56F8952D" -``` - -#### Alexa - -To [claim your site](http://www.alexa.com/siteowners/claim) with Alexa add the provided verification ID `alexa_site_verification: "yourVerificationID"`. - -#### Yandex - -To verify site ownership copy and paste the string inside of `name`: - -```html -<meta name='yandex-verification' content='2132801JL' /> -``` - -Into `_config.yml` - -```yaml -yandex_site_verification: "2132801JL" -``` - -#### Twitter Cards and Facebook Open Graph - -To improve the appearance of links shared from your site to social networks like Twitter and Facebook be sure to configure the following. - -##### Site Twitter Username - -Twitter username for the site. For pages that have custom author Twitter accounts assigned in their YAML Front Matter or data file, they will be attributed as a **creator** in the Twitter Card. - -For example if my site's Twitter account is `@mmistakes-theme` I would add the following to `_config.yml` - -```yaml -twitter: - username: "mmistakes-theme" -``` - -And if I assign `@mmistakes` as an author account it will appear in the Twitter Card along with `@mmistakes-theme`, attributed as a creator of the page being shared. - -**Note**: You need to [apply for Twitter Cards](https://dev.twitter.com/docs/cards) and validate they're working on your site before they will begin showing up. -{: .notice--warning} - -##### Facebook Open Graph - -If you have a Facebook ID or publisher page add them: - -```yaml -facebook: - app_id: # A Facebook app ID - publisher: # A Facebook page URL or ID of the publishing entity -``` - -While not part a part of Open Graph, you can also add your Facebook username for use in the sidebar and footer. - -```yaml -facebook: - username: "michaelrose" # https://www.facebook.com/michaelrose -``` - -**ProTip:** To debug Open Graph data use [this tool](https://developers.facebook.com/tools/debug/og/object?q=https%3A%2F%2Fmademistakes.com) to test your pages. If content changes aren't reflected you will probably have to hit the **Fetch new scrape information** button to refresh. -{: .notice--info} - -##### Open Graph Default Image - -For pages that don't have a `header.image` assigned in their YAML Front Matter, `site.og_image` will be used as a fallback. Use your logo, icon, avatar or something else that is meaningful. Just make sure it is place in the `/images/` folder, a minimum size of 120px by 120px, and less than 1MB in file size. - -```yaml -og_image: "site-logo.png" -``` - -<figure> - <img src="{{ base_path }}/images/mm-twitter-card-summary-image.jpg" alt="Twitter Card summary example"> - <figcaption>Example of a image placed in a Summary Card.</figcaption> -</figure> - -Documents who have a `header.image` assigned in their YAML Front Matter will appear like this when shared on Twitter and Facebook. - -<figure> - <img src="{{ base_path }}/images/mm-twitter-card-summary-large.jpg" alt="page shared on Twitter"> - <figcaption>Shared page on Twitter with header image assigned.</figcaption> -</figure> - -<figure> - <img src="{{ base_path}}/images/facebook-share-example.jpg" alt="page shared on Facebook"> - <figcaption>Shared page on Facebook with header image assigned.</figcaption> -</figure> - -##### Include your social profile in search results - -Use markup on your official website to add your [social profile information](https://developers.google.com/structured-data/customize/social-profiles#adding_structured_markup_to_your_site) to the Google Knowledge panel in some searches. Knowledge panels can prominently display your social profile information. - -```yaml -social: - type: # Person or Organization (defaults to Person) - name: # If the user or organization name differs from the site's name - links: - - "https://twitter.com/yourTwitter" - - "https://facebook.com/yourFacebook" - - "https://instagram.com/yourProfile" - - "https://www.linkedin.com/in/yourprofile" - - "https://plus.google.com/your_profile" -``` - -#### Analytics - -Analytics is disabled by default. To enable globally select one of the following: - -| Name | Analytics Provider | -| ---- | ------------------ | -| **google** | [Google Standard Analytics](https://www.google.com/analytics/) | -| **google-universal** | [Google Universal Analytics](https://www.google.com/analytics/) | -| **custom** | Other analytics providers | - -For Google Analytics add your Tracking Code: - -```yaml -analytics: - provider: "google-universal" - tracking_id: "UA-1234567-8" -``` - -To use another provider not included with the theme set `provider: "custom"` then add their embed code to `_includes/analytics-providers/custom.html`. - -## Site Author - -Used as the defaults for defining what appears in the author sidebar. - -![author sidebar example]({{ base_path }}/images/mm-author-sidebar-example.jpg) - -**Note:** For sites with multiple authors these values can be overridden post by post with custom YAML Front Matter and a data file. For more information on how that works see below. -{: .notice--info} - -```yaml -author: - name : "Your Name" - avatar : "bio-photo.jpg" # placed in /images/ - bio : "My awesome biography constrained to a sentence or two goes here." - email : # optional - uri : "http://your-site.com" -``` - -Social media links are all optional, include the ones you want visible. In most cases you just need to add the username. If you're unsure double check `_includes/author-profile.html` to see how the URL is constructed. - -To add social media links not included with the theme or customize the author sidebar further, read the full [layout documentation]({{ base_path }}/docs/layouts/#author-profile). - -## Reading Files - -Nothing out of the ordinary here. `include` and `exclude` may be the only things you need to alter. - -## Conversion and Markdown Processing - -Again nothing out of the ordinary here as the theme adheres to the defaults used by GitHub Pages. [**Kramdown**](http://kramdown.gettalong.org/) for Markdown conversion, [**Rouge**](http://rouge.jneen.net/) syntax highlighting, and incremental building disabled. Change them if you need to. - -## Front Matter Defaults - -To save yourself time setting [Front Matter Defaults](https://jekyllrb.com/docs/configuration/#front-matter-defaults) for posts, pages, and collections is the way to go. Sure you can assign layouts and toggle settings like **reading time**, **comments**, and **social sharing** in each file, but that's not ideal. - -Using the `default` key in `_config.yml` you could set the layout and enable author profiles, reading time, comments, social sharing, and related posts for all posts --- in one shot. - -```yaml -defaults: - # _posts - - scope: - path: "" - type: posts - values: - layout: single - author_profile: true - read_time: true - comments: true - share: true - related: true -``` - -Pages Front Matter defaults can be scoped like this: - -```yaml -defaults: - # _pages - - scope: - path: "" - type: pages - values: - layout: single -``` - -And collections like this: - -```yaml -defaults: - # _foo - - scope: - path: "" - type: foo - values: - layout: single -``` - -And of course any default value can be overridden by settings in a post, page, or collection file. All you need to do is specify the settings in the YAML Front Matter. For more examples be sure to check out the demo site's [`_config.yml`](https://github.com/{{ site.repository }}/gh-pages/_config.yml). - -## Outputting - -The default permalink style used by the theme is `permalink: /:categories/:title/`. If you have a post named `2016-01-01-my-post.md` with `categories: foo` in the YAML Front Matter, Jekyll will generate `_site/foo/my-post/index.html`. - -**Note:** If you plan on enabling breadcrumb links --- including category names in permalinks is a big part of how those are created. -{: .notice--warning} - -### Paginate - -If [using pagination](https://github.com/jekyll/jekyll-paginate) on the homepage you can change the amount of posts shown with: - -```yaml -paginate: 5 -``` - -You'll also need to include some Liquid and HTML to properly use the paginator, which you can find in the **Layouts** section under [Home Page]({{ base_path }}/docs/layouts/#home-page). - -### Timezone - -This sets the timezone environment variable, which Ruby uses to handle time and date creation and manipulation. Any entry from the [IANA Time Zone Database](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones) is valid. The default is the local time zone, as set by your operating system. - -```yaml -timezone: America/New_York -``` - -## Plugins - -When hosting with GitHub Pages a small [set of gems](https://pages.github.com/versions/) have been whitelisted for use. The theme uses a few of them which can be found under `gems`. Additional settings and configurations are documented in the links below. - -| Plugin | Description | -| ------ | ----------- | -| [jekyll-paginate][jekyll-paginate] | Pagination Generator for Jekyll. | -| [jekyll-sitemap][jekyll-sitemap] |Jekyll plugin to silently generate a sitemaps.org compliant sitemap for your Jekyll site. | -| [jekyll-gist][jekyll-gist] | Liquid tag for displaying GitHub Gists in Jekyll sites. | -| [jekyll-feed][jekyll-feed] | A Jekyll plugin to generate an Atom (RSS-like) feed of your Jekyll posts. | -| [jemoji][jemoji] | GitHub-flavored emoji plugin for Jekyll. | - -[jekyll-paginate]: https://github.com/jekyll/jekyll-paginate -[jekyll-sitemap]: https://github.com/jekyll/jekyll-sitemap -[jekyll-gist]: https://github.com/jekyll/jekyll-gist -[jekyll-feed]: https://github.com/jekyll/jekyll-feed -[jemoji]: https://github.com/jekyll/jemoji - -If you're hosting elsewhere then you don't really have to worry about what is whitelisted as you are free to include whatever [Jekyll plugins](https://jekyllrb.com/docs/plugins/) you desire. - -## Archive Settings - -The theme ships with support for taxonomy (category and tag) pages. GitHub Pages hosted sites need to use a *Liquid only* approach while those hosted elsewhere can use plugins like [**jekyll-archives**][jekyll-archives] to generate these pages automatically. - -[jekyll-archives]: https://github.com/jekyll/jekyll-archives - -The default `type` is set to use Liquid. - -**Note:** `category_archive` and `tag_archive` were previously named `categories` and `tags`. Names were changed to avoid possible conflicts with `site.categories` and `site.tags`. -{: .notice--danger} - -```yaml -category_archive: - type: liquid - path: /categories/ -tag_archive: - type: liquid - path: /tags/ -``` - -Which would create category and tag links in the breadcrumbs and page meta like: `/categories/#foo` and `/tags/#foo`. - -**Note:** for these links to resolve properly, category and tag index pages need to exist at [`/categories/index.html`](https://github.com/{{ site.repository }}/gh-pages/_pages/category-archive.html) and [`/tags/index.html`](https://github.com/{{ site.repository }}/gh-pages/_pages/tag-archive.html). The necessary Liquid code to build these pages can be taken from the demo site. -{: .notice--warning} - -If you have the luxury of using Jekyll Plugins then [**jekyll-archives**][jekyll-archives] will make your life much easier as category and tag pages are created for you. - -Change `type` to `jekyll-archives` and apply the following [configurations](https://github.com/jekyll/jekyll-archives/blob/master/docs/configuration.md): - -```yaml -category_archive: - type: jekyll-archives - path: /categories/ -tag_archive: - type: jekyll-archives - path: /tags/ -jekyll-archives: - enabled: - - categories - - tags - layouts: - category: archive-taxonomy - tag: archive-taxonomy - permalinks: - category: /categories/:name/ - tag: /tags/:name/ -``` - -**Note:** The `archive-taxonomy` layout used by jekyll-archives is provided with the theme and can be found in the `_layouts` folder. -{: .notice--info} - -## HTML Compression - -If you care at all about performance (and really who doesn't) compressing the HTML files generated by Jekyll is a good thing to do. - -If you're hosting with GitHub Pages there aren't many options afforded to you for optimizing the HTML Jekyll generates. Thankfully there is some Liquid wizardry you can use to strip whitespace and comments to reduce file size. - -There's a variety of configurations and cavets to using the `compress` layout, so be sure to read through the [documentation](http://jch.penibelst.de/) if you decide to make change the defaults set in the theme's `_config.yml`. - -```yaml -compress_html: - clippings: all - ignore: - envs: development # disable compression in dev environment -``` - -**Caution:** Inline JavaScript comments can cause problems with `compress.html`, so be sure to `/* comment this way */` and avoid `// these sorts of comments`. diff --git a/_docs/06-navigation.md b/_docs/06-navigation.md deleted file mode 100644 index f0a481f..0000000 --- a/_docs/06-navigation.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: "Navigation" -permalink: /docs/navigation/ -excerpt: "Instructions on how to customize the main navigation and enabling breadcrumb links." -modified: 2016-04-13T15:54:02-04:00 ---- - -{% include base_path %} - -## Masthead - -The masthead links use a "priority plus" design pattern. Meaning, show as many navigation items that will fit horizontally with a toggle to reveal the rest. - -To define these links add titles and URLs under the `main` key in `_data/navigation.yml`: - -```yaml -main: - - title: "Quick-Start Guide" - url: /docs/quick-start-guide/ - - - title: "Posts" - url: /year-archive/ - - - title: "Categories" - url: /categories/ - - - title: "Tags" - url: /tags/ - - - title: "Pages" - url: /page-archive/ - - - title: "Collections" - url: /collection-archive/ - - - title: "External Link" - url: https://google.com -``` - -Which will give you a responsive masthead similar to this: - -![priority plus masthead animation]({{ base_path }}/images/mm-priority-plus-masthead.gif) - -**ProTip:** Put the most important links first so they're always visible and not hidden behind the **menu toggle**. -{: .notice--info} - -## Breadcrumbs (Beta) - -Enable breadcrumb links to help visitors better navigate deep sites. Because of the fragile method of implementing them they don't always produce accurate links reliably. For best results: - -1. Use a category based permalink structure e.g. `permalink: /:categories/:title/` -2. Manually create pages for each category or use a plugin like [jekyll-archives](https://github.com/jekyll/jekyll-archives) to auto-generate them. If these pages don't exist breadcrumb links to them will be broken. - -![breadcrumb navigation example]({{ base_path }}/images/mm-breadcrumbs-example.jpg) - -```yaml -breadcrumbs: true # disabled by default -``` - -Breadcrumb start link text and separator character can both be changed in `_data/ui-text.yml`. - -```yaml -breadcrumb_home_label : "Home" -breadcrumb_separator : "/" -``` - -For breadcrumbs that resemble something like `Start > Blog > My Awesome Post` you'd apply these settings: - -```yaml -breadcrumb_home_label : "Start" -breadcrumb_separator : ">" -``` \ No newline at end of file diff --git a/_docs/07-ui-text.md b/_docs/07-ui-text.md deleted file mode 100644 index ea5b6bc..0000000 --- a/_docs/07-ui-text.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: "UI Text" -permalink: /docs/ui-text/ -excerpt: "Text for customizing various user interface elements found in the theme." -modified: 2016-04-27T10:35:05-04:00 ---- - -{% include base_path %} - -Text for various UI elements, `_layouts`, and `_includes` have all been grouped together as a set of translation keys. This is by no means a full-on i18n solution, but it does help make customizing things a bit easier. - -Currently all of the keys in `_data/ui-text.yml` are English only[^yaml-anchors]. If you're are interested in localizing them into other languages feel free to submit a pull request and I will be happy to look it over. - -[^yaml-anchors]: `en-US`, and `en-GB` use [YAML anchors](http://www.yaml.org/spec/1.2/spec.html#id2785586) to reference the values in `en` as to not repeat them. - -Many of the label based keys like `meta_label`, `categories_label`, `tags_label`, `share_on_label`, and `follow_label` can be left blank if you'd like to omit them from view. It really depends on you and if you want an even more minimal look to your site. - -![UI text labels]({{ base_path }}/images/mm-ui-text-labels.jpg) - -**Note:** The theme comes with localized text in English (`en`, `en-US`, `en-GB`). If you change `locale` in `_config.yml` to something else, most of the UI text will go blank. Be sure to add the corresponding locale key and translated text to `_data/ui-text.yml` to avoid this. -{: .notice--warning} \ No newline at end of file diff --git a/_docs/08-authors.md b/_docs/08-authors.md deleted file mode 100644 index ae94809..0000000 --- a/_docs/08-authors.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Authors" -permalink: /docs/authors/ -excerpt: "Instructions and settings for working with multiple site authors." -modified: 2016-04-13T15:54:02-04:00 ---- - -{% include base_path %} - -Sites that may have content authored from various individuals can be accommodated by using [data files](https://jekyllrb.com/docs/datafiles/). - -To assign an author to a post or page that is different from the site author specified in `_config.yml`: - -**Step 1.** Create `_data/authors.yml` and add authors using the following format. Any variables found under `author:` in `_config.yml` can be used (e.g. `name`, `avatar`, `uri`, social media profiles, etc.). - -```yaml -# /_data/authors.yml - -Billy Rick: - name: "Billy Rick" - uri: "http://thewhip.com" - email: "billy@rick.com" - bio: "What do you want, jewels? I am a very extravagant man." - avatar: "bio-photo-2.jpg" - twitter: "extravagantman" - -Cornelius Fiddlebone: - name: "Cornelius Fiddlebone" - email: "cornelius@thewhip.com" - bio: "I ordered what?" - avatar: "bio-photo.jpg" - twitter: "rhymeswithsackit" -``` - -**Step 2.** Assign one of the authors in `authors.yml` to a post or page you wish to override the `site.author` with. - -Example: To assign `Billy Rick` as an author for a post the following YAML Front Matter would be applied: - -```yaml -author: Billy Rick -``` diff --git a/_docs/09-layouts.md b/_docs/09-layouts.md deleted file mode 100644 index 3fc7b7e..0000000 --- a/_docs/09-layouts.md +++ /dev/null @@ -1,453 +0,0 @@ ---- -title: "Layouts" -permalink: /docs/layouts/ -excerpt: "Descriptions and samples of all layouts included with the theme and how to best use them." -single_layout_gallery: - - image_path: mm-layout-single-header.png - alt: "single layout with header example" - - image_path: mm-layout-single-meta.png - alt: "single layout with comments and related posts" -modified: 2016-07-08T10:48:34-04:00 ---- - -{% include base_path %} -{% include toc icon="columns" title="Included Layouts" %} - -The bread and butter of any theme. Below you'll find the layouts included with Minimal Mistakes, what they look like and the type of content they've been built for. - -## Default Layout - -The base layout all other layouts inherit from. There's not much to this layout apart from pulling in several `_includes`: - -* `<head>` elements -* masthead navigation links -* {% raw %}`{{ content }}`{% endraw %} -* page footer -* scripts - -**Note:** You won't ever assign this layout directly to a post or page. Instead all other layouts will build off of it by setting `layout: default` in their YAML Front Matter. -{: .notice--warning} - -## Compress Layout - -A Jekyll layout that compresses HTML in pure Liquid. - -* [Documentation](http://jch.penibelst.de/) - -## Single Layout - -The layout you'll likely use the most --- sidebar and main content combo. - -**Includes:** - -* Optional header image with caption -* Optional header overlay (solid color/image) + text and optional "call to action" button -* Optional social sharing links module -* Optional comments module -* Optional related posts module - -{% include gallery id="single_layout_gallery" caption="Image header and meta info examples for `single` layout" %} - -Assign with `layout: single`, or better yet apply as a [Front Matter default]({{ base_path }}/docs/configuration/#front-matter-defaults) in `_config.yml`. - -## Archive Layout - -Essentially the same as `single` with markup adjustments and some modules removed. - -**Includes:** - -* Optional header image with caption -* Optional header overlay (solid color/image) + text and optional "call to action" button -* List and grid views - -<figure> - <img src="{{ base_path }}/images/mm-layout-archive.png" alt="archive layout example"> - <figcaption>List view example.</figcaption> -</figure> - -Below are sample archive pages you can easily drop into your project, taking care to rename `permalink`, `title`, or the filename to fit your site. Each is 100% compatible with GitHub Pages. - -* [All Posts Grouped by Category -- List View][posts-categories] -* [All Posts Grouped by Tags -- List View][posts-tags] -* [All Posts Grouped by Year -- List View][posts-year] -* [All Posts Grouped by Collection -- List View][posts-collection] -* [Portfolio Collection -- Grid View][portfolio-collection] - -[posts-categories]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/category-archive.html -[posts-tags]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/tag-archive.html -[posts-year]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/year-archive.html -[posts-collection]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/collection-archive.html -[portfolio-collection]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/portfolio-archive.html - -Post and page excerpts are auto-generated by Jekyll which grabs the first paragraph of text. To override this text with something more specific use the following YAML Front Matter: - -```yaml -excerpt: "A unique line of text to describe this post that will display in an archive listing and meta description with SEO benefits." -``` - -### Grid View - -Adding `type=grid` to the `archive-single` helper will display archive posts in a 4 column grid. For example to create an archive displaying all documents in the portfolio collection: - -**Step 1:** Create a portfolio archive page (eg. `_pages/portfolio-archive.html`) with the following YAML Front Matter: - -```yaml ---- -layout: archive -title: "Portfolio" -permalink: /portfolio/ -author_profile: false ---- -``` - -**Step 2:** Loop over all documents in the portfolio collection and output in a grid: - -```html -{% raw %}{% include base_path %} - -<div class="grid__wrapper"> - {% for post in site.portfolio %} - {% include archive-single.html type="grid" %} - {% endfor %}{% endraw %} -</div> -``` - -To produce something like this: - -<figure> - <img src="{{ base_path }}/images/mm-archive-grid-view-example.jpg" alt="archive grid view example"> - <figcaption>Grid view example.</figcaption> -</figure> - -**Note:** More information on using this `_include` can be found under [**Helpers**]({{ base_path }}/docs/helpers/). -{: .notice--info} - -### Taxonomy Archive - -If you have the luxury of using Jekyll plugins the creation of category and tag archives is greatly simplified. Enable support for the [`jekyll-archives`](https://github.com/jekyll/jekyll-archives) plugin with a few `_config.yml` settings as noted in the [**Configuration**]({{ base_path }}/docs/configuration/#archive-settings) section. - -![archive taxonomy layout example]({{ base_path }}/images/mm-layout-archive-taxonomy.png) - -### Home Page - -Minimal Mistakes ships with an [`index.html`](https://github.com/{{ site.repository }}/blob/master/index.html) in the root of the project for displaying recent posts. - -**Includes:** - -* Optional header image with caption -* Optional header overlay (solid color/image) + text and optional "call to action" button -* Paginated posts - -Post pagination is achieved by assigning `layout: archive` in the YAML Front Matter and including the following Liquid in the body: - -```html -{% raw %}<!-- start index.html body --> -{% include base_path %} - -<h3 class="archive__subtitle">Recent Posts</h3> - -{% for post in paginator.posts %} - {% include archive-single.html %} -{% endfor %} - -{% include paginator.html %} -<!-- end index.html body -->{% endraw %} -``` - -<figure> - <img src="{{ base_path }}/images/mm-home-post-pagination-example.jpg" alt="home page post pagination example"> - <figcaption>Home page post pagination example.</figcaption> -</figure> - -**Note:** For more pagination related settings check the [**Configuration**]({{ base_path }}/docs/configuration/#paginate) section. -{: .notice--info} - -## Splash Page Layout - -For full-width landing pages that need a little something extra add `layout: splash` to the YAML Front Matter. - -**Includes:** - -* Optional header image with caption -* Optional header overlay (solid color/image) + text and optional "call to action" button -* Feature blocks (`left`, `center`, and `right` alignment options) - -![splash page layout example]({{ base_path }}/images/mm-layout-splash.png) - -Feature blocks can be assigned and aligned to the `left`, `right`, or `center` with a sprinkling of YAML. For full details on how to use the `feature_row` helper check the [**Content**]({{ base_path }}/docs/helpers/) section or review a [sample splash page](https://github.com/{{ site.repository }}/blob/gh-pages/_pages/splash-page.md). - - ---- - -## Headers - -To add some visual punch to a post or page, a large full-width header image can be included. - -**Note:** Be sure to resize your header images. `~1280px` is a good width if you aren't [responsively serving up images](http://alistapart.com/article/responsive-images-in-practice). Through the magic of CSS they will scale up or down to fill the container. If you go with something too small it will look like garbage when upscaled, and something too large will hurt performance. -{: .notice--warning} - -![single layout header image example]({{ base_path }}/images/mm-single-header-example.jpg) - -Place your images in the `/images/` folder and add the following YAML Front Matter: - -```yaml -header: - image: image-filename.jpg -``` - -For externally hosted images include the full image path instead of just the filename: - -```yaml -header: - image: http://some-site.com/image.jpg -``` - -To include a caption or attribution for the image: - -```yaml -header: - image: unsplash-image-1.jpg - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" -``` - -**ProTip:** Captions written in Markdown are supported, so feel free to add links, or style text. Just be sure to wrap it in quotes. -{: .notice--info} - -### Header Overlay - -To overlay text on top of a header image you have a few more options: - -| Name | Description | Default | -| ---- | ----------- | ------- | -| **overlay_image** | Header image you'd like to overlay. Same rules as `header.image` from above. | | -| **overlay_filter** | Color/opacity to overlay on top of the header image eg: `0.5` or `rgba(255, 0, 0, 0.5)`. | -| **excerpt** | Auto-generated page excerpt is added to the overlay text or can be overridden. | | -| **cta_label** | Call to action button text label. | `more_label` in UI Text data file | -| **cta_url** | Call to action button URL. | | - -With this YAML Front Matter: - -```yaml -excerpt: "This post should display a **header with an overlay image**, if the theme supports it." -header: - overlay_image: unsplash-image-1.jpg - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" - cta_label: "More Info" - cta_url: "https://unsplash.com" -``` - -You'd get a header image overlaid with text and a call to action button like this: - -![single layout header overlay example]({{ base_path }}/images/mm-single-header-overlay-example.jpg) - -You also have the option of specifying a solid background-color to use instead of an image. - -![single layout header overlay with background fill]({{ base_path }}/images/mm-single-header-overlay-fill-example.jpg) - -```yaml -excerpt: "This post should display a **header with a solid background color**, if the theme supports it." -header: - overlay_color: "#333" -``` - -You can also specifying the opacity (between `0` and `1`) of a black overlay like so: - -![transparent black overlay]({{ base_path }}/images/mm-header-overlay-black-filter.jpg) - -```yaml -excerpt: "This post should [...]" -header: - overlay_image: unsplash-image-1.jpg - overlay_filter: 0.5 # same as adding an opacity of 0.5 to a black background - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" - cta_label: "More Info" - cta_url: "https://unsplash.com" -``` - -Or if you want to do more fancy things, go full rgba: - -![transparent red overlay]({{ base_path }}/images/mm-header-overlay-red-filter.jpg) - -```yaml -excerpt: "This post should [...]" -header: - overlay_image: unsplash-image-1.jpg - overlay_filter: rgba(255, 0, 0, 0.5) - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" - cta_label: "More Info" - cta_url: "https://unsplash.com" -``` - ---- - -## Sidebars - -The space to the left of a page's main content is blank by default, but has the ability to show an author profile (name, short biography, social media links), custom content, or both. - -### Author Profile - -Add `author_profile: true` to a post or page's YAML Front Matter. - -![single layout example]({{ base_path }}/images/mm-layout-single.png) - -Better yet, enable it with Front Matter Defaults set in `_config.yml`. - -```yaml -defaults: - # _posts - - scope: - path: "" - type: posts - values: - author_profile: true -``` - -**Note:** To disable the author sidebar profile for a specific post or page, add `author_profile: false` to the YAML Front Matter instead. -{: .notice--warning} - -The theme comes pre-built with a selection of links for the most common social media networks. These are all optional and can be [assigned in `_config.yml`]({{ base_path }}/docs/configuration/). - -To add more links you'll need to crack open [`_includes/author-profile.html`](https://github.com/mmistakes/minimal-mistakes/blob/master/_includes/author-profile.html) and make some edits. - -Inside of `<ul class="author__urls">` you'll find `<li>` elements wrapped in Liquid conditionals. These represent each of the possible links you can currently add to the sidebar. - -#### Example of Twitter link - -```html -{% raw %}{% if author.twitter %} - <li><a href="https://twitter.com/{{ author.twitter }}"><i class="fa fa-fw fa-twitter-square" aria-hidden="true"></i> Twitter</a></li> -{% endif %}{% endraw %} -``` - -To add a new link you'll need three things: - -1. Destination URL -2. [Font Awesome icon](http://fontawesome.io/icons/) (`fa-` class) -3. Label for the link - -It's up to you if you want to wrap it in a `{% raw %}{% if %} ... {% endif %}{% endraw %}`conditional and add variables to `_config.yml`. If you don't plan to change it then hard-coding the strings is perfectly acceptable. - -Let's run through how you'd add a new link that points to a Reddit profile. Starting with the three things from above: - -1. `https://www.reddit.com/user/username` -2. [`fa-reddit`](http://fontawesome.io/icon/reddit/) -3. `Reddit` - -And plug them into the appropriate locations: - -```html -<li><a href="[1]"><i class="fa fa-fw [2]" aria-hidden="true"></i> [3]</a></li> -``` - -To end up with: - -```html -<li><a href="https://www.reddit.com/user/username"><i class="fa fa-fw fa-reddit" aria-hidden="true"></i> Reddit</a></li> -``` - -![Reddit link in author profile]({{ base_path }}/images/mm-author-profile-reddit-gs.png) - -To add a touch of color to the default black (`#000`) icon a few more steps are necessary. - -Start by opening `/assets/_scss/_utilities.scss` to the icon section (it's near the bottom). You'll want to nest a new class beneath `.social-icons` that matches the one used to declare the Font Awesome icon. In our case `.fa-reddit`. - -Simply add a `color` declaration and the corresponding hex code and recompile `main.css` following the steps outlined in the [stylesheet documentation]({{ base_path }}/docs/stylesheets/). - -```scss -.social-icons { - - .fa-reddit { - color: #ff4500; - } -} -``` - -![Reddit link in author profile with color]({{ base_path }}/images/mm-author-profile-reddit-color.png) - -**ProTip:** For bonus points you can add it as a Sass `$variable` that you set in `_variables.scss` like the other ["brand" colors](http://brandcolors.net/). -{: .notice--info} - -**Please please please** don't submit [pull requests]({{ base_path }}/docs/contributing/) adding in support for "missing" social media links. I'm trying to keep things down to the minimum (hence the theme's name) and have no interest in merging such PRs :expressionless:. -{: .notice--warning} - -### Custom Sidebar Content - -Blocks of content can be added by using the following under `sidebar`: - -| Name | Description | -| ---- | ----------- | -| **title** | Title or heading. | -| **image** | Image path placed in `/images/` folder or an external URL. | -| **image_alt** | Alternate description for image. | -| **text** | Text. Markdown is allowed. | - -Multiple blocks can also be added by following the example below: - -```yaml -sidebar: - - title: "Title" - image: http://placehold.it/350x250 - image_alt: "image" - text: "Some text here." - - title: "Another Title" - text: "More text here." -``` - -<figure> - <img src="{{ base_path }}/images/mm-custom-sidebar-example.jpg" alt="custom sidebar content example"> - <figcaption>Example of custom sidebar content added as YAML Front Matter.</figcaption> -</figure> - -**Note:** Custom sidebar content added to a post or page's YAML Front Matter will appear below the author profile if enabled with `author_profile: true`. -{: .notice--info} - ---- - -## Social Sharing Links - -The `single` layout has an option to enable social links at the bottom of posts for sharing on Twitter, Facebook, Google+, and LinkedIn. Similar to the links found in the author sidebar, the theme ships with defaults for the most common social networks. - -![default social share link buttons]({{ base_path }}/images/mm-social-share-links-default.png) - -To enable these links add `share: true` to a post or page's YAML Front Matter or use a [default](https://jekyllrb.com/docs/configuration/#front-matter-defaults) in your `_config.yml` to apply more globally. - -If you'd like to add, remove, or change the order of these default links you can do so by editing [`_includes/social-share.html`](https://github.com/mmistakes/minimal-mistakes/blob/master/_includes/social-share.html). - -Let's say you wanted to replace the Google+ button with a Reddit one. Simply replace the HTML with the following: - -```html -{% raw %}<a href="https://www.reddit.com/submit?url={{ base_path }}{{ page.url }}&title={{ page.title }}" class="btn" title="{{ site.data.ui-text[site.locale].share_on_label }} Reddit"><i class="fa fa-fw fa-reddit" aria-hidden="true"></i><span> Reddit</span></a>{% endraw %} -``` - -The important parts to change are: - -1. Share point URL *eg. `https://www.reddit.com/submit?url=` -2. Link `title` -3. [Font Awesome icon](http://fontawesome.io/icons/) (`fa-` class) -4. Link label - -![Reddit social share link button]({{ base_path }}/images/mm-social-share-links-reddit-gs.png) - -To change the color of the button use one of the built in [utility classes]({{ base_path }}/docs/utility-classes/#buttons). Or you can create a new button class to match whatever color you want. - -Under the `$social` color map in `assets/_scss/_buttons.scss` simply add a name (this will be appened to `btn--`) that matches the new button class. In our case `reddit` ~> `.btn--reddit`. - -```scss -$social: -(facebook, $facebook-color), -(twitter, $twitter-color), -(google-plus, $google-plus-color), -(linkedin, $linkedin-color); -(reddit, #ff4500;) -``` - -**ProTip:** For bonus points you can add it as a Sass `$variable` that you set in `_variables.scss` like the other ["brand" colors](http://brandcolors.net/). -{: .notice--info} - -Add the new `.btn--reddit` class to the `<a>` element from earlier, [compile `main.css`]({{ base_path }}/docs/stylesheets/) and away you go. - -```html -{% raw %}<a href="https://www.reddit.com/submit?url={{ base_path }}{{ page.url }}&title={{ page.title }}" class="btn btn--reddit" title="{{ site.data.ui-text[site.locale].share_on_label }} Reddit"><i class="fa fa-fw fa-reddit" aria-hidden="true"></i><span> Reddit</span></a>{% endraw %} -``` - -![Reddit social share link button]({{ base_path }}/images/mm-social-share-links-reddit-color.png) \ No newline at end of file diff --git a/_docs/10-posts.md b/_docs/10-posts.md deleted file mode 100644 index 9e543ba..0000000 --- a/_docs/10-posts.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: "Working with Posts" -permalink: /docs/posts/ -excerpt: "Suggestions and Front Matter defaults for working with posts." -modified: 2016-07-20T08:17:57-04:00 ---- - -{% include base_path %} - -Posts are stored in the `_posts` directory and named according to the `YEAR-MONTH-DAY-title.MARKUP` format as per [the usual](https://jekyllrb.com/docs/posts/). - -Where `YEAR` is a four-digit number, `MONTH` and `DAY` are both two-digit numbers, and `MARKUP` is the file extension representing the format used in the file. For example, the following are examples of valid post filenames: - -``` -2016-07-20-writing-jekyll-posts.md -2015-01-03-static-site-generators.markdown -``` - -**Recommended Front Matter Defaults:** - -```yaml -defaults: - # _posts - - scope: - path: "" - type: posts - values: - layout: single - author_profile: true - read_time: true - comments: true - share: true - related: true -``` - -Adding the above to `_config.yml` will assign the `single` layout and enable: *author profile*, *reading time*, *comments*, [*social sharing links*]({{ base_path }}/docs/layouts/#social-sharing-links), and *related posts*, for all posts. - -**ProTip:** Remember to write unique `excerpt` descriptions for each post for improved SEO and archive listings. -{: .notice--info} \ No newline at end of file diff --git a/_docs/11-pages.md b/_docs/11-pages.md deleted file mode 100644 index 3ca4b4d..0000000 --- a/_docs/11-pages.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: "Working with Pages" -permalink: /docs/pages/ -excerpt: "Suggestions and Front Matter defaults for working with pages." -modified: 2016-04-13T15:54:02-04:00 ---- - -{% include base_path %} - -To better organize all of your pages you can centralize them into a single location similar to posts and collections. - -**Step 1:** Start by placing pages (`.md` or `.html` files) into a `_pages` directory. Meaningfully naming files should be the goal. Avoid patterns like `/about/index.md` as it makes distinguishing between multiple `index.md` files harder. - -```bash -sample-project -└── _pages/ - ├── 404.md # custom 404 page - ├── about.md # about page - └── contact.md # contact page -``` - -**Step 2:** Include pages to be sure Jekyll "sees" and processes the files inside of `_pages`. Add `include: ["_pages"]` to `_config.yml`. - -**Step 3:** Assign permalink overrides in the YAML Front Matter of each. - -Examples: - -| filename | permalink | -| -------- | --------- | -| _pages/about.md | `permalink: /about/` | -| _pages/home.md | `permalink: /` | -| _pages/contact.md | `permalink: /contact/` | - -**Recommended Front Matter Defaults:** - -```yaml -defaults: - # _pages - - scope: - path: "" - type: pages - values: - layout: single - author_profile: true -``` \ No newline at end of file diff --git a/_docs/12-collections.md b/_docs/12-collections.md deleted file mode 100644 index a846c2d..0000000 --- a/_docs/12-collections.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: "Working with Collections" -permalink: /docs/collections/ -excerpt: "Suggestions and Front Matter defaults for working with collections." -modified: 2016-04-13T15:54:02-04:00 ---- - -{% include base_path %} - -Collections like posts and pages work as you'd expect. If you're new to them be sure to read [Jekyll's documentation](https://jekyllrb.com/docs/collections/). - -The theme has been built with collections in mind and you will find [several examples]({{ base_path }}/collection-archive/) on the demo site ([portfolio]({{ base_path }}/portfolio/), [recipes]({{ base_path }}/recipes/), pets). - -**Collections in the Wild:** This set of documentation is also [built as a collection](https://github.com/{{ site.repository }}/blob/gh-pages/_docs/) if you're looking for a fully fleshed out example to inspect. -{: .notice--info} - ---- - -A popular use case for collections is to build a portfolio section as part of one's personal site. Let's quickly walk through the steps to do that. - -**Step 1:** Configure the portfolio collection by adding the following to `_config.yml`. - -```yaml -collections: - portfolio: - output: true - permalink: /:collection/:path/ -``` - -These settings essentially say output `index.html` files for each portfolio document in `_portfolio` at `_site/portfolio/<document-filename>/`. - -Just like posts and pages you'll probably want to set some defaults for the Front Matter: - -```yaml -defaults: - # _portfolio - - scope: - path: "" - type: portfolio - values: - layout: single - author_profile: false - share: true -``` - -And then create portfolio content like [`_portfolio/foo-bar-website.md`](https://github.com/{{ site.repository }}/blob/gh-pages/_portfolio/foo-bar-website.md), to end up with something like this. - -![portfolio collection example]({{ base_path }}/images/mm-portfolio-collection-example.jpg) \ No newline at end of file diff --git a/_docs/13-helpers.md b/_docs/13-helpers.md deleted file mode 100644 index 2e0450b..0000000 --- a/_docs/13-helpers.md +++ /dev/null @@ -1,255 +0,0 @@ ---- -title: "Helpers" -permalink: /docs/helpers/ -excerpt: "Jekyll `_includes` and other helpers to use as shortcuts for creating archives, galleries, table of contents, and more." -gallery: - - url: unsplash-gallery-image-1.jpg - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 1" - title: "Image 1 title caption" - - url: unsplash-gallery-image-2.jpg - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 2" - title: "Image 2 title caption" - - url: unsplash-gallery-image-3.jpg - image_path: unsplash-gallery-image-3-th.jpg - alt: "placeholder image 3" - title: "Image 3 title caption" -feature_row: - - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 1" - title: "Placeholder 1" - excerpt: "This is some sample content that goes here with **Markdown** formatting." - - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 2" - title: "Placeholder 2" - excerpt: "This is some sample content that goes here with **Markdown** formatting." - url: "#test-link" - btn_label: "Read More" - btn_class: "btn--inverse" - - image_path: unsplash-gallery-image-3-th.jpg - title: "Placeholder 3" - excerpt: "This is some sample content that goes here with **Markdown** formatting." -modified: 2016-06-01 ---- - -{% include base_path %} -{% include toc icon="gears" title="Helpers" %} - -You can think of these Jekyll helpers as little shortcuts. Since GitHub Pages doesn't allow most plugins --- [custom tags](https://jekyllrb.com/docs/plugins/#tags) are out. Instead the theme leverages [**includes**](https://jekyllrb.com/docs/templates/#includes) to do something similar. - -## Base Path - -Instead of repeating `{% raw %}{{ site.url }}{{ site.baseurl }}{% endraw %}` over and over again to create absolute URLs, you can use `{% raw %}{{ base_path }}{% endraw %}` instead. Simply add `{% raw %}{% include base_path %}{% endraw %}` to layouts, posts, pages, collections, or other includes and you're good to go. - -**ProTip:** It's a good practice to prepend all assets links (especially post images) with `{% raw %}{{ base_path }}{% endraw %}` so they correctly resolve in the site's XML feeds. -{: .notice--info} - -## Group by Array - -[Jekyll Group-By-Array](https://github.com/mushishi78/jekyll-group-by-array) by Max White. - - A liquid include file for Jekyll that allows an object to be grouped by an array. - -The Liquid based taxonomy archives found amongst the demo pages rely on this helper. - -| Description | | | -| ----------- | ------------------------ | --------------------------- | -| All posts grouped by category | [Source][category-array] | [Demo][category-array-demo] | -| All posts grouped by tags | [Source][tag-array] | [Demo][tag-array-demo] | - -[category-array]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/category-archive.html -[category-array-demo]: {{ base_path }}/categories/ -[tag-array]: https://github.com/{{ site.repository }}/blob/gh-pages/_pages/tag-archive.html -[tag-array-demo]: {{ base_path }}/tags/ - -## Gallery - -Generate a `<figure>` element with optional caption of arrays with two or more images. - -To place a gallery add the necessary YAML Front Matter. - -| Name | Required | Description | -| ---- | -------- | ----------- | -| **url** | Optional | URL to link gallery image to (eg. a larger detail image). | -| **image_path** | **Required** | For images placed in the `/images/` directory just add the filename and extension. Use absolute URLS for those hosted externally. | -| **alt** | Optional | Alternate text for image. | -| **title** | Optional | Title text for image. Will display as a caption in a Magnific Popup overlay when linked to a larger image with `url`. | - -```yaml -gallery: - - url: unsplash-gallery-image-1.jpg - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 1" - title: "Image 1 title caption" - - url: unsplash-gallery-image-2.jpg - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 2" - title: "Image 2 title caption" - - url: unsplash-gallery-image-3.jpg - image_path: unsplash-gallery-image-3-th.jpg - alt: "placeholder image 3" - title: "Image 3 title caption" -``` - -And then drop-in the gallery include in the body where you'd like it to appear. - -| Include Parameter | Required | Description | Default | -| ----------------- | -------- | ----------- | ------- | -| **id** | Optional | To add multiple galleries to a document uniquely name them in the YAML Front Matter and reference in `{% raw %}{% include gallery id="gallery_id" %}{% endraw %}` | `gallery` | -| **class** | Optional | Use to add a `class` attribute to the surrounding `<figure>` element for additional styling needs. | | -| **caption** | Optional | Gallery caption description. Markdown is allowed. | | - -```liquid -{% raw %}{% include gallery caption="This is a sample gallery with **Markdown support**." %}{% endraw %} -``` - -**Gallery example with caption:** - -{% include gallery caption="This is a sample gallery with **Markdown support**." %} - -**More Gallery Goodness:** A few more examples and [source code](https://github.com/{{ site.repository }}/blob/gh-pages/_posts/2010-09-09-post-gallery.md) can be seen in [this sample gallery post]({{ base_path }}{% post_url 2010-09-09-post-gallery %}). -{: .notice--info} - -## Feature Row - -Designed to compliment the [`splash`]({{ base_path }}/docs/layouts/#splash-page-layout) page layout as a way of arranging and aligning "feature blocks" containing text or image. - -To add a feature row containing three content blocks with text and image, add the following YAML Front Matter - -| Name | Required | Description | Default | -| ---- | ----------- | ----------- | ------- | -| **image_path** | **Required** | For images placed in the `/images/` directory just add the filename and extension. Use absolute URLS for those hosted externally. | | -| **alt** | Optional | Alternate text for image. | | -| **title** | Optional | Content block title. | | -| **excerpt** | Optional | Content block excerpt text. Markdown is allowed. | | -| **url** | Optional | URL that the button should link to. | | -| **btn_label** | Optional | Button text label. | `more_label` in UI Text data file. | -| **btn_class** | Optional | Button style. See [utility classes]({{ base_path }}/docs/utility-classes/#buttons) for options. | `btn` | - -```yaml -feature_row: - - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 1" - title: "Placeholder 1" - excerpt: "This is some sample content that goes here with **Markdown** formatting." - - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 2" - title: "Placeholder 2" - excerpt: "This is some sample content that goes here with **Markdown** formatting." - url: "#test-link" - btn_label: "Read More" - btn_class: "btn--inverse" - - image_path: unsplash-gallery-image-3-th.jpg - title: "Placeholder 3" - excerpt: "This is some sample content that goes here with **Markdown** formatting." -``` - -And then drop-in the feature row include in the body where you'd like it to appear. - -| Include Parameter | Required | Description | Default | -| ----------------- | -------- | ----------- | ------- | -| **id** | Optional | To add multiple rows to a document uniquely name them in the YAML Front Matter and reference in `{% raw %}{% include feature_row id="row2" %}{% endraw %}` | `feature_row` | -| **type** | Optional | Alignment of the featured blocks in the row. Options include: `left`, `center`, or `right` aligned. | | - -```liquid -{% raw %}{% include feature_row %}{% endraw %} -``` - -{% include feature_row %} - -**More Feature Row Goodness:** A [few more examples]({{ base_path }}/splash-page/) and [source code](https://github.com/{{ site.repository }}/blob/gh-pages/_pages/splash-page.md) can be seen in the demo site. -{: .notice--info} - -## Table of Contents - -To include an [auto-generated table of contents](http://kramdown.rubyforge.org/converter/html.html#toc) for posts and pages, add the following helper before any actual content in your post or page. - -```liquid -{% raw %}{% include toc %}{% endraw %} -``` - -![table of contents example]({{ base_path }}/images/mm-toc-helper-example.jpg) - -| Parameter | Required | Description | Default | -| --------- | -------- | ----------- | ------- | -| **title** | Optional | Table of contents title. | `toc_label` in UI Text data file. | -| **icon** | Optional | Table of contents icon (shows before the title). | [Font Awesome](https://fortawesome.github.io/Font-Awesome/icons/) <i class="fa fa-file-text"></i> **file-text** icon. Any other FA icon can be used instead. | - -**TOC example with custom title and icon** - -```liquid -{% raw %}{% include toc icon="gears" title="My Table of Contents" %}{% endraw %} -``` - -## Navigation List - -Include an unordered list of links to be used as sidebar navigation with the `nav_list` helper. - -**1.** Start by adding a set of titles and URLs to `_data/navigation.yml` in the same way the [`main` navigation]({{ base_path }}/docs/navigation/) is built. - -`foo` navigation example: - -```yaml -# _data/navigation.yml -foo: - - title: "Link 1 Title" - url: /link-1-page-url/ - - - title: "Link 2 Title" - url: http://external-link.com - - - title: "Link 3 Title" - url: /link-3-page-url/ - - - title: "Link 4 Title" - url: /link-4-page-url/ -``` - -For a navigation list that has child pages you'd structure the YAML like this: - -```yaml -# _data/navigation.yml -foo: - - title: "Parent Link 1" - url: /parent-1-page-url/ - children: - - title: "Child Link 1" - url: /child-1-page-url/ - - title: "Child Link 2" - url: /child-2-page-url/ - - - title: "Parent Link 2" - url: /parent-2-page-url/ - children: - - title: "Child Link 1" - url: /child-1-page-url/ - - title: "Child Link 2" - url: /child-2-page-url/ - - title: "Child Link 3" - url: /child-3-page-url/ -``` - -**2:** On the page(s) you'd like the `foo` sidebar nav add the following YAML Front Matter, referencing the same key name. - -```yaml -sidebar: - nav: "foo" -``` - -**ProTip:** If you're applying the same navigation list to several pages setting it as a [Front Matter default](https://jekyllrb.com/docs/configuration/#front-matter-defaults) is the better option. -{: .notice--info} - -The theme's documentation is built with the `nav_list` helper so if you'd like an example to dissect take a look at `navigation.yml`, `_config.yml` and `_doc/` in the [`gh-pages` branch](https://github.com/{{ site.repository }}/tree/gh-pages/) of this repo. - -To add a navigation list to a post or page's main content instead of the sidebar use the include this way: - -```liquid -{% raw %}{% include nav_list nav="foo" %}{% endraw %} -``` - -{% include nav_list nav="foo" %} - -| Parameter | Required | Description | -| --------- | -------- | ----------- | -| items | **Required** | Name of the links array found in `_data/navigation.yml`. | \ No newline at end of file diff --git a/_docs/14-utility-classes.md b/_docs/14-utility-classes.md deleted file mode 100644 index f4cb7b1..0000000 --- a/_docs/14-utility-classes.md +++ /dev/null @@ -1,176 +0,0 @@ ---- -title: "Utility Classes" -permalink: /docs/utility-classes/ -excerpt: "CSS classes for aligning text/image, styling buttons and notices, and more." -modified: 2016-04-13T15:54:02-04:00 ---- - -{% include base_path %} -{% include toc icon="gears" title="Utility Classes" %} - -Using the Kramdown Markdown renderer with Jekyll allows you to add [block](http://kramdown.gettalong.org/quickref.html#block-attributes) and [inline attributes](http://kramdown.gettalong.org/quickref.html#inline-attributes). This is nice if you want to add custom styling to text and image, and still write in Markdown. - -**Jekyll 3:** Kramdown is the default for `jekyll new` sites and those hosted on GitHub Pages. Not using Kramdonw? That's OK. The following classes are still available when used with standard HTML. -{: .notice--warning} - -## Text Alignment - -Align text blocks with the following classes. - -Left aligned text `.text-left` -{: .text-left} - -```markdown -Left aligned text -{: .text-left} -``` - ---- - -Center aligned text. `.text-center` -{: .text-center} - -```markdown -Center aligned text. -{: .text-center} -``` - ---- - -Right aligned text. `.text-right` -{: .text-right} - -```markdown -Right aligned text. -{: .text-right} -``` - ---- - -**Justified text.** `.text-justify` Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque vel eleifend odio, eu elementum purus. In hac habitasse platea dictumst. Fusce sed sapien eleifend, sollicitudin neque non, faucibus est. Proin tempus nisi eu arcu facilisis, eget venenatis eros consequat. -{: .text-justify} - -```markdown -Justified text. -{: .text-justify} -``` - ---- - -No wrap text. `.text-nowrap` -{: .text-nowrap} - -```markdown -No wrap text. -{: .text-nowrap} -``` - -## Image Alignment - -Position images with the following classes. - -![image-center]({{ site.url }}{{ site.baseurl }}/images/image-alignment-580x300.jpg){: .align-center} - -The image above happens to be **centered**. - -```markdown -![image-center](/images/filename.jpg){: .align-center} -``` - ---- - -![image-left]({{ site.url }}{{ site.baseurl }}/images/image-alignment-150x150.jpg){: .align-left} The rest of this paragraph is filler for the sake of seeing the text wrap around the 150×150 image, which is **left aligned**. There should be plenty of room above, below, and to the right of the image. Just look at him there --- Hey guy! Way to rock that left side. I don't care what the right aligned image says, you look great. Don't let anyone else tell you differently. - -```markdown -![image-left](/images/filename.jpg){: .align-left} -``` - ---- - -![image-right]({{ site.url }}{{ site.baseurl }}/images/image-alignment-300x200.jpg){: .align-right} - -And now we're going to shift things to the **right align**. Again, there should be plenty of room above, below, and to the left of the image. Just look at him there --- Hey guy! Way to rock that right side. I don't care what the left aligned image says, you look great. Don't let anyone else tell you differently. - -```markdown -![image-right](/images/filename.jpg){: .align-right} -``` - ---- - -![full]({{ site.url }}{{ site.baseurl }}/images/image-alignment-1200x4002.jpg) -{: .full} - -The image above should extend outside of the parent container on right. - -```markdown -![full](/images/filename.jpg) -{: .full} -``` - -## Buttons - -Make any link standout more when applying the `.btn` class. - -```html -<a href="#" class="btn">Link Text</a> -``` - -| Button Type | Example | Class | Kramdown | -| ------ | ------- | ----- | ------- | -| Default | [Text](#link){: .btn} | `.btn` | `[Text](#link){: .btn}` | -| Success | [Text](#link){: .btn .btn--success} | `.btn .btn--success` | `[Text](#link){: .btn .btn--success}` | -| Warning | [Text](#link){: .btn .btn--warning} | `.btn .btn--warning` | `[Text](#link){: .btn .btn--warning}` | -| Danger | [Text](#link){: .btn .btn--danger} | `.btn .btn--danger` | `[Text](#link){: .btn .btn--danger}` | -| Info | [Text](#link){: .btn .btn--info} | `.btn .btn--info` | `[Text](#link){: .btn .btn--info}` | -| Inverse | [Text](#link){: .btn .btn--inverse} | `.btn .btn--inverse` | `[Text](#link){: .btn .btn--inverse}` | -| Light Outline | [Text](#link){: .btn .btn--light-outline} | `.btn .btn--light-outline` | `[Text](#link){: .btn .btn--light-outline}` | - -| Button Size | Example | Class | Kramdown | -| ----------- | ------- | ----- | -------- | -| X-Large | [X-Large Button](#){: .btn .btn--x-large} | `.btn .btn--x-large` | `[Text](#link){: .btn .btn--x-large}` | -| Large | [Large Button](#){: .btn .btn--large} | `.btn .btn--large` | `[Text](#link){: .btn .btn--large}` | -| Default | [Default Button](#){: .btn} | `.btn` | `[Text](#link){: .btn}` | -| Small | [Small Button](#){: .btn .btn--small} | `.btn .btn--small` | `[Text](#link){: .btn .btn--small}` | - -## Notices - -Call attention to a block of text. - -| Notice Type | Class | -| ----------- | ----- | -| Default | `.notice` | -| Primary | `.notice--primary` | -| Info | `.notice--info` | -| Warning | `.notice--warning` | -| Success | `.notice--success` | -| Danger | `.notice--danger` | - -**Watch out!** This paragraph of text has been emphasized with the `{: .notice}` class. -{: .notice} - -**Watch out!** This paragraph of text has been emphasized with the `{: .notice--primary}` class. -{: .notice--primary} - -**Watch out!** This paragraph of text has been emphasized with the `{: .notice--info}` class. -{: .notice--info} - -**Watch out!** This paragraph of text has been emphasized with the `{: .notice--warning}` class. -{: .notice--warning} - -**Watch out!** This paragraph of text has been emphasized with the `{: .notice--success}` class. -{: .notice--success} - -**Watch out!** This paragraph of text has been emphasized with the `{: .notice--danger}` class. -{: .notice--danger} - -{% capture notice-text %} -You can also add the `.notice` class to a `<div>` element. - -* Bullet point 1 -* Bullet point 2 -{% endcapture %} - -<div class="notice--info"> - <h4>Notice Headline:</h4> - {{ notice-text | markdownify }} -</div> \ No newline at end of file diff --git a/_docs/15-stylesheets.md b/_docs/15-stylesheets.md deleted file mode 100644 index 8ad481d..0000000 --- a/_docs/15-stylesheets.md +++ /dev/null @@ -1,169 +0,0 @@ ---- -title: "Stylesheets" -permalink: /docs/stylesheets/ -excerpt: "Instructions for customizing and building the theme's stylesheets." -modified: 2016-04-14 ---- - -{% include base_path %} - -The theme's `main.css` stylesheet is built from several SCSS partials located in `/assets/_scss/` and are structured as follows: - -```bash -minimal mistakes -├── assets -| ├── _scss -| | ├── vendor # vendor SCSS partials -| | | ├── breakpoint # media query mixins -| | | ├── font-awesome # Font Awesome icons -| | | ├── magnific-popup # Magnific Popup lightbox -| | | └── susy # Susy grid system -| | ├── _animations.scss # animations -| | ├── _archive.scss # archives (list, grid, feature views) -| | ├── _base.scss # base HTML elements -| | ├── _buttons.scss # buttons -| | ├── _footer.scss # footer -| | ├── _masthead.scss # masthead -| | ├── _mixins.scss # mixins (em function, clearfix) -| | ├── _navigation.scss # nav links (breadcrumb, priority+, toc, pagination, etc.) -| | ├── _notices.scss # notices -| | ├── _page.scss # pages -| | ├── _print.scss # print styles -| | ├── _reset.scss # reset -| | ├── _sidebar.scss # sidebar -| | ├── _syntax.scss # syntax highlighting -| | ├── _tables.scss # tables -| | ├── _utilities.scss # utility classes (text/image alignment) -| | ├── _variables.scss # theme defaults (fonts, colors, etc.) -| | └── main.scss # all SCSS partials are imported here -| ├── css -| | └── main.css # compiled theme stylesheet -``` - -## Customizing - -The settings in `/assets/_scss/_variables.scss` can modify the following aspects of the theme: - -### Paragraph Indention - -To mimic the look of type set in a printed book or manuscript you may want to enable paragraph indention. When `$paragraph-indent` is set to `true` indents are added to each sibling and the margin below each paragraph is removed. - -<figure> - <img src="{{ base_path }}/images/mm-paragraph-indent-example.jpg" alt="indented paragraph example"> - <figcaption>Example of indented paragraphs.</figcaption> -</figure> - -The size of the indent can also be customized by changing the value of `$indent-var`. - -### Font Stacks - -By default the theme uses [system fonts](https://medium.com/designing-medium/system-shock-6b1dc6d6596f#.rb81vgn7i) for all of the font stacks (serif, sans-serif, and monospace). This is done in part to provide a clean base for you to build off of and to improve performance since we aren't loading any custom webfonts[^font-awesome] by default. - -```scss -/* system typefaces */ -$serif : Georgia, Times, serif; -$sans-serif : -apple-system, ".SFNSText-Regular", "San Francisco", "Roboto", "Segoe UI", "Helvetica Neue", "Lucida Grande", Arial, sans-serif; -$monospace : Monaco, Consolas, "Lucida Console", monospace; -``` - -[^font-awesome]: Apart from [Font Awesome](https://fortawesome.github.io/Font-Awesome/) icon webfonts. - -Sans-serif fonts have been used for most of the type, with serifs reserved for captions. If you wish to change this you'll need to poke around the various `SCSS` partials and modify `font-family` declarations. - -**ProTip:** To use webfonts from services like [Adobe TypeKit](https://typekit.com/) or [Google Fonts](https://www.google.com/fonts) simply update the font stacks and then add their scripts to `_includes/head/custom.html`. -{: .notice--info} - -#### Typography from Older Versions - -Not a fan of the refreshed typography of the theme and want to revert back an older version? Easy enough. - -**1.** Add this Google Fonts script to `_includes/head/custom.html`: - -```html -<link href="https://fonts.googleapis.com/css?family=PT+Sans+Narrow:400,700|PT+Serif:400,700,400italic" rel="stylesheet" type="text/css"> -``` - -**2.** Update the following variables in `assets/_scss/_variables.scss`: - -```scss -$serif : "PT Serif", Georgia, Times, serif; -$sans-serif-narrow : "PT Sans Narrow", $sans-serif; - -$global-font-family : $serif; -$header-font-family : $sans-serif-narrow; -``` - -**3.** Rebuild `main.css` by running `npm run build:css`. See below for more info on the build process. - -### Type Scale - -Wherever possible type scale variables have been used instead of writing out fixed sizes. This makes updating much easier by changing values in one file, `_variables.scss`. - -Example: - -```scss -.page__lead { - font-family: $global-font-family; - font-size: $type-size-4; -} -``` - -Type sizes are set in ems to proportional scale as the screen size changes. Large headlines that look great on desktop monitors will shrink ever so slightly as to not be too big on mobile devices. To adjust this hierarchy simply edit the default values: - -```scss -/* type scale */ -$type-size-1 : 2.441em; // ~39.056px -$type-size-2 : 1.953em; // ~31.248px -$type-size-3 : 1.563em; // ~25.008px -$type-size-4 : 1.25em; // ~20px -$type-size-5 : 1em; // ~16px -$type-size-6 : 0.75em; // ~12px -$type-size-7 : 0.6875em; // ~11px -$type-size-8 : 0.625em; // ~10px -``` - -### Colors - -Change the mood of your site by altering a few color variables. `$body-color`, `$background-color`, `$text-color`, `$link-color`, and `$masthead-link-color` will have the most affect when changed. - -### Breakpoints and Grid Stuff - -Probably won't need to touch these, but they're there if you need to. Width variables are used with the [`@include breakpoint()`](http://breakpoint-sass.com/) mixin to adapt the design of certain elements. - -And `$susy` is used for setting [the grid](http://susy.oddbird.net/) the theme uses. Uncommenting the lines under `debug` can be useful if you want to show the columns when adjusting the layout. - -<figure> - <img src="{{ base_path }}/images/mm-susy-grid-overlay.jpg" alt="Susy grid overlay for debugging"> - <figcaption>Susy grid debug overlay enabled.</figcaption> -</figure> - ---- - -The theme does not leverage Jekyll's [built-in support for preprocessing Sass](https://jekyllrb.com/docs/assets/#sassscss) files. Why is that you ask? [**Autoprefixer**](https://github.com/postcss/autoprefixer)! As part of a build step the stylesheet is post processed with Autoprefixer to add vendor prefixes --- something not currently possible without a plugin[^jekyll-assets]. - -[^jekyll-assets]: A better solution would be to use the fantastic [jekyll-assets](https://github.com/jekyll/jekyll-assets) plugin to manage your assets if you aren't hosting with GitHub Pages. Autoprefixer support is built-in :smile:. - -If you plan on making any changes to the `.scss` partials you will need to rebuild the stylesheet outside of the normal Jekyll workflow. - -**Sass/SCSS files:** You can of course modify the structure of the CSS files to have Jekyll natively process `main.scss` for you. Just be sure to update the partials to include any vendor prefixes or else things may look off in older browsers. -{: .notice--info} - -## Build Process - -In an effort to reduce dependencies a set of [**npm scripts**](https://css-tricks.com/why-npm-scripts/) are used to build the CSS instead of task runners like [Gulp](http://gulpjs.com/) or [Grunt](http://gruntjs.com/). If those tools are more your style then by all means use them instead :wink:. - -To get started: - -1. Install [Node.js](http://nodejs.org/). -2. `cd` to the root of your project. -3. Install all of the dependencies by running `npm install`. - -**Note:** If you upgraded from a previous version of the theme be sure you copied over [`package.json`](https://github.com/{{ site.repository }}/blob/master/package.json) prior to running `npm install`. -{: .notice--warning} - -If all goes well, running `npm run build:css` will process all SCSS files into `main.css`, which should then pipe through Autoprefixer. - -``` -Rendering Complete, saving .css file... -Wrote CSS to \assets\css\main.css -``` diff --git a/_docs/16-javascript.md b/_docs/16-javascript.md deleted file mode 100644 index ddaee26..0000000 --- a/_docs/16-javascript.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: "JavaScript" -permalink: /docs/javascript/ -excerpt: "Instructions for customizing and building the theme's scripts." -modified: 2016-07-14T09:39:49-04:00 ---- - -{% include base_path %} - -The theme's `main.js` script is built from several vendor, jQuery plugins, and other scripts found in `/assets/js/`. - -```bash -minimal mistakes -├── assets -| ├── js -| | ├── plugins -| | | ├── jquery.fitvids.js # fluid width video embeds -| | | ├── jquery.greedy-navigation.js # priority plus navigation -| | | ├── jquery.magnific-popup.js # responsive lightbox -| | | ├── jquery.smooth-scroll.min.js # make same-page links scroll smoothly -| | | └── stickyfill.min.js # `position: sticky` polyfill -| | ├── vendor -| | | └── jquery -| | | └── jquery-1.12.1.min.js -| | ├── _main.js # jQuery plugin settings and other scripts -| | └── main.min.js # concatenated and minified scripts -``` - -## Customizing - -To modify or add your own scripts include them in `/assets/js/_main.js` and then rebuild using `npm run build:js`. See below for more details. - -If you add additional scripts to `/assets/js/plugins/` and would like them concatenated with the others, be sure to update the `uglify` script in `package.json`. Same goes for scripts that you remove. - ---- - -## Build Process - -In an effort to reduce dependencies a set of [**npm scripts**](https://css-tricks.com/why-npm-scripts/) are used to build `main.min.js` instead of task runners like [Gulp](http://gulpjs.com/) or [Grunt](http://gruntjs.com/). If those tools are more your style then by all means use them instead :wink:. - -To get started: - -1. Install [Node.js](http://nodejs.org/). -2. `cd` to the root of your project. -3. Install all of the dependencies by running `npm install`. - -**Note:** If you upgraded from a previous version of the theme be sure you copied over [`package.json`](https://github.com/{{ site.repository }}/blob/master/package.json) prior to running `npm install`. -{: .notice--warning} - -If all goes well, running `npm run build:js` will compress/concatenate `_main.js` and all plugin scripts into `main.min.js`. \ No newline at end of file diff --git a/_docs/17-history.md b/_docs/17-history.md deleted file mode 100644 index 2b7be2a..0000000 --- a/_docs/17-history.md +++ /dev/null @@ -1,463 +0,0 @@ ---- -title: "History" -permalink: /docs/history/ -excerpt: "Changelog of enhancements and bug fixes made to the theme." -sidebar: - nav: docs -modified: 2016-08-01T10:30:20-04:00 ---- - -## [3.3.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.6) - -### Bug Fixes - -- Fix blank `site.teaser` bug [#412](https://github.com/mmistakes/minimal-mistakes/issues/412) - -## [3.3.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.5) - -### Enhancements - -- Add English default text `site.locale` strings [#407](https://github.com/mmistakes/minimal-mistakes/issues/407) -- Add Portuguese localized UI text. [#411](https://github.com/mmistakes/minimal-mistakes/pull/411) -- Add Italian localized UI text. [#409](https://github.com/mmistakes/minimal-mistakes/pull/409) - -### Maintenance - -- Remove unused Google AdSense variables in `_config.yml` [#404](https://github.com/mmistakes/minimal-mistakes/issues/404) -- Update `Gemfile` instructions for using `github-pages` vs. native `jekyll` gems. -- Disable `gems:` in `_config.yml` and enable plugins with Bundler instead. -- Add `repository` to `_config.yml` to suppress GitHub Pages error `Liquid Exception: No repo name found.` - -## [3.3.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.4) - -### Enhancements - -- Add support for configurable feed URL to use a service like FeedBurner instead of linking directly to `feed.xml` in `<head>` and the site footer. [#378](https://github.com/mmistakes/minimal-mistakes/issues/378), [#379](https://github.com/mmistakes/minimal-mistakes/pull/379), [#406](https://github.com/mmistakes/minimal-mistakes/pull/406) -- Add Turkish localized UI text. [#403](https://github.com/mmistakes/minimal-mistakes/pull/403) - -### Maintenance - -- Update gems: `activesupport` (4.2.7), `ffi` (1.9.14), `github-pages` (88), `jekyll-redirect-from` (0.11.0), `jekyll-watch` (1.5.0). - -## [3.3.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.3) - -### Enhancements - -- Make footer stick to the bottom of the page. - -### Bug Fixes - -- Fix `gallery` size bug [#402](https://github.com/mmistakes/minimal-mistakes/issues/402) - -### Maintenance - -- Set default `lang` to `en`. - -### Enhancements - -- Make footer stick to the bottom of the page. - -### Bug Fixes - -- Fix `gallery` size bug [#402](https://github.com/mmistakes/minimal-mistakes/issues/402) - -### Maintenance - -- Set default `lang` to `en`. - -## [3.3.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.2) - -### Bug Fixes - -- Fix JavaScript that triggers "sticky" sidebar to avoid layout issues on screen sizes < `1024px`. [#396](https://github.com/mmistakes/minimal-mistakes/issues/396) - -## [3.3.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.3.1) - -### Enhancements - -- Enable image popup on < 500px wide screens. [#385](https://github.com/mmistakes/minimal-mistakes/issues/385) -- Indicate the relationship between component URLs in a paginated series by applying `rel="prev"` and `rel="next"` to pages that use `site.paginator`. [#253](https://github.com/mmistakes/minimal-mistakes/issues/253) -- Improve link posts in archive listings. [#276](https://github.com/mmistakes/minimal-mistakes/issues/276) - -### Maintenance - -- Update gems: `github-pages` (86), `ffi` 1.9.13, `jekyll-mentions` 1.1.3, and `rouge` 1.11.1 -- Fix note about custom sidebar content appearing below author profile. [#388](https://github.com/mmistakes/minimal-mistakes/issues/388) - -## [3.2.13](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.13) - -### Enhancement - -- Add English default UI text for Canada, Great Britain, and Australia. [#377](https://github.com/mmistakes/minimal-mistakes/issues/377) -- Switch default locale from `en-US` to `en`. - -## [3.2.12](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.12) - -### Enhancements - -- Remove window width "magic number" from sticky sidebar check in `main.js` for improved flexibility. [#375](https://github.com/mmistakes/minimal-mistakes/pull/375) - -### Bug Fixes - -- Fix author override conditional where a missing `authors.yml` would show broken sidebar content. Defaults to `site.author`. [#376](https://github.com/mmistakes/minimal-mistakes/pull/376) - -## [3.2.11](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.11) - -### Bug Fixes - -- Fix disappearing author sidebar links [#372](https://github.com/mmistakes/minimal-mistakes/issues/372) - -### Maintenance - -- Update gems: `github-pages` (84), `jekyll-github-metadata` 2.0.2, and `kramdown` 1.11.1 -- Update vendor JavaScript: jQuery 1.12.4, Stickyfill.js 1.1.4 -- Update Font Awesome 4.6.3 - -## [3.2.10](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.10) - -### Maintenance - -- Add `CONTRIBUTING.md` - -## [3.2.9](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.9) - -### Enhancements - -- Add support for [header overlay images](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#header-overlay) for Open Graph images. [#358](https://github.com/mmistakes/minimal-mistakes/pull/358) - -### Bug Fixes - -- Fix `Person` typo Schema.org type [#358](https://github.com/mmistakes/minimal-mistakes/pull/358) - -### Maintenance - -- Update `github-pages` gem and dependencies. -- Remove `minutes_read` to avoid awkward reading time wording [#356](https://github.com/mmistakes/minimal-mistakes/issues/356) - -## [3.2.8](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.8) - -### Bug Fixes - -- Remove `cursor: pointer` that appears on white-space surrounding author side list items and links. [#354](https://github.com/mmistakes/minimal-mistakes/pull/354) - -### Maintenance - -- Add contributing information to `README.md`. [#357](https://github.com/mmistakes/minimal-mistakes/issues/357) - -## [3.2.7](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.7) - -### Enhancements - -- Add French localized UI text. [#346](https://github.com/mmistakes/minimal-mistakes/pull/346) - -### Bug Fixes - -- Fix branch logic for Yandex and Alexa in `seo.html`. [#348](https://github.com/mmistakes/minimal-mistakes/pull/348) - -## [3.2.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.6) - -### Bug Fixes - -- Fix error `Liquid Exception: divided by 0 in _includes/archive-single.html, included in _layouts/single.html` caused by null `words_per_minute` in `_config.yml`. [#345](https://github.com/mmistakes/minimal-mistakes/pull/345) - -## [3.2.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.5) - -### Bug Fixes - -- Fix link color in hero overlay to be white. -- Remove underlines from archive item titles. - -## [3.2.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.4) - -### Enhancements - -- Improve text alignment of masthead, hero overlay, page footer to be flush left and remove awkward white-space gaps. [#342](https://github.com/mmistakes/minimal-mistakes/issues/342) -- Add Spanish localized UI text. [#338](https://github.com/mmistakes/minimal-mistakes/pull/338) - -### Bug Fixes - -- Fix alignment of icons in author sidebar [#341](https://github.com/mmistakes/minimal-mistakes/issues/341) - -### Maintenance - -- Add background color to page footer to set it apart from main content. [#342](https://github.com/mmistakes/minimal-mistakes/issues/342) -- Add terms and privacy policy to theme's demo site. [#343](https://github.com/mmistakes/minimal-mistakes/issues/343) -- Update screenshots found in theme documentation. - -## [3.2.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.3) - -### Enhancement - -- Add [Discourse](https://www.discourse.org/) as a commenting provider [#335](https://github.com/mmistakes/minimal-mistakes/pull/335) - -## [3.2.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.2) - -### Enhancement - -- Add support for image captions in Magnific Popup overlays via the [`gallery`](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#gallery) helper [#334](https://github.com/mmistakes/minimal-mistakes/issues/334) - -## [3.2.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.1) - -### Bug Fixes - -- Remove need for "double tapping" masthead menu links on iOS devices. [#315](https://github.com/mmistakes/minimal-mistakes/issues/315) - -### Maintenance - -- Add `ISSUE_TEMPLATE.md` for improve issue submission process. - -## [3.2.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.2.0) - -### Bug Fixes - -- Fix missing category/tag links in post footer due to possible conflict with `site.tags` and `site.categories`. [#329](https://github.com/mmistakes/minimal-mistakes/issues/329#issuecomment-222375568) - -## [3.1.8](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.8) - -### Bug Fixes - -- Fix `Liquid Exception: undefined method 'gsub' for nil:NilClass in _layouts/single.html` error when `page.title` is null. `<h1>` element is now conditional if `title: ` is not set for a `page` or collection item. [#312](https://github.com/mmistakes/minimal-mistakes/issues/312) - -### Maintenance - -- Remove duplicate `fa-twitter` and `fa-twitter-square` classes from `_utilities.scss`. [#302](https://github.com/mmistakes/minimal-mistakes/issues/302) - -- Document installing additional Jekyll gem dependencies when using `gem "jekyll"` instead of `gem "github-pages"` to avoid any errors on run. [#305](https://github.com/mmistakes/minimal-mistakes/issues/305) - -## [3.1.7](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.7) - -### Enhancement - -- Add translation key for "Recent Posts" used in home page `index.html`. [#316](https://github.com/mmistakes/minimal-mistakes/pull/316) - -### Maintenance - -- Small fix to avoid underlying the whitespace between icons and related text when hovering. [#303](https://github.com/mmistakes/minimal-mistakes/pull/303) - -## [3.1.6](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.6) - -### Maintenance - -- Update gem dependencies. Run `bundle` to update `Gemfile.lock`. - -## [3.1.5](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.5) - -### Maintenance - -- Fix `www` and `https` links in author profile include [#293](https://github.com/mmistakes/minimal-mistakes/pull/293) - -## [3.1.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.4) - -### Enhancements - -- Add `overlay_filter` param to hero headers [#298](https://github.com/mmistakes/minimal-mistakes/pull/298) - -## [3.1.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.3) - -### Enhancements - -- Improve `site.locale` documentation [#284](https://github.com/mmistakes/minimal-mistakes/issues/284) -- Remove ProTip note about protocol-less `site.url` as it is an anti-pattern [#288](https://github.com/mmistakes/minimal-mistakes/issues/288) - -### Bug Fixes - -- Fix `og_image` URL in seo.html [#277](https://github.com/mmistakes/minimal-mistakes/issues/277) -- Fix `author_profile` toggle when assigned in a `_layout` [#285](https://github.com/mmistakes/minimal-mistakes/issues/285) -- Fix typo in `build:all` npm script [#283](https://github.com/mmistakes/minimal-mistakes/pull/283) -- Fix URL typo documentation [#287](https://github.com/mmistakes/minimal-mistakes/issues/287) -- SEO author bug. If `twitter.username` is set and `author.twitter` is `nil` bad things happen. [#289](https://github.com/mmistakes/minimal-mistakes/issues/289) - -## [3.1.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.2) - -### Enhancement - -- Explain how to use `nav_list` helper in [documentation](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#navigation-list). -- Reduce left/right padding on smaller screens to increase width of main content column. - -## [3.1.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.1) - -### Bug Fix - -- Fixed reading time bug when `words_per_minute` wasn't set in `_config.yml` [#271](https://github.com/mmistakes/minimal-mistakes/issues/271) - -## [3.1.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.1.0) - -### Enhancements - -- Updated [Font Awesome](https://fortawesome.github.io/Font-Awesome/whats-new/) to version 4.6.1 -- Added optional GitHub and Bitbucket links to footer if set on `site.author` in `_config.yml`. - -### Bug Fixes -- Fixed Bitbucket URL typo in author sidebar. - -## [3.0.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/3.0.3) - -### Enhancements - -- Rebuilt the entire theme: layouts, includes, stylesheets, scripts, you name it. -- Refreshed the look and feel while staying true to the original design of the theme (author sidebar/main content). -- Replaced grid system with [Susy](http://susy.oddbird.net/). -- Replaced Grunt tasks with `npm` scripts. -- Removed Google Fonts and replaced with system fonts to improve performance (they can be [added back](https://mmistakes.github.io/minimal-mistakes/docs/stylesheets/) if desired) -- Greatly improved [theme documentation](https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/). -- Increased the amount of sample posts, sample pages, and sample collections to throughly test the theme and edge-cases. -- Moved all sample content and assets out of `master` to keep it as clean as possible for forking. -- Added new layouts for `splash` pages, archives for [`jekyll-archives`](https://github.com/jekyll/jekyll-archives) if enabled, and [`compress.html`](https://github.com/penibelst/jekyll-compress-html) to improve performance. -- Added taxonomy links to posts (tags and categories). -- Added optional "reading time" meta data. -- Improved Liquid used for Twitter Cards and Open Graph data in `<head>`. -- Improved `gallery` include helper and added `feature_row` for use with splash page layout. -- Added Keybase.io, author web URI, and Bitbucket optional links to sidebar. -- Add `feed.xml` link to footer. -- Added a [UI text data file](https://mmistakes.github.io/minimal-mistakes/docs/ui-text/) to easily change all text found in the theme. -- Added LinkedIn to optional social share buttons. -- Added Facebook, Google+, and custom commenting options in addition to Disqus. -- Added optional breadcrumb links. - -## [2.2.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.2.1) - -## [2.2.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.2.0) - -### Enhancements - -- Add support for Jekyll 3.0 -- Minor updates to syntax highlighting CSS and theme documentation - -## [2.1.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.1.3) - -### Enhancements - -- Cleaner print styles that remove the top navigation, social sharing buttons, and other elements not needed when printed. - -## [2.1.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.1.2) - -### Enhancements - -- Add optional CodePen icon/url to author side bar [#156](https://github.com/mmistakes/minimal-mistakes/pull/156) -- Documented Stackoverflow username explanation in `_config.yml` [#157](https://github.com/mmistakes/minimal-mistakes/pull/157) -- Simplified Liquid in `post-index.html` to better handle year listings [#166](https://github.com/mmistakes/minimal-mistakes/pull/166) - -### Bug Fixes - -- Cleanup Facebook related Open Graph meta tags [#149](https://github.com/mmistakes/minimal-mistakes/issues/149) -- Corrected minor typos [#158](https://github.com/mmistakes/minimal-mistakes/pull/158) [#175](https://github.com/mmistakes/minimal-mistakes/issues/175) - -## [2.1.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.1.1) - -### Enhancements - -- Add optional XING profile link to author sidebar -- Include open graph meta tags for feature image (if assigned) [#149](https://github.com/mmistakes/minimal-mistakes/issues/149) -- Create an include for feed footer - -### Bug Fixes - -- Remove http protocol from Google search form on sample 404 page -- Only show related posts if there are one or more available -- Fix alignment of email address link in author sidebar - -## [2.1.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.1.0) - -### Enhancements - -- Add optional social sharing buttons ([#42](https://github.com/mmistakes/minimal-mistakes/issues/42)) - -![social sharing buttons](https://cloud.githubusercontent.com/assets/1376749/5860522/d9f28a96-a22f-11e4-9b83-940a3a9a766a.png) - -- Add Soundcloud, YouTube ([#95](https://github.com/mmistakes/minimal-mistakes/pull/95)), Flickr ([#119](https://github.com/mmistakes/minimal-mistakes/pull/119)), and Weibo ([#116](https://github.com/mmistakes/minimal-mistakes/pull/116)) icons for use in author sidebar. -- Fix typos in posts and documentation and remove references to Less -- Include note about Octopress gem being optional -- Post author override support extended to the Atom feed ([#71](https://github.com/mmistakes/minimal-mistakes/pull/71)) -- Only include email address in feed if specified in `_config.yml` or author `_data` -- Wrap all page content in `#main` to harmonize article and post index styles ([#86](https://github.com/mmistakes/minimal-mistakes/issues/86)) -- Include new sample feature images for posts and pages -- Table of contents improvements: fix collapse toggle, indent nested elements, show on small screens, and create an `_include` for reusing in posts and pages. -- Include note about running Jekyll with `bundle exec` when using Bundler -- Fix home page path in top navigation -- Remove Google Authorship ([#120](https://github.com/mmistakes/minimal-mistakes/issues/120)) -- Remove duplicate author content that displayed in `div.article-author-bottom` -- Removed unused `_sass/print.scss` styles -- Improve comments in `.scss` files - -## [2.0.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/v2.0) - -## [1.3.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.3.3) - -### Enhancements - -- Added new icons and profile links for Stackoverflow, Dribbble, Pinterest, Foursquare, and Steam to the author bio sidebar. -- Cleaned up the Kramdown auto table of contents styling to be more readable -- Removed page width specific .less stylesheets and created mixins for easier updating -- Removed Modernizr since it wasn't being used -- Added pages to sitemap.xml -- Added category: to rake new_post task -- Minor typographic changes - -### Bug Fixes - -- Corrected various broken links in README and Theme Setup. - -## [1.3.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.3.1) - -### Enhancements - -- Cleaned up table of contents styling -- Reworked top navigation to be a better experience on small screens. Nav items now display vertically when the menu button is tapped, revealing links with larger touch targets. - -![menu animation](https://camo.githubusercontent.com/3fbd8c1326485f4b1ab32c0005c0fca7660b5d31/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f313337363734392f323136343037352f31653366303663322d393465372d313165332d383961612d6436623636376562306564662e676966) - -## [1.2.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.2.0) - -### Bug Fixes - -- Table weren't filling the entire width of the content container. They now scale at 100%. Thanks [@dhruvbhatia](https://github.com/dhruvbhatia) - -### Enhancements - -- Decreased spacing between Markdown footnotes -- Removed dark background on footer -- Removed UPPERCASE styling on post titles in the index listing - -## [1.1.4](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.1.4) - -### Bug Fixes - -- Fix top navigation bug issue ([#10](https://github.com/mmistakes/minimal-mistakes/issues/10)) for real this time. Remember to clear your floats kids. - -## [1.1.3](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.1.3) - -### Bug Fixes - -- Fix top navigation links that weren't click able on small viewports (Issue [#10](https://github.com/mmistakes/minimal-mistakes/issues/10)). -- Remove line wrap from top navigation links that may span multiple lines. - -## [1.1.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.1.2) - -### Enhancements - -- Added Grunt build script for compiling Less/JavaScript and optimizing image assets. -- Added support for large image summary Twitter card. -- Stylesheet adjustments - -## [1.1.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/1.1.1) - -### Bug Fixes - -- Removed [Typeplate](http://typeplate.com/) styles. Was [causing issues with newer versions of Less](https://github.com/typeplate/typeplate.github.io/issues/108) and is no longer maintained. - -### Enhancements - -- Added [image attribution](http://mmistakes.github.io/minimal-mistakes/theme-setup/#feature-images) for post and page feature images. -- Added [404 page](http://mmistakes.github.io/minimal-mistakes/404.html). -- Cleaned up various Less variables to better align with naming conventions used in other MM Jekyll themes. -- Removed Chrome Frame references. -- Added global CSS3 transitions to text and block elements. -- Improved typography in a few places. - -## [1.0.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/v1.0.2) - -### Enhancements - -- Google Analytics, Google Authorship, webmaster verifies, and Twitter card meta are now optional. - -## [1.0.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/v1.0.1) \ No newline at end of file diff --git a/_docs/18-contributing.md b/_docs/18-contributing.md deleted file mode 100644 index f83d993..0000000 --- a/_docs/18-contributing.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "Contributing" -permalink: /docs/contributing/ -excerpt: "How you can contribute to make this theme better." -modified: 2016-06-12 ---- - -Having trouble working with the theme? Found a typo in the documentation? Interested in adding a feature or [fixing a bug](https://github.com/mmistakes/minimal-mistakes/issues)? Then by all means [submit an issue](https://github.com/mmistakes/minimal-mistakes/issues/new) or [pull request](https://help.github.com/articles/using-pull-requests/). If this is your first pull request, it may be helpful to read up on the [GitHub Flow](https://guides.github.com/introduction/flow/) first. - -Minimal Mistakes has been designed as a base for you to customize and fit your site's unique needs. Please keep this in mind when requesting features and/or submitting pull requests. If it's not something that most people will use, I probably won't consider it. When in doubt ask. - -This goes for author sidebar links and "share button" additions -- I have no intention of merging in every possibly option, the essentials are there to get you started :smile:. - -## Pull Requests - -To help me out try to avoid creating pull requests on `master` and instead branch off of `develop`. It's much easier for me to test, merge, and roll them into new releases this way. \ No newline at end of file diff --git a/_docs/19-docs-2-2.md b/_docs/19-docs-2-2.md deleted file mode 100644 index 383216c..0000000 --- a/_docs/19-docs-2-2.md +++ /dev/null @@ -1,302 +0,0 @@ ---- -title: "2.2 Documentation" -permalink: /docs/docs-2-2/ -excerpt: "Setup and installation instructions for Minimal Mistakes 2.2 (deprecated)." -modified: 2016-04-13T15:54:02-04:00 ---- - -{% include base_path %} -{% include toc %} - -## Installation - -Minimal Mistakes now requires [Jekyll](http://jekyllrb.com/) 3.0. Make sure to run `bundle update` if you aren't on the latest version to update all gem dependencies. - -If you are creating a new Jekyll site using Minimal Mistakes follow these steps: - -1. Fork the [Minimal Mistakes repo](http://github.com/mmistakes/minimal-mistakes/fork). -2. Clone the repo you just forked and rename it. -3. [Install Bundler](http://bundler.io) `gem install bundler` and Run `bundle install` to install all dependencies (Jekyll, [Jekyll-Sitemap](https://github.com/jekyll/jekyll-sitemap), [Octopress](https://github.com/octopress/octopress), etc) -4. Update `config.yml`, add navigation, and replace demo posts and pages with your own. Full details below. - -If you want to use Minimal Mistakes with an existing Jekyll site follow these steps: - -1. [Download Minimal Mistakes](https://github.com/mmistakes/minimal-mistakes/releases/tag/2.2.1) and unzip. -2. Rename `minimal-mistakes-master` to something meaningful ie: `new-site` -3. Run `bundle install` to install all dependencies (Jekyll, [Jekyll-Sitemap](https://github.com/jekyll/jekyll-sitemap), [Octopress](https://github.com/octopress/octopress), etc) -4. Remove demo posts/pages and replace with your own posts, pages, and any other content you want to move over. -5. Update posts' and pages' YAML to match variables used by Minimal Mistakes. Full details below. -6. Update `_config.yml` and add navigation links. Full details below. - -**Pro-tip:** Delete the `gh-pages` branch after cloning and start fresh by branching off `master`. There is a bunch of garbage in `gh-pages` used for the theme's demo site that I'm guessing you won't want. -{: .notice} - -## Running Jekyll - -The preferred method for running Jekyll is with `bundle exec`, but if you're willing to deal gem conflicts feel free to go cowboy with a `jekyll serve` or `jekyll build`. - -> In some cases, running executables without bundle exec may work, if the executable happens to be installed in your system and does not pull in any gems that conflict with your bundle. -> ->However, this is unreliable and is the source of considerable pain. Even if it looks like it works, it may not work in the future or on another machine. - -```bash -bundle exec jekyll serve -``` - -## Scaffolding - -How Minimal Mistakes is organized and what the various files are. All posts, layouts, includes, stylesheets, assets, and whatever else is grouped nicely under the root folder. The compiled Jekyll site outputs to `_site/`. - -```bash -minimal-mistakes/ -├── _includes/ -| ├── author-bio.html # bio stuff layout. pulls optional owner data from _config.yml -| ├── browser-upgrade # prompt to install a modern browser for < IE9 -| ├── disqus-comments # Disqus comments script -| ├── footer # site footer -| ├── head # site head -| ├── navigation # site top navigation -| ├── open-graph.html # Twitter Cards and Open Graph meta data -| └── scripts # site scripts -├── _layouts/ -| ├── home.html # homepage layout -| ├── page.html # page layout -| ├── post-index.html # post index layout -| └── post.html # single post layout -├── _posts/ # MarkDown formatted posts -├── _sass/ # Sass stylesheets -├── _templates/ # used by Octopress to define YAML variables for new posts/pages -├── about/ # sample about page -├── assets/ -| ├── css/ # compiled stylesheets -| ├── fonts/ # webfonts -| ├── js/ -| | ├── _main.js # main JavaScript file, plugin settings, etc -| | ├── plugins/ # scripts and jQuery plugins to combine with _main.js -| | ├── scripts.min.js # concatenated and minified _main.js + plugin scripts -| | └── vendor/ # vendor scripts to leave alone and load as is -| └── less/ -├── images/ # images for posts and pages -├── 404.md # 404 page -├── feed.xml # Atom feed template -├── index.md # sample homepage. lists 5 latest posts -├── posts/ # sample post index page. lists all posts in reverse chronology -└── theme-setup/ # theme setup page. safe to remove -``` - -## Site Setup - -A quick checklist of the files you'll want to edit to get up and running. - -### Site Wide Configuration - -`_config.yml` is your friend. Open it up and personalize it. Most variables are self explanatory but here's an explanation of each if needed: - -#### title - -The title of your site... shocker! - -Example `title: My Awesome Site` - -#### url - -Used to generate absolute urls in `sitemap.xml`, `feed.xml`, and for generating canonical URLs in `<head>`. When developing locally either comment this out or use something like `http://localhost:4000` so all assets load properly. *Don't include a trailing `/`*. - -Examples: - -```yaml -url: http://mmistakes.github.io/minimal-mistakes -url: http://localhost:4000 -url: //cooldude.github.io -url: -``` - -#### Google Analytics and Webmaster Tools - -Google Analytics UA and Webmaster Tool verification tags can be entered under `owner` in `_config.yml`. For more information on obtaining these meta tags check [Google Webmaster Tools](http://support.google.com/webmasters/bin/answer.py?hl=en&answer=35179) and [Bing Webmaster Tools](https://ssl.bing.com/webmaster/configure/verify/ownership) support. - -### Navigation Links - -To set what links appear in the top navigation edit `_data/navigation.yml`. Use the following format to set the URL and title for as many links as you'd like. *External links will open in a new window.* - -```yaml -- title: Portfolio - url: /portfolio/ - -- title: Made Mistakes - url: http://mademistakes.com -``` - -## Adding New Content with Octopress - -While completely optional, I've included Octopress and some starter templates to automate the creation of new posts and pages. To take advantage of it start by installing the [Octopress](https://github.com/octopress/octopress) gem if it isn't already. - -```bash -$ gem install octopress -``` - -### New Post - -Default command - -```bash -$ octopress new post "Post Title" -``` - -Default works great if you want all your posts in one directory, but if you're like me and want to group them into subfolders like `/posts`, `/portfolio`, etc. Then this is the command for you. By specifying the DIR it will create a new post in that folder and populate the `categories:` YAML with the same value. - -```bash -$ octopress new post "New Portfolio Post Title" --dir portfolio -``` - -### New Page - -To create a new page use the following command. - -```bash -$ octopress new page new-page/ -``` - -This will create a page at `/new-page/index.md` - -## Layouts and Content - -Explanations of the various `_layouts` included with the theme and when to use them. - -### Post and Page - -These two layouts are very similar. Both have an author sidebar, allow for large feature images at the top, and optional Disqus comments. The only real difference is the post layout includes related posts at the end of the page. - -### Post Index Page - -A [sample index page]({{ site.url }}/posts/) listing all posts grouped by the year they were published has been provided. The name can be customized to your liking by editing a few references. For example, to change **Posts** to **Writing** update the following: - -In `_config.yml` under `links:` rename the title and URL to the following: - -```yaml - links: - - title: Writing - url: /writing/ -``` - -* Rename `posts/index.md` to `writing/index.md` and update the YAML front matter accordingly. -* Update the **View all posts** link in the `post.html` layout found in `_layouts` to match title and URL set previously. - -### Feature Images - -A good rule of thumb is to keep feature images nice and wide so you don't push the body text too far down. An image cropped around around 1024 x 256 pixels will keep file size down with an acceptable resolution for most devices. If you want to serve these images responsively I'd suggest looking at the [Jekyll Picture Tag](https://github.com/robwierzbowski/jekyll-picture-tag) plugin[^plugins]. - -[^plugins]: If you're using GitHub Pages to host your site be aware that plugins are disabled. You'll need to build your site locally and then manually deploy if you want to use this sweet plugin. - -The post and page layouts make the assumption that the feature images live in the `images/` folder. To add a feature image to a post or page just include the filename in the front matter like so. It's probably best to host all your images from this folder, but you can hotlink from external sources if you desire. - -```yaml -image: - feature: feature-image-filename.jpg - thumb: thumbnail-image.jpg #keep it square 200x200 px is good -``` - -To add attribution to a feature image use the following YAML front matter on posts or pages. Image credits appear directly below the feature image with a link back to the original source if supplied. - -```yaml -image: - feature: feature-image-filename.jpg - credit: Michael Rose #name of the person or site you want to credit - creditlink: http://mademistakes.com #url to their site or licensing -``` - -### Thumbnails for OG and Twitter Cards - -Feature and thumbnail images are used by [Open Graph](https://developers.facebook.com/docs/opengraph/) and [Twitter Cards](https://dev.twitter.com/docs/cards) as well. If you don't assign a thumbnail the default graphic *(default-thumb.png)* is used. I'd suggest changing this to something more meaningful --- your logo or avatar are good options. - -**Pro-Tip**: You need to [apply for Twitter Cards](https://dev.twitter.com/docs/cards) before they will begin showing up when links to your site are shared. -{:.notice} - -### Author Override - -By making use of data files you can assign different authors for each post. - -Start by modifying `authors.yml` file in the `_data` folder and add your authors using the following format. - -```yaml -# Authors - -billy_rick: - name : "Billy Rick" - web : "http://thewhip.com" - email : "billy@rick.com" - bio : "What do you want, jewels? I am a very extravagant man." - avatar : "bio-photo-2.jpg" - twitter : "extravagantman" - google_plus : "BillyRick" - -cornelius_fiddlebone: - name : "Cornelius Fiddlebone" - email : "cornelius@thewhip.com" - bio : "I ordered what?" - avatar : "bio-photo.jpg" - twitter : "rhymeswithsackit" - google_plus : "CorneliusFiddlebone" -``` - -To assign Billy Rick as an author for our post. We'd add the following YAML front matter to a post: - -```yaml -author: billy_rick -``` - -### Kramdown Table of Contents - -To include an auto-generated **table of contents** for posts and pages, add the following `_include` before the actual content. [Kramdown will take care of the rest](http://kramdown.rubyforge.org/converter/html.html#toc) and convert all headlines into list of links. - -```html -{% raw %}{% include toc.html %}{% endraw %} -``` - -### Paragraph Indentation - -By default the margin below paragraphs has been removed and indent added to each. This is an intentional design decision to mimic the look of type set in a printed book or manuscript. - -<figure> - <img src="{{ base_path }}/images/paragraph-indent.png" alt="screen shot of paragraphs with default indent style set"> - <figcaption>Example of the default paragraph style (indented first line and bottom margin removed).</figcaption> -</figure> - -To disable the indents and add spacing between paragraphs change the following line in `_sass/variables.scss` from `true !default` to `false` like so. - -```scss -$paragraph-indent: false; -``` - -<figure> - <img src="{{ base_path }}/images/paragraph-no-indent.png" alt="screen shot of paragraphs with indent style disabled"> - <figcaption>Example of paragraphs with $paragraph-indent disabled.</figcaption> -</figure> - -### Videos - -Video embeds are responsive and scale with the width of the main content block with the help of [FitVids](http://fitvidsjs.com/). - -Not sure if this only effects Kramdown or if it's an issue with Markdown in general. But adding YouTube video embeds causes errors when building your Jekyll site. To fix add a space between the `<iframe>` tags and remove `allowfullscreen`. Example below: - -```html -<iframe width="560" height="315" src="http://www.youtube.com/embed/PWf4WUoMXwg" frameborder="0"> </iframe> -``` - -### Social Sharing Links - -Social sharing links for Twitter, Facebook, and Google+ are included on posts/pages by default. To hide them on specific posts or pages add `share: false` to the YAML Front Matter. If you'd like to use different social networks modify `_includes/social-share` to your liking. Icons are set using [Font Awesome](http://fontawesome.io). - -## Further Customization - -Jekyll 2.x added support for Sass files making it much easier to modify a theme's fonts and colors. By editing values found in `_sass/variables.scss` you can fine tune the site's colors and typography. - -For example if you wanted a red background instead of white you'd change `$bodycolor: #fff;` to `$bodycolor: $cc0033;`. - -To modify the site's JavaScript files I setup a Grunt build script to lint/concatenate/minify all scripts into `scripts.min.js`. [Install Node.js](http://nodejs.org/), then [install Grunt](http://gruntjs.com/getting-started), and then finally install the dependencies for the theme contained in `package.json`: - -```bash -npm install -``` - -From the theme's root, use `grunt` concatenate JavaScript files, and optimize .jpg, .png, and .svg files in the `images/` folder. You can also use `grunt dev` in combination with `jekyll build --watch` to watch for updates JS files that Grunt will then automatically re-build as you write your code which will in turn auto-generate your Jekyll site when developing locally. \ No newline at end of file diff --git a/_docs/20-license.md b/_docs/20-license.md deleted file mode 100644 index 234b53a..0000000 --- a/_docs/20-license.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "License" -permalink: /docs/license/ -excerpt: "License for Minimal Mistakes Jekyll Theme." -modified: 2016-04-13T15:05:12-04:00 ---- - -The MIT License (MIT) - -Copyright (c) {{ site.time | date: '%Y' }} Michael Rose - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -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. \ No newline at end of file diff --git a/_drafts/post-draft.md b/_drafts/post-draft.md deleted file mode 100644 index e0bb2bd..0000000 --- a/_drafts/post-draft.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -layout: single -title: "Draft Post" -header: - teaser: "unsplash-gallery-image-2-th.jpg" -categories: - - Jekyll -tags: - - edge case ---- -Monocle ipsum dolor sit amet handsome pariatur aliqua, hub remarkable irure commodo classic deserunt bespoke. Sunt commodo signature, Swiss minim flat white Tsutaya excepteur artisanal et Nordic laborum joy ANA. Beams mollit exquisite Ginza efficient dolore qui Comme des Garçons Winkreative Lufthansa bulletin global. Iconic sed liveable duis. Mollit dolore eu laboris Comme des Garçons hub pintxos sed eiusmod tote bag Shinkansen nisi consectetur pariatur. Nordic international quis finest Baggu dolore, bureaux hub hand-crafted ut joy sint Airbus A380. - -Conversation handsome hub cosy, enim emerging sed K-pop velit Gaggenau charming proident et boulevard ryokan. Remarkable airport deserunt international est, nulla minim magna emerging discerning in exclusive dolor. Commodo dolore deserunt cosy, global Nordic culpa uniforms signature charming. Smart ryokan commodo, eiusmod global occaecat incididunt aliqua Beams. Boulevard conversation excepteur finest Swiss non veniam Comme des Garçons essential artisanal. Destination Scandinavian international, anim Boeing 787 in duis Baggu irure essential. - -Fugiat exclusive laborum, Gaggenau ad Winkreative sharp elit labore. Remarkable officia ryokan Boeing 787, consectetur boutique Nordic Singapore espresso elit iconic perfect izakaya soft power excepteur. Ut veniam carefully curated K-pop dolore, uniforms in voluptate. Craftsmanship Ettinger Lufthansa sophisticated esse boutique veniam exquisite. Aute cillum bespoke, intricate consectetur in exquisite international lovely bulletin irure Washlet Gaggenau deserunt. Efficient eu quality of life wardrobe labore, dolor emerging airport concierge reprehenderit izakaya dolore liveable Baggu. - -Commodo elegant essential consectetur Gaggenau culpa consequat id sophisticated St Moritz sunt conversation duis non velit. Nulla business class non ut Marylebone ANA soft power fugiat carefully curated. Bureaux sed punctual handsome Washlet impeccable hand-crafted aute extraordinary tote bag enim boulevard soft power sleepy. Dolore conversation irure Zürich the best adipisicing, vibrant finest hub anim premium aliqua. Cupidatat smart international, bureaux Baggu id efficient punctual. Tempor nulla flat white enim, K-pop incididunt elit efficient Toto uniforms concierge discerning. Concierge sleepy extraordinary, deserunt Melbourne commodo Nordic Winkreative Washlet Ginza exercitation espresso. - -Tsutaya sed in business class sharp. Do Beams in adipisicing Lufthansa. Business class occaecat Melbourne, irure Singapore commodo espresso carefully curated quis quality of life adipisicing. Impeccable laborum efficient classic proident in. Beams Helsinki ullamco Marylebone dolore sophisticated concierge Muji anim duis joy ut. Comme des Garçons aute Muji in aliquip ryokan soft power Nordic essential ANA culpa elegant. \ No newline at end of file diff --git a/_includes/footer.html b/_includes/footer.html index 53b99eb..a3ed999 100644 --- a/_includes/footer.html +++ b/_includes/footer.html @@ -1,24 +1,5 @@ {% include base_path %} -<div class="page__footer-follow"> - <ul class="social-icons"> - {% if site.data.ui-text[site.locale].follow_label %} - <li><strong>{{ site.data.ui-text[site.locale].follow_label }}</strong></li> - {% endif %} - {% if site.twitter.username %} - <li><a href="https://twitter.com/{{ site.twitter.username }}"><i class="fa fa-fw fa-twitter-square" aria-hidden="true"></i> Twitter</a></li> - {% endif %} - {% if site.facebook.username %} - <li><a href="https://facebook.com/{{ site.facebook.username }}"><i class="fa fa-fw fa-facebook-square" aria-hidden="true"></i> Facebook</a></li> - {% endif %} - {% if site.author.github %} - <li><a href="http://github.com/{{ site.author.github }}"><i class="fa fa-fw fa-github" aria-hidden="true"></i> GitHub</a></li> - {% endif %} - {% if site.author.bitbucket %} - <li><a href="http://bitbucket.org/{{ site.author.bitbucket }}"><i class="fa fa-fw fa-bitbucket" aria-hidden="true"></i> Bitbucket</a></li> - {% endif %} - <li><a href="{% if site.atom_feed.path %}{{ site.atom_feed.path }}{% else %}{{ base_path }}/feed.xml{% endif %}"><i class="fa fa-fw fa-rss-square" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].feed_label | default: "Feed" }}</a></li> - </ul> -</div> +<div class="page__footer-contact">Got a correction? Email <a href="mailto:drakkar@seiyria.com?subject=Drakkar Site Correction">drakkar@seiyria.com</a></div> -<div class="page__footer-copyright">© {{ site.time | date: '%Y' }} {{ site.name | default: site.title }}. {{ site.data.ui-text[site.locale].powered_by | default: "Powered by" }} <a href="http://jekyllrb.com" rel="nofollow">Jekyll</a> & <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.</div> \ No newline at end of file +<div class="page__footer-copyright">© {{ site.time | date: '%Y' }} {{ site.name | default: site.title }}. {{ site.data.ui-text[site.locale].powered_by | default: "Powered by" }} <a href="http://jekyllrb.com" rel="nofollow">Jekyll</a> & <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.</div> diff --git a/_includes/sidebar.html b/_includes/sidebar.html index b8ee39a..24b4cb3 100644 --- a/_includes/sidebar.html +++ b/_includes/sidebar.html @@ -2,7 +2,6 @@ {% if page.author_profile or layout.author_profile or page.sidebar %} <div class="sidebar sticky"> - {% if page.author_profile or layout.author_profile %}{% include author-profile.html %}{% endif %} {% if page.sidebar %} {% for s in page.sidebar %} {% if s.image %} @@ -22,4 +21,4 @@ {% endif %} {% endif %} </div> -{% endif %} \ No newline at end of file +{% endif %} diff --git a/_layouts/default.html b/_layouts/default.html index 1407e72..836ecbd 100644 --- a/_layouts/default.html +++ b/_layouts/default.html @@ -18,18 +18,6 @@ {{ content }} - <script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script> - <div align="center" style="margin: 1em 0;"> - <ins class="adsbygoogle" - style="display:block; border-bottom: initial;" - data-ad-client="ca-pub-7328585512091257" - data-ad-slot="3049671934" - data-ad-format="auto"></ins> - </div> - <script> - (adsbygoogle = window.adsbygoogle || []).push({}); - </script> - <div class="page__footer"> <footer> {% include footer/custom.html %} diff --git a/_layouts/single.html b/_layouts/single.html index 3629aa6..f798c11 100644 --- a/_layouts/single.html +++ b/_layouts/single.html @@ -43,11 +43,13 @@ <h4 class="page__meta-title">{{ site.data.ui-text[site.locale].meta_label }}</h4> {% endif %} {% include page__taxonomy.html %} + <!-- {% if page.modified %} <p class="page__date"><strong><i class="fa fa-fw fa-calendar" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].date_label | default: "Updated:" }}</strong> <time datetime="{{ page.modified | date: "%Y-%m-%d" }}">{{ page.modified | date: "%B %d, %Y" }}</time></p> {% elsif page.date %} <p class="page__date"><strong><i class="fa fa-fw fa-calendar" aria-hidden="true"></i> {{ site.data.ui-text[site.locale].date_label | default: "Updated:" }}</strong> <time datetime="{{ page.date | date_to_xmlschema }}">{{ page.date | date: "%B %d, %Y" }}</time></p> {% endif %} + --> </footer> {% if page.share %}{% include social-share.html %}{% endif %} @@ -73,4 +75,4 @@ <h4 class="page__related-title">{{ site.data.ui-text[site.locale].related_label </div> </div> {% endif %} -</div> \ No newline at end of file +</div> diff --git a/_other/macros.md b/_other/macros.md new file mode 100644 index 0000000..d7045b1 --- /dev/null +++ b/_other/macros.md @@ -0,0 +1,146 @@ +--- +title: "Macros" +permalink: /other/macros +excerpt: "Macros" +--- + +{% include base_path %} + +Macros are an unavoidable truth in Drakkar, so understanding how they work is crucial for continued success in the game. There are a lot of different macros, so following will be a list of macros, what they do, and some sample usages of macros. + +# Creating a Macro +Hit the macro dropdown in game, and hit "New" + +There are a few options here which can be explained as such: + +Option | What it does +------ | ------------ +Ctrl | Requires CTRL to be held to activate this macro +Alt | Requires ALT to be held to activate this macro +Shift | Requires SHIFT to be held to activate this macro +Auto return | Activating this macro will activate it instantly ("automatically press return after entering this macro") +Target lock | This macro will "lock" as requiring a target (much like espear, assault, etc) +Needs path | This macro needs a path to a target (such as firebreath, illusion, etc) + +When adding the actual macro part, you can have up to 3 individual macros, separated by semicolons, in your command. So, you could do: `take 500000 coins from sack; drop coins`. Some combinations can be very helpful, especially when doing repetitive actions like buying lots of chits. + +Most macros can also have a suffix of @ to yell text while doing the macro, such as `b@I'm zerking, get outta my way!`. + +# Macros + +There are a lot of built in macros. Some may be prefixed with `*`, which means they're built-ins and are zero-time execution. Additionally, some require a name target, so if it says `name`, it likely needs to be used in conjunction with an npc. Any item that works with the hands can use either an item type (cloak, dagger, etc) or a hand position (left or right). + +## Basic Macros + +Macro | Usage | Example | Explanation +----- | ----- | ------- | ----------- +get | `get <itemtype>` | `get corpse` | Take the item type from the ground. +take | `take <itemtype> from <location>` | `take bottle from sack` | Takes a specified item from a location (can be used to take coins from sack and drop, etc) +put | `put <itemtype> in <location>` | `put right in sack` | Takes a specified target and puts it in a location (put items from hand in sack, etc) +drop | `drop <itemtype>` | `drop right` | Drops an item from your hands. +break | `break <itemtype>` | `break scales` | Breaks an item in your hands. If a Barbarian breaks scales, they can get experience. +belt | `belt <itemtype>` | `belt staff` | Moves an item from your hands to your belt. +wield | `wield <itemtype>` | `wield dagger` | Moves an item from your belt to your right hand. +withdraw | `<name>, withdraw <amount>` | `Efo, withdraw 500000` | Withdraws a specified amount from your bank and places it on the counter. +deposit | `<name>, deposit <amount>` | `Efo, deposit 500000` | Deposits a specified amount from the counter into your bank. +appraise | `<name>, appraise <itemtype>` | `Efo, appraise bottle` | Appraises an item and gets a value for it. Can be used to identify similar-looking items such as rings. +trade enable | `trade enable|disable` | | If two players `trade enable`, they can drag items onto each others boxes to place them in one of their empty hands. +critsort enable | `critsort enable|disable` | | Creatures on your hex will always be visible to you first. Primarily useful for zerking Barbarians. +throw | `throw <itemtype> at <name>` | `throw dagger at slith` | Throws an item from your hand at a specified creature. Some items return when thrown, making this good for soloing some lairs. +tan | `<name>, tan` | `Efo, tan` | Tans a hide placed at the feet of a tanner. +count | `count <itemtype>` | `count ring` | Counts the number of the specified item type on the ground. +look | `look at <name>` | `look at seiyria` | Looks at a player. If you have a skill >= 40, you will also appraise their current skill level. +dash | `dash enable|disable` | | Turns on dashes. After every round, dashes appear in your log. +chase | `chase <name>` | `chase seiyria` | Chase after a specified player. +*rtb | `*rtb` | | Moves the item in your right hand to your belt. +*btr | `*btr` | | Moves the first item in your belt to your right hand. +*drink | `*drink` | | Drinks a drinkable bottle from your sack. +*train | `*train 0 ## $$ | `*train 0 10 500000` | Train a certain skill. See the table below for the ## ids. +*assess | `*assess 0 ## | `*assess 0 10` | Assess a certain skill. See the table below for the ## ids. +hug | `hug <name>` | `hug seiyria` | Hug a player. If they have committed an evil action against you, this will forgive them. +sweep | `sweep <dir>` | `sweep e` | Sweep in a direction. Only works if you're holding a broom, else it will try to use Martialist sweep. + +Skill | Id +----- | -- +Greatsword | 01 +Shortsword | 02 +Staff | 03 +Thrown | 04 +Mace | 05 +Bow | 06 +Axe | 07 +Martialist | 08 +Thief | 09 +Healer | 10 +Dagger | 11 +Mentalist | 12 +Brewing | 13 +Longsword | 14 +Polearm | 15 +Climbing | 16 + +## Party Macros + +Macro | Usage | Example | Explanation +----- | ----- | ------- | ----------- +create | `party create <name>` | `party create test` | Creates a party with the given name. +join | `party join <name>` | `party join test` | Join a party, if the leader is visible to you. +give | `party give <name>` | `party give seiyria` | Give party leadership to someone else in the party. Only works if you're the leader. +break | `party break` | | Break the party up. Only works if you're the leader. +leave | `party leave` | | Leave the party. If you're the leader, it's passed to the next person in line. +eject | `party eject <name>` | `party eject seiyria` | Eject a player from the party. + +## Guild Macros + +Macro | Usage | Example | Explanation +----- | ----- | ------- | ----------- +tag | `guild tag <name>` | `guild tag seiyria` | Tags a player into your guild. Only works if you have tagging rights. +eject | `guild eject <name>` | `guild eject seiyria` | Ejects a player from your guild. Only works if you have tagging rights. + +## Class Macros + +Macro | Usage | Class | Explanation +----- | ----- | ------- | ----------- +b | `b` | Barbarian | Begin berserking. When "you increase your rage," there is no more berserking to be done. +arg | `arg` | Barbarian | Initiate automatic attacks on valid targets. Sometimes you might hit friendlies, so beware. + + +## Emote Macros + +All emotes are used like so: `i <emote>`. Additionally, most emotes support emoting at a person, such as `i <emote> <name>`. The only emotes that do not support this are `think` and `rofl`. + +Credits to ROAR guild for these. + +Macro | Example Result +----- | ------- +scream | `Seiyria screams!` +growl | `Seiyria growls!` +grumble | `Seiyria grumbles!` +holler | `Seiyria hollers!` +yell | `Seiyria yells!` +jostle | `Seiyria jostles!` +sing | `Seiyria sings!` +wink | `Seiyria winks!` +think | `Nothing seems to come to mind.` +pinch | `Seiyria pinches!` +rofl | `Seiyria rolls on the floor laughing!` +spit | `Seiyria spits!` +tickle | `Seiyria tickles!` +dance | `Seiyria dances!` +sneeze | `Seiyria sneezes!` +scratch | `Seiyria scratches!` +kiss | `Seiyria kisses!` +agree | `Seiyria agrees!` +mock | `Seiyria mocks!` +prod | `Seiyria prods!` +disagree | `Seiyria disagrees!` + +## Macro combinations + +Since macros can be combined, here are some useful examples of what you can do with macro combination. + +Macro | Explanation +----- | ----------- +`drop left; steal from` | Drop the item in your left hand, and steal from the clicked target. Useful for skilling thief. +`belt right; take bottle from sack; drink bottle` | Drink an IH bottle if your hands are full. +`drop bottle; wield sword` | Drop the bottle from the previous macro, then re-wield the item from your belt. diff --git a/_other/root.md b/_other/root.md new file mode 100644 index 0000000..648333f --- /dev/null +++ b/_other/root.md @@ -0,0 +1,9 @@ +--- +title: "Other Information" +permalink: /other/ +excerpt: "Other Information" +--- + +{% include base_path %} + +This section contains information on miscellaneous areas of the game, including macros, exp charts, and more. diff --git a/_pages/about.md b/_pages/about.md deleted file mode 100644 index 60d04b0..0000000 --- a/_pages/about.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -permalink: /about/ -title: "About" -excerpt: "Minimal Mistakes is a flexible two-column Jekyll theme." -layouts_gallery: - - url: mm-layout-splash.png - image_path: mm-layout-splash.png - alt: "splash layout example" - - url: mm-layout-single-meta.png - image_path: mm-layout-single-meta.png - alt: "single layout with comments and related posts" - - url: mm-layout-archive.png - image_path: mm-layout-archive.png - alt: "archive layout example" -modified: 2016-04-18T16:39:37-04:00 ---- - -{% include base_path %} - -Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your personal site, blog, or portfolio on GitHub or self-hosting on your own server. As the name implies --- styling is purposely minimalistic to be enhanced and customized by you :smile:. - -The theme includes responsive layouts (`single`, `archive`, and `splash` pages) that look great on mobile and desktop browsers. - -{% include gallery id="layouts_gallery" caption="Examples of included layouts `splash`, `single`, and `archive`." %} - -[Install the Theme]({{ base_path }}/docs/quick-start-guide/){: .btn .btn--success .btn--large} - -## Notable Features - -- Compatible with Jekyll 3.x and GitHub Pages -- Several layout options (single, archive, splash pages) -- SEO optimized with support for [Twitter Cards](https://dev.twitter.com/cards/overview) and [Open Graph](http://ogp.me/) data -- Optional header images, sidebars, table of contents, galleries, related posts, breadcrumb links, and more. -- Optional comments ([Disqus](https://disqus.com/), [Facebook](https://developers.facebook.com/docs/plugins/comments), Google+, and custom) -- Optional analytics ([Google Analytics](https://www.google.com/analytics/) and custom) - -## Demo Pages - -| Name | Description | -| ------------------------------------------- | ----------------------------------------------------- | -| [Post with Header Image][header-image-post] | A post with a large header image. | -| [HTML Tags and Formatting Post][html-tags-post] | A variety of common markup showing how the theme styles them. | -| [Syntax Highlighting Post][syntax-post] | Post displaying highlighted code. | -| [Post with a Gallery][gallery-post] | A post showing several images wrapped in `<figure>` elements. | -| [Sample Collection Page][sample-collection] | Single page from a collection. | -| [Categories Archive][categories-archive] | Posts grouped by category. | -| [Tags Archive][tags-archive] | Posts grouped by tags. | - -For even more demo pages check the [posts archive][year-archive]. - -[header-image-post]: {{ base_path }}{% post_url 2012-03-15-layout-header-image-text-readability %} -[gallery-post]: {{ base_path }}{% post_url 2010-09-09-post-gallery %} -[html-tags-post]: {{ base_path }}{% post_url 2013-01-11-markup-html-tags-and-formatting %} -[syntax-post]: {{ base_path }}{% post_url 2013-08-16-markup-syntax-highlighting %} -[sample-collection]: {{ base_path }}/recipes/chocolate-chip-cookies/ -[categories-archive]: {{ base_path }}/categories/ -[tags-archive]: {{ base_path }}/tags/ -[year-archive]: {{ base_path }}/year-archive/ - ---- - -## Credits - -### Icons + Demo Images: - -- [The Noun Project](https://thenounproject.com) -- Garrett Knoll, Arthur Shlain, and [tracy tam](https://thenounproject.com/tracytam) -- [Font Awesome](http://fortawesome.github.io/Font-Awesome/) -- [Unsplash](https://unsplash.com/) - -### Other: - -- [Jekyll](http://jekyllrb.com/) -- [jQuery](http://jquery.com/) -- [Susy](http://susy.oddbird.net/) -- [Breakpoint](http://breakpoint-sass.com/) -- [Magnific Popup](http://dimsemenov.com/plugins/magnific-popup/) -- [FitVids.JS](http://fitvidsjs.com/) -- Greedy Navigation - [lukejacksonn](http://codepen.io/lukejacksonn/pen/PwmwWV) -- [jQuery Smooth Scroll](https://github.com/kswedberg/jquery-smooth-scroll) -- [Stickyfill](https://github.com/wilddeer/stickyfill) - ---- - -Minimal Mistakes is designed, developed, and maintained by Michael Rose. Just another boring, tattooed, designer from Buffalo New York. \ No newline at end of file diff --git a/_pages/home.md b/_pages/home.md index 65950f3..58d14ec 100644 --- a/_pages/home.md +++ b/_pages/home.md @@ -5,7 +5,22 @@ header: overlay_color: "#5e616c" overlay_image: mm-home-page-feature.jpg cta_label: "<i class='fa fa-arrow-circle-right'></i> Check it out" - cta_url: "/docs/quick-start-guide/" + cta_url: "/scenarios/" caption: excerpt: 'A humble fansite that aggregates information I consider to be important, as well as building on it to provide the latest SDC+ information.' +feature_row: + - title: "Scenario Information" + excerpt: "Information about all of the latest scenarios (items, quests, places), and maybe some older ones." + url: "/scenarios/" + btn_label: "Go" + - title: "Class Information" + excerpt: "Information about all of the classes, including quirks, tiers, CH maxes and more." + url: "/classes/" + btn_label: "Go" + - title: "Other Information" + excerpt: "Information about macros, experience levels, skill payments and more" + url: "/other/" + btn_label: "Go" --- + +{% include feature_row %} diff --git a/_pets/lhasa-apso.md b/_pets/lhasa-apso.md deleted file mode 100644 index 2673b6b..0000000 --- a/_pets/lhasa-apso.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: "Lhasa Apso" -excerpt: "The Lhasa Apso is a non-sporting dog breed originating in Tibet." ---- - -> The Lhasa Apso (/ˈlɑːsə ˈæpsoʊ/ lah-sə ap-soh) is a non-sporting dog breed originating in Tibet. It was bred as an interior sentinel in the Buddhist monasteries, to alert the monks to any intruders who entered. Lhasa is the capital city of Tibet, and apso is a word in the Tibetan language meaning "bearded", so, Lhasa Apso simply means "long-haired Lhasa dog". There are, however, some who claim that the word "apso" is a form of the Tibetan word "rapso", meaning "goat-like", which would make the equivalent translation "wooly Lhasa dog". - -> <cite>From Wikipedia, the free encyclopedia</cite> \ No newline at end of file diff --git a/_pets/tabby.md b/_pets/tabby.md deleted file mode 100644 index b62b674..0000000 --- a/_pets/tabby.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: "Tabby" -excerpt: "A tabby is any domestic cat that has a coat featuring distinctive stripes, dots, lines or swirling patterns, usually with a mark resembling an 'M' on its forehead." ---- - -> A tabby is any domestic cat that has a coat featuring distinctive stripes, dots, lines or swirling patterns, usually together with a mark resembling an 'M' on its forehead. Tabbies are sometimes erroneously assumed to be a cat breed. In fact, the tabby pattern is found in many breeds, as well as among the general mixed-breed population. The tabby pattern is a naturally occurring feature that may be related to the coloration of the domestic cat's direct ancestor, the African wildcat, which (along with the European wildcat and Asiatic wildcat) has a similar coloration. - -> <cite>From Wikipedia, the free encyclopedia</cite> \ No newline at end of file diff --git a/_portfolio/foo-bar-website.md b/_portfolio/foo-bar-website.md deleted file mode 100644 index 79d9e82..0000000 --- a/_portfolio/foo-bar-website.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "Foo Bar Identity" -excerpt: "Foo Bar design system including logo mark, website design, and branding applications." -header: - image: foo-bar-identity.jpg - teaser: foo-bar-identity-th.jpg -sidebar: - - title: "Role" - image: http://placehold.it/350x250 - image_alt: "logo" - text: "Designer, Front-End Developer" - - title: "Responsibilities" - text: "Reuters try PR stupid commenters should isn't a business model" -gallery: - - url: unsplash-gallery-image-1.jpg - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 1" - - url: unsplash-gallery-image-2.jpg - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 2" - - url: unsplash-gallery-image-3.jpg - image_path: unsplash-gallery-image-3-th.jpg - alt: "placeholder image 3" ---- - -Pictures of Goats section West Seattle Blog dingbat newspaper rubber cement Google+ newsroom cafe news.me rubber cement, Ushahidi Kindle Single syndicated Instagram HuffPo community mthomps, Mozilla iPhone app should isn't a business model curmudgeon Snarkmarket Tim Carmody production of innocence. Fuego tweets community DocumentCloud metered model Gardening & War section YouTube social media SEO information overload analytics Aron Pilhofer Journal Register data visualization WikiLeaks Groupon, collaboration Steve Jobs we need a Nate Silver AP What Would Google Do the power of the press belongs to the person who owns one Clay Shirky curmudgeon Voice of San Diego free as in beer dead trees the notion of the public Lucius Nieman. - -{% include gallery caption="This is a sample gallery to go along with this case study." %} - -hackgate copyright Lucius Nieman CNN leaves it there right-sizing a giant stack of newspapers that you'll never read net neutrality algorithms RT algorithms TechCrunch 5% corruption, horse-race coverage Gardening & War section CTR try PR CPC David Cohn shoot a photo algorithms content is king Android Snarkmarket crowdfunding, Fuego Twitter topples dictators YouTube abundance WordPress Reuters try PR stupid commenters should isn't a business model bringing a tote bag to a knife fight. \ No newline at end of file diff --git a/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md b/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md deleted file mode 100644 index cc4fd5e..0000000 --- a/_posts/2009-05-15-edge-case-nested-and-mixed-lists.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: "Edge Case: Nested and Mixed Lists" -categories: - - Edge Case -tags: - - content - - css - - edge case - - lists - - markup ---- - -Nested and mixed lists are an interesting beast. It's a corner case to make sure that - -* Lists within lists do not break the ordered list numbering order -* Your list styles go deep enough. - -### Ordered -- Unordered -- Ordered - -1. ordered item -2. ordered item - * **unordered** - * **unordered** - 1. ordered item - 2. ordered item -3. ordered item -4. ordered item - -### Ordered -- Unordered -- Unordered - -1. ordered item -2. ordered item - * **unordered** - * **unordered** - * unordered item - * unordered item -3. ordered item -4. ordered item - -### Unordered -- Ordered -- Unordered - -* unordered item -* unordered item - 1. ordered - 2. ordered - * unordered item - * unordered item -* unordered item -* unordered item - -### Unordered -- Unordered -- Ordered - -* unordered item -* unordered item - * unordered - * unordered - 1. **ordered item** - 2. **ordered item** -* unordered item -* unordered item \ No newline at end of file diff --git a/_posts/2009-06-01-edge-case-many-tags.md b/_posts/2009-06-01-edge-case-many-tags.md deleted file mode 100644 index f43509f..0000000 --- a/_posts/2009-06-01-edge-case-many-tags.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: "Edge Case: Many Tags" -categories: - - Edge Case -tags: - - 8BIT - - alignment - - Articles - - captions - - categories - - chat - - comments - - content - - css - - dowork - - edge case - - embeds - - excerpt - - Fail - - featured image - - FTW - - Fun - - gallery - - html - - image - - Jekyll - - layout - - link - - Love - - markup - - Mothership - - Must Read - - Nailed It - - Pictures - - Post Formats - - quote - - standard - - Success - - Swagger - - Tags - - template - - title - - twitter - - Unseen - - video - - YouTube ---- - -This post has many tags. \ No newline at end of file diff --git a/_posts/2009-07-02-edge-case-many-categories.md b/_posts/2009-07-02-edge-case-many-categories.md deleted file mode 100644 index 648c2da..0000000 --- a/_posts/2009-07-02-edge-case-many-categories.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: "Edge Case: Many Categories" -categories: - - aciform - - antiquarianism - - arrangement - - asmodeus - - broder - - buying - - championship - - chastening - - disinclination - - disinfection - - dispatch - - echappee - - enphagy - - equipollent -tags: - - categories - - edge case ---- - -This post has many categories. \ No newline at end of file diff --git a/_posts/2009-08-06-edge-case-no-body-content.md b/_posts/2009-08-06-edge-case-no-body-content.md deleted file mode 100644 index 7b2fa7d..0000000 --- a/_posts/2009-08-06-edge-case-no-body-content.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: "Edge Case: No Body Content" -categories: - - Edge Case -tags: - - content - - edge case - - layout ---- diff --git a/_posts/2009-09-05-edge-case-no-yaml-title.md b/_posts/2009-09-05-edge-case-no-yaml-title.md deleted file mode 100644 index 4e5323f..0000000 --- a/_posts/2009-09-05-edge-case-no-yaml-title.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -categories: - - Edge Case -tags: - - edge case - - layout - - title ---- - -This post has no title specified in the YAML Front Matter. Jekyll should auto-generate a title from the filename. \ No newline at end of file diff --git a/_posts/2009-10-05-edge-case-title-should-not-overflow-the-content-area.md b/_posts/2009-10-05-edge-case-title-should-not-overflow-the-content-area.md deleted file mode 100644 index 6fdc1b8..0000000 --- a/_posts/2009-10-05-edge-case-title-should-not-overflow-the-content-area.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: "Antidisestablishmentarianism" -categories: - - Edge Case -tags: - - content - - css - - edge case - - html - - layout - - title ---- - -## Title should not overflow the content area - -A few things to check for: - - * Non-breaking text in the title, content, and comments should have no adverse effects on layout or functionality. - * Check the browser window / tab title. - * If you are a theme developer, check that this text does not break anything. - -The following CSS properties will help you support non-breaking text. - -```css --ms-word-wrap: break-word; -word-wrap: break-word; -``` \ No newline at end of file diff --git a/_posts/2009-10-05-edge-case-very-long-title.md b/_posts/2009-10-05-edge-case-very-long-title.md deleted file mode 100644 index 29fcb77..0000000 --- a/_posts/2009-10-05-edge-case-very-long-title.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "Suspicio? Bene ... tunc ibimus? Quis uh ... CONEXUS locus his diebus? Quisque semper aliquid videtur, in volutpat mauris. Nolo enim dicere. Vobis neque ab aliis. Ego feci memetipsum explicans. Gus mortuus est. Lorem opus habeo. Jackson Isai? Tu quoque ... A te quidem a ante. Vos scitis quod blinking res Ive 'been vocans super vos? Et conteram illud, et conteram hoc. Maledicant druggie excors. Iam hoc tu facere conatus sum ad te in omni tempore? Ludum mutavit. Verbum est ex. Et ... sunt occid" -categories: - - Edge Case -tags: - - content - - css - - edge case - - html - - layout - - title ---- - -Check for long titles and how they might break a template. \ No newline at end of file diff --git a/_posts/2010-01-07-post-modified.md b/_posts/2010-01-07-post-modified.md deleted file mode 100644 index b7457e2..0000000 --- a/_posts/2010-01-07-post-modified.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "Post: Modified Date" -modified: 2016-03-09T16:20:02-05:00 -categories: - - Post Formats -tags: - - Post Formats - - readability - - standard ---- - -This post has been updated and should show a modified date if used in a layout. - -All children, except one, grow up. They soon know that they will grow up, and the way Wendy knew was this. One day when she was two years old she was playing in a garden, and she plucked another flower and ran with it to her mother. I suppose she must have looked rather delightful, for Mrs. Darling put her hand to her heart and cried, "Oh, why can't you remain like this for ever!" This was all that passed between them on the subject, but henceforth Wendy knew that she must grow up. You always know after you are two. Two is the beginning of the end. \ No newline at end of file diff --git a/_posts/2010-01-07-post-standard.md b/_posts/2010-01-07-post-standard.md deleted file mode 100644 index cd83ea0..0000000 --- a/_posts/2010-01-07-post-standard.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: "Post: Standard" -excerpt_separator: "<!--more-->" -categories: - - Post Formats -tags: - - Post Formats - - readability - - standard ---- - -All children, except one, grow up. They soon know that they will grow up, and the way Wendy knew was this. One day when she was two years old she was playing in a garden, and she plucked another flower and ran with it to her mother. I suppose she must have looked rather delightful, for Mrs. Darling put her hand to her heart and cried, "Oh, why can't you remain like this for ever!" This was all that passed between them on the subject, but henceforth Wendy knew that she must grow up. You always know after you are two. Two is the beginning of the end. - -Mrs. Darling first heard of Peter when she was tidying up her children's minds. It is the nightly custom of every good mother after her children are asleep to rummage in their minds and put things straight for next morning, repacking into their proper places the many articles that have wandered during the day. - -<!--more--> - -This post has a manual excerpt `<!--more-->` set after the second paragraph. The following YAML Front Matter has also be applied: - -```yaml -excerpt_separator: "<!--more-->" -``` - -If you could keep awake (but of course you can't) you would see your own mother doing this, and you would find it very interesting to watch her. It is quite like tidying up drawers. You would see her on her knees, I expect, lingering humorously over some of your contents, wondering where on earth you had picked this thing up, making discoveries sweet and not so sweet, pressing this to her cheek as if it were as nice as a kitten, and hurriedly stowing that out of sight. When you wake in the morning, the naughtiness and evil passions with which you went to bed have been folded up small and placed at the bottom of your mind and on the top, beautifully aired, are spread out your prettier thoughts, ready for you to put on. - -I don't know whether you have ever seen a map of a person's mind. Doctors sometimes draw maps of other parts of you, and your own map can become intensely interesting, but catch them trying to draw a map of a child's mind, which is not only confused, but keeps going round all the time. There are zigzag lines on it, just like your temperature on a card, and these are probably roads in the island, for the Neverland is always more or less an island, with astonishing splashes of colour here and there, and coral reefs and rakish-looking craft in the offing, and savages and lonely lairs, and gnomes who are mostly tailors, and caves through which a river runs, and princes with six elder brothers, and a hut fast going to decay, and one very small old lady with a hooked nose. It would be an easy map if that were all, but there is also first day at school, religion, fathers, the round pond, needle-work, murders, hangings, verbs that take the dative, chocolate pudding day, getting into braces, say ninety-nine, three-pence for pulling out your tooth yourself, and so on, and either these are part of the island or they are another map showing through, and it is all rather confusing, especially as nothing will stand still. - -Of course the Neverlands vary a good deal. John's, for instance, had a lagoon with flamingoes flying over it at which John was shooting, while Michael, who was very small, had a flamingo with lagoons flying over it. John lived in a boat turned upside down on the sands, Michael in a wigwam, Wendy in a house of leaves deftly sewn together. John had no friends, Michael had friends at night, Wendy had a pet wolf forsaken by its parents, but on the whole the Neverlands have a family resemblance, and if they stood still in a row you could say of them that they have each other's nose, and so forth. On these magic shores children at play are for ever beaching their coracles [simple boat]. We too have been there; we can still hear the sound of the surf, though we shall land no more. - -Of all delectable islands the Neverland is the snuggest and most compact, not large and sprawly, you know, with tedious distances between one adventure and another, but nicely crammed. When you play at it by day with the chairs and table-cloth, it is not in the least alarming, but in the two minutes before you go to sleep it becomes very real. That is why there are night-lights. - -Occasionally in her travels through her children's minds Mrs. Darling found things she could not understand, and of these quite the most perplexing was the word Peter. She knew of no Peter, and yet he was here and there in John and Michael's minds, while Wendy's began to be scrawled all over with him. The name stood out in bolder letters than any of the other words, and as Mrs. Darling gazed she felt that it had an oddly cocky appearance. \ No newline at end of file diff --git a/_posts/2010-01-08-post-chat.md b/_posts/2010-01-08-post-chat.md deleted file mode 100644 index e61b3f2..0000000 --- a/_posts/2010-01-08-post-chat.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: "Post: Chat" -categories: - - Post Formats -tags: - - chat - - Post Formats ---- - -Abbott: Strange as it may seem, they give ball players nowadays very peculiar names. - -Costello: Funny names? - -Abbott: Nicknames, nicknames. Now, on the St. Louis team we have Who's on first, What's on second, I Don't Know is on third-- - -Costello: That's what I want to find out. I want you to tell me the names of the fellows on the St. Louis team. - -Abbott: I'm telling you. Who's on first, What's on second, I Don't Know is on third-- - -Costello: You know the fellows' names? - -Abbott: Yes. - -Costello: Well, then who's playing first? - -Abbott: Yes. - -Costello: I mean the fellow's name on first base. - -Abbott: Who. - -Costello: The fellow playin' first base. - -Abbott: Who. - -Costello: The guy on first base. - -Abbott: Who is on first. - -Costello: Well, what are you askin' me for? - -Abbott: I'm not asking you--I'm telling you. Who is on first. - -Costello: I'm asking you--who's on first? - -Abbott: That's the man's name. - -Costello: That's who's name? - -Abbott: Yes. - -Costello: When you pay off the first baseman every month, who gets the money? - -Abbott: Every dollar of it. And why not, the man's entitled to it. - -Costello: Who is? - -Abbott: Yes. - -Costello: So who gets it? - -Abbott: Why shouldn't he? Sometimes his wife comes down and collects it. - -Costello: Who's wife? - -Abbott: Yes. After all, the man earns it. - -Costello: Who does? - -Abbott: Absolutely. - -Costello: Well, all I'm trying to find out is what's the guy's name on first base? - -Abbott: Oh, no, no. What is on second base. - -Costello: I'm not asking you who's on second. - -Abbott: Who's on first! - -Costello: St. Louis has a good outfield? - -Abbott: Oh, absolutely. - -Costello: The left fielder's name? - -Abbott: Why. - -Costello: I don't know, I just thought I'd ask. - -Abbott: Well, I just thought I'd tell you. - -Costello: Then tell me who's playing left field? - -Abbott: Who's playing first. - -Costello: Stay out of the infield! The left fielder's name? - -Abbott: Why. - -Costello: Because. - -Abbott: Oh, he's center field. - -Costello: Wait a minute. You got a pitcher on this team? - -Abbott: Wouldn't this be a fine team without a pitcher? - -Costello: Tell me the pitcher's name. - -Abbott: Tomorrow. - -Costello: Now, when the guy at bat bunts the ball--me being a good catcher--I want to throw the guy out at first base, so I pick up the ball and throw it to who? - -Abbott: Now, that's he first thing you've said right. - -Costello: I DON'T EVEN KNOW WHAT I'M TALKING ABOUT! - -Abbott: Don't get excited. Take it easy. - -Costello: I throw the ball to first base, whoever it is grabs the ball, so the guy runs to second. Who picks up the ball and throws it to what. What throws it to I don't know. I don't know throws it back to tomorrow--a triple play. - -Abbott: Yeah, it could be. - -Costello: Another guy gets up and it's a long ball to center. - -Abbott: Because. - -Costello: Why? I don't know. And I don't care. - -Abbott: What was that? - -Costello: I said, I DON'T CARE! - -Abbott: Oh, that's our shortstop! \ No newline at end of file diff --git a/_posts/2010-02-05-post-notice.md b/_posts/2010-02-05-post-notice.md deleted file mode 100644 index 071c789..0000000 --- a/_posts/2010-02-05-post-notice.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: "Post: Notice" -categories: - - Post Formats -tags: - - Post Formats - - notice ---- - -A notice displays information that explains nearby content. Often used to call attention to a particular detail. - -When using Kramdown `{: .notice}` can be added after a sentence to assign the `.notice` to the `<p></p>` element. - -**Changes in Service:** We just updated our [privacy policy](#) here to better service our customers. We recommend reviewing the changes. -{: .notice} - -**Primary Notice:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. [Praesent libero](#). Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet. -{: .notice--primary} - -**Info Notice:** Lorem ipsum dolor sit amet, [consectetur adipiscing elit](#). Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet. -{: .notice--info} - -**Warning Notice:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. [Integer nec odio](#). Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet. -{: .notice--warning} - -**Danger Notice:** Lorem ipsum dolor sit amet, [consectetur adipiscing](#) elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet. -{: .notice--danger} - -**Success Notice:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at [nibh elementum](#) imperdiet. -{: .notice--success} - -Want to wrap several paragraphs or other elements in a notice? Using Liquid to capture the content and then filter it with `markdownify` is a good way to go. - -```html -{% raw %}{% capture notice-2 %} -#### New Site Features - -* You can now have cover images on blog pages -* Drafts will now auto-save while writing -{% endcapture %}{% endraw %} - -<div class="notice">{% raw %}{{ notice-2 | markdownify }}{% endraw %}</div> -``` - -{% capture notice-2 %} -#### New Site Features - -* You can now have cover images on blog pages -* Drafts will now auto-save while writing -{% endcapture %} - -<div class="notice"> - {{ notice-2 | markdownify }} -</div> - -Or you could skip the capture and stick with straight HTML. - -```html -<div class="notice"> - <h4>Message</h4> - <p>A basic message.</p> -</div> -``` - -<div class="notice"> - <h4>Message</h4> - <p>A basic message.</p> -</div> \ No newline at end of file diff --git a/_posts/2010-02-05-post-quote.md b/_posts/2010-02-05-post-quote.md deleted file mode 100644 index 231f70b..0000000 --- a/_posts/2010-02-05-post-quote.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: "Post: Quote" -categories: - - Post Formats -tags: - - Post Formats - - quote ---- - -> Only one thing is impossible for God: To find any sense in any copyright law on the planet. - -> <cite><a href="http://www.brainyquote.com/quotes/quotes/m/marktwain163473.html">Mark Twain</a></cite> \ No newline at end of file diff --git a/_posts/2010-03-07-post-link.md b/_posts/2010-03-07-post-link.md deleted file mode 100644 index 6a8005e..0000000 --- a/_posts/2010-03-07-post-link.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: "Post: Link" -categories: - - Post Formats -tags: - - link - - Post Formats -link: https://github.com ---- - -This theme supports **link posts**, made famous by John Gruber. To use, just add `link: http://url-you-want-linked` to the post's YAML front matter and you're done. - -> And this is how a quote looks. - -Some [link](#) can also be shown. \ No newline at end of file diff --git a/_posts/2010-06-02-post-video-youtube.md b/_posts/2010-06-02-post-video-youtube.md deleted file mode 100644 index 16bc910..0000000 --- a/_posts/2010-06-02-post-video-youtube.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: "Post: Video (YouTube)" -categories: - - Post Formats -tags: - - Post Formats ---- - -YouTube video embed below. - -<iframe width="640" height="360" src="https://www.youtube-nocookie.com/embed/l2Of1-d5E5o?controls=0&showinfo=0" frameborder="0" allowfullscreen></iframe> \ No newline at end of file diff --git a/_posts/2010-08-05-post-image-linked.md b/_posts/2010-08-05-post-image-linked.md deleted file mode 100644 index af3f3fe..0000000 --- a/_posts/2010-08-05-post-image-linked.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: "Post: Image (with Link)" -categories: - - Post Formats -tags: - - image - - Post Formats ---- - -[![foo](https://farm5.staticflickr.com/4073/4939853213_33ffc0290b_b.jpg)](https://flic.kr/p/8ww3fZ) \ No newline at end of file diff --git a/_posts/2010-08-05-post-image-standard.md b/_posts/2010-08-05-post-image-standard.md deleted file mode 100644 index 9d19bd8..0000000 --- a/_posts/2010-08-05-post-image-standard.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: "Post: Image (Standard)" -categories: - - Post Formats -tags: - - image - - Post Formats ---- - -The preferred way of using images is placing them in the `/images/` directory and referencing them with an absolute path. Prepending the filename with `{% raw %}{{ site.url }}{{ site.baseurl }}/images/{% endraw %}` will make sure your images display properly in feeds and such. - -Standard image with no width modifier classes applied. - -**HTML:** - -```html -{% raw %}<img src="{{ site.url }}{{ site.baseurl }}/images/filename.jpg" alt="">{% endraw %} -``` - -**or Kramdown:** - -```markdown -{% raw %}![alt]({{ site.url }}{{ site.baseurl }}/images/filename.jpg){% endraw %} -``` - -![Unsplash image 9]({{ site.url }}{{ site.baseurl }}/images/unsplash-image-9.jpg) - -Image that fills page content container by adding the `.full` class with: - -**HTML:** - -```html -{% raw %}<img src="{{ site.url }}{{ site.baseurl }}/images/filename.jpg" alt="" class="full">{% endraw %} -``` - -**or Kramdown:** - -```markdown -{% raw %}![alt]({{ site.url }}{{ site.baseurl }}/images/filename.jpg) -{: .full}{% endraw %} -``` - -![Unsplash image 10]({{ site.url }}{{ site.baseurl }}/images/unsplash-image-10.jpg) -{: .full} \ No newline at end of file diff --git a/_posts/2010-08-06-post-image-linked-caption.md b/_posts/2010-08-06-post-image-linked-caption.md deleted file mode 100644 index ada6f6a..0000000 --- a/_posts/2010-08-06-post-image-linked-caption.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: "Post: Image (Linked with Caption)" -categories: - - Post Formats -tags: - - image - - Post Formats ---- - -{% capture fig_img %} -[![Foo](https://farm5.staticflickr.com/4134/4940462712_7c28420b27_b.jpg)](https://flic.kr/p/8wzarA) -{% endcapture %} - -{% capture fig_caption %} -Stairs? Were we're going we don't need no stairs. -{% endcapture %} - -<figure> - {{ fig_img | markdownify | remove: "<p>" | remove: "</p>" }} - <figcaption>{{ fig_caption | markdownify | remove: "<p>" | remove: "</p>" }}</figcaption> -</figure> \ No newline at end of file diff --git a/_posts/2010-08-07-post-image-caption.md b/_posts/2010-08-07-post-image-caption.md deleted file mode 100644 index 35a3f1c..0000000 --- a/_posts/2010-08-07-post-image-caption.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Post: Image (Caption)" -categories: - - Post Formats -tags: - - image - - Post Formats ---- - -{% include base_path %} - -{% capture fig_img %} -![Foo]({{ base_path }}/images/unsplash-gallery-image-3.jpg) -{% endcapture %} - -<figure> - {{ fig_img | markdownify | remove: "<p>" | remove: "</p>" }} - <figcaption>Photo from Unsplash.</figcaption> -</figure> \ No newline at end of file diff --git a/_posts/2010-09-09-post-gallery.md b/_posts/2010-09-09-post-gallery.md deleted file mode 100644 index a876a2c..0000000 --- a/_posts/2010-09-09-post-gallery.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: "Post: Gallery" -categories: - - Post Formats -tags: - - gallery - - Post Formats - - tiled -gallery: - - url: unsplash-gallery-image-1.jpg - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 1" - title: "Image 1 title caption" - - url: unsplash-gallery-image-2.jpg - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 2" - title: "Image 2 title caption" - - url: unsplash-gallery-image-3.jpg - image_path: unsplash-gallery-image-3-th.jpg - alt: "placeholder image 3" - title: "Image 3 title caption" - - url: unsplash-gallery-image-1.jpg - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 4" - title: "Image 4 title caption" - - url: unsplash-gallery-image-2.jpg - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 5" - title: "Image 5 title caption" - - url: unsplash-gallery-image-3.jpg - image_path: unsplash-gallery-image-3-th.jpg - alt: "placeholder image 6" - title: "Image 6 title caption" - - url: unsplash-gallery-image-1.jpg - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 7" - title: "Image 7 title caption" - - url: unsplash-gallery-image-2.jpg - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 8" - title: "Image 8 title caption" - - url: unsplash-gallery-image-3.jpg - image_path: unsplash-gallery-image-3-th.jpg - alt: "placeholder image 9" - title: "Image 9 title caption" - - url: unsplash-gallery-image-1.jpg - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 10" - title: "Image 10 title caption" - - url: unsplash-gallery-image-2.jpg - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 11" - title: "Image 11 title caption" - - url: unsplash-gallery-image-3.jpg - image_path: unsplash-gallery-image-3-th.jpg - alt: "placeholder image 12" - title: "Image 12 title caption" -gallery2: - - url: https://flic.kr/p/8a6Ven - image_path: https://farm2.staticflickr.com/1272/4697500467_8294dac099_q.jpg - alt: "Black and grays with a hint of green" - - url: https://flic.kr/p/8a738X - image_path: https://farm5.staticflickr.com/4029/4697523701_249e93ba23_q.jpg - alt: "Made for open text placement" - - url: https://flic.kr/p/8a6VXP - image_path: https://farm5.staticflickr.com/4046/4697502929_72c612c636_q.jpg - alt: "Fog in the trees" -gallery3: - - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 2" - - image_path: unsplash-gallery-image-4-th.jpg - alt: "placeholder image 4" ---- - -These are gallery tests for image wrapped in `<figure>` elements. - -To place a gallery add the necessary YAML Front Matter: - -```yaml -gallery: - - url: unsplash-gallery-image-1.jpg - image_path: unsplash-gallery-image-1-th.jpg - alt: "placeholder image 1" - title: "Image 1 title caption" - - url: unsplash-gallery-image-2.jpg - image_path: unsplash-gallery-image-2-th.jpg - alt: "placeholder image 2" - title: "Image 2 title caption" - - url: unsplash-gallery-image-3.jpg - image_path: unsplash-gallery-image-3-th.jpg - alt: "placeholder image 3" - title: "Image 3 title caption" - - url: unsplash-gallery-image-4.jpg - image_path: unsplash-gallery-image-4-th.jpg - alt: "placeholder image 4" - title: "Image 4 title caption" -``` - -And then drop-in the gallery include --- gallery `caption` is optional. - -```liquid -{% raw %}{% include gallery caption="This is a sample gallery with **Markdown support**." %}{% endraw %} -``` - -{% include gallery caption="This is a sample gallery with **Markdown support**." %} - -This is some text after the gallery just to make sure that everything aligns properly. - -Here comes another gallery, this time set the `id` to match 2nd gallery hash in YAML Front Matter. - -```yaml -gallery2: - - url: https://flic.kr/p/8a6Ven - image_path: https://farm2.staticflickr.com/1272/4697500467_8294dac099_q.jpg - alt: "Black and grays with a hint of green" - - url: https://flic.kr/p/8a738X - image_path: https://farm5.staticflickr.com/4029/4697523701_249e93ba23_q.jpg - alt: "Made for open text placement" - - url: https://flic.kr/p/8a6VXP - image_path: https://farm5.staticflickr.com/4046/4697502929_72c612c636_q.jpg - alt: "Fog in the trees" -``` - -And place it like so: - -```liquid -{% raw %}{% include gallery id="gallery2" caption="This is a second gallery example with images hosted externally." %}{% endraw %} -``` - -{% include gallery id="gallery2" caption="This is a second gallery example with images hosted externally." %} - -And for giggles one more gallery just to make sure this works. To fill page content container add `class="full"`. - -{% include gallery id="gallery3" class="full" caption="This is a third gallery example with two images and fills the entire content container." %} \ No newline at end of file diff --git a/_posts/2010-09-10-post-twitter-embeds.md b/_posts/2010-09-10-post-twitter-embeds.md deleted file mode 100644 index 7c5c418..0000000 --- a/_posts/2010-09-10-post-twitter-embeds.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: "Post: Twitter Embed" -categories: - - Media -tags: - - content - - embeds - - media - - twitter ---- - -<blockquote class="twitter-tweet" data-lang="en"><p lang="en" dir="ltr">🎨 Finally got around to adding all my <a href="https://twitter.com/procreateapp">@procreateapp</a> creations with time lapse videos <a href="https://t.co/1nNbkefC3L">https://t.co/1nNbkefC3L</a> <a href="https://t.co/gcNLJoJ0Gn">pic.twitter.com/gcNLJoJ0Gn</a></p>— Michael Rose (@mmistakes) <a href="https://twitter.com/mmistakes/status/662678050795094016">November 6, 2015</a></blockquote> -<script async src="//platform.twitter.com/widgets.js" charset="utf-8"></script> - -This post tests Twitter Embeds. \ No newline at end of file diff --git a/_posts/2010-10-25-post-future-date.md b/_posts/2010-10-25-post-future-date.md deleted file mode 100644 index 7d1b203..0000000 --- a/_posts/2010-10-25-post-future-date.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: "Post: Future Date" -date: 9999-12-31 -categories: - - Post ---- - -This post lives in the future and is dated {{ page.date | date: "%c" }}. When building Jekyll with the `--future` flag it should appear. \ No newline at end of file diff --git a/_posts/2012-01-02-layout-comments-disabled.md b/_posts/2012-01-02-layout-comments-disabled.md deleted file mode 100644 index ab69a52..0000000 --- a/_posts/2012-01-02-layout-comments-disabled.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "Layout: Comments Disabled" -comments: false -categories: - - Layout - - Uncategorized -tags: - - comments - - layout ---- - -This post has its comments disabled. - -There should be no comment form. \ No newline at end of file diff --git a/_posts/2012-01-02-layout-comments.md b/_posts/2012-01-02-layout-comments.md deleted file mode 100644 index cf697b8..0000000 --- a/_posts/2012-01-02-layout-comments.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: "Layout: Comments Enabled" -comments: true -categories: - - Layout - - Uncategorized -tags: - - comments - - layout ---- - -This post should display comments. \ No newline at end of file diff --git a/_posts/2012-01-02-layout-read-time-disabled.md b/_posts/2012-01-02-layout-read-time-disabled.md deleted file mode 100644 index d889922..0000000 --- a/_posts/2012-01-02-layout-read-time-disabled.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Layout: Read Time Disabled" -read_time: false -tags: - - read time ---- - -This post has reading time disabled. The estimated time that it takes to read this post should not be showing if `read_time: false` is set in `_config.yml` or in this post's YAML Front Matter. - -If you could keep awake (but of course you can't) you would see your own mother doing this, and you would find it very interesting to watch her. It is quite like tidying up drawers. You would see her on her knees, I expect, lingering humorously over some of your contents, wondering where on earth you had picked this thing up, making discoveries sweet and not so sweet, pressing this to her cheek as if it were as nice as a kitten, and hurriedly stowing that out of sight. When you wake in the morning, the naughtiness and evil passions with which you went to bed have been folded up small and placed at the bottom of your mind and on the top, beautifully aired, are spread out your prettier thoughts, ready for you to put on. - -I don't know whether you have ever seen a map of a person's mind. Doctors sometimes draw maps of other parts of you, and your own map can become intensely interesting, but catch them trying to draw a map of a child's mind, which is not only confused, but keeps going round all the time. There are zigzag lines on it, just like your temperature on a card, and these are probably roads in the island, for the Neverland is always more or less an island, with astonishing splashes of colour here and there, and coral reefs and rakish-looking craft in the offing, and savages and lonely lairs, and gnomes who are mostly tailors, and caves through which a river runs, and princes with six elder brothers, and a hut fast going to decay, and one very small old lady with a hooked nose. It would be an easy map if that were all, but there is also first day at school, religion, fathers, the round pond, needle-work, murders, hangings, verbs that take the dative, chocolate pudding day, getting into braces, say ninety-nine, three-pence for pulling out your tooth yourself, and so on, and either these are part of the island or they are another map showing through, and it is all rather confusing, especially as nothing will stand still. - -Of course the Neverlands vary a good deal. John's, for instance, had a lagoon with flamingoes flying over it at which John was shooting, while Michael, who was very small, had a flamingo with lagoons flying over it. John lived in a boat turned upside down on the sands, Michael in a wigwam, Wendy in a house of leaves deftly sewn together. John had no friends, Michael had friends at night, Wendy had a pet wolf forsaken by its parents, but on the whole the Neverlands have a family resemblance, and if they stood still in a row you could say of them that they have each other's nose, and so forth. On these magic shores children at play are for ever beaching their coracles [simple boat]. We too have been there; we can still hear the sound of the surf, though we shall land no more. - -Of all delectable islands the Neverland is the snuggest and most compact, not large and sprawly, you know, with tedious distances between one adventure and another, but nicely crammed. When you play at it by day with the chairs and table-cloth, it is not in the least alarming, but in the two minutes before you go to sleep it becomes very real. That is why there are night-lights. - -Occasionally in her travels through her children's minds Mrs. Darling found things she could not understand, and of these quite the most perplexing was the word Peter. She knew of no Peter, and yet he was here and there in John and Michael's minds, while Wendy's began to be scrawled all over with him. The name stood out in bolder letters than any of the other words, and as Mrs. Darling gazed she felt that it had an oddly cocky appearance. \ No newline at end of file diff --git a/_posts/2012-01-02-layout-read-time.md b/_posts/2012-01-02-layout-read-time.md deleted file mode 100644 index a636e0a..0000000 --- a/_posts/2012-01-02-layout-read-time.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Layout: Read Time Enabled" -read_time: true -tags: - - read time ---- - -This post has reading time enabled. The estimated time that it takes to read this post should show if also enabled in `_config.yml` with `read_time: true`. - -If you could keep awake (but of course you can't) you would see your own mother doing this, and you would find it very interesting to watch her. It is quite like tidying up drawers. You would see her on her knees, I expect, lingering humorously over some of your contents, wondering where on earth you had picked this thing up, making discoveries sweet and not so sweet, pressing this to her cheek as if it were as nice as a kitten, and hurriedly stowing that out of sight. When you wake in the morning, the naughtiness and evil passions with which you went to bed have been folded up small and placed at the bottom of your mind and on the top, beautifully aired, are spread out your prettier thoughts, ready for you to put on. - -I don't know whether you have ever seen a map of a person's mind. Doctors sometimes draw maps of other parts of you, and your own map can become intensely interesting, but catch them trying to draw a map of a child's mind, which is not only confused, but keeps going round all the time. There are zigzag lines on it, just like your temperature on a card, and these are probably roads in the island, for the Neverland is always more or less an island, with astonishing splashes of colour here and there, and coral reefs and rakish-looking craft in the offing, and savages and lonely lairs, and gnomes who are mostly tailors, and caves through which a river runs, and princes with six elder brothers, and a hut fast going to decay, and one very small old lady with a hooked nose. It would be an easy map if that were all, but there is also first day at school, religion, fathers, the round pond, needle-work, murders, hangings, verbs that take the dative, chocolate pudding day, getting into braces, say ninety-nine, three-pence for pulling out your tooth yourself, and so on, and either these are part of the island or they are another map showing through, and it is all rather confusing, especially as nothing will stand still. - -Of course the Neverlands vary a good deal. John's, for instance, had a lagoon with flamingoes flying over it at which John was shooting, while Michael, who was very small, had a flamingo with lagoons flying over it. John lived in a boat turned upside down on the sands, Michael in a wigwam, Wendy in a house of leaves deftly sewn together. John had no friends, Michael had friends at night, Wendy had a pet wolf forsaken by its parents, but on the whole the Neverlands have a family resemblance, and if they stood still in a row you could say of them that they have each other's nose, and so forth. On these magic shores children at play are for ever beaching their coracles [simple boat]. We too have been there; we can still hear the sound of the surf, though we shall land no more. - -Of all delectable islands the Neverland is the snuggest and most compact, not large and sprawly, you know, with tedious distances between one adventure and another, but nicely crammed. When you play at it by day with the chairs and table-cloth, it is not in the least alarming, but in the two minutes before you go to sleep it becomes very real. That is why there are night-lights. - -Occasionally in her travels through her children's minds Mrs. Darling found things she could not understand, and of these quite the most perplexing was the word Peter. She knew of no Peter, and yet he was here and there in John and Michael's minds, while Wendy's began to be scrawled all over with him. The name stood out in bolder letters than any of the other words, and as Mrs. Darling gazed she felt that it had an oddly cocky appearance. \ No newline at end of file diff --git a/_posts/2012-01-02-layout-related-posts-disabled.md b/_posts/2012-01-02-layout-related-posts-disabled.md deleted file mode 100644 index 3831e74..0000000 --- a/_posts/2012-01-02-layout-related-posts-disabled.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "Layout: Related Posts Disabled" -related: false -categories: - - Layout - - Uncategorized -tags: - - related posts - - layout ---- - -This post has related posts disabled. - -Related post links should not appear. \ No newline at end of file diff --git a/_posts/2012-01-02-layout-related-posts.md b/_posts/2012-01-02-layout-related-posts.md deleted file mode 100644 index 0293bc6..0000000 --- a/_posts/2012-01-02-layout-related-posts.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: "Layout: Related Posts Enabled" -related: true -categories: - - Layout - - Uncategorized -tags: - - related posts - - layout ---- - -This post has related posts enabled. \ No newline at end of file diff --git a/_posts/2012-01-02-layout-sharing-disabled.md b/_posts/2012-01-02-layout-sharing-disabled.md deleted file mode 100644 index c69d8bb..0000000 --- a/_posts/2012-01-02-layout-sharing-disabled.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "Layout: Social Sharing Links Disabled" -share: false -categories: - - Layout - - Uncategorized -tags: - - social - - layout ---- - -This post has social sharing disabled. - -Social sharing links should not appear. \ No newline at end of file diff --git a/_posts/2012-01-02-layout-sharing.md b/_posts/2012-01-02-layout-sharing.md deleted file mode 100644 index 09808f1..0000000 --- a/_posts/2012-01-02-layout-sharing.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: "Layout: Social Sharing Links Enabled" -share: true -categories: - - Layout - - Uncategorized -tags: - - social - - layout ---- - -This post should display social sharing links. \ No newline at end of file diff --git a/_posts/2012-01-03-layout-read-time-comments-sharing-related-posts-disabled.md b/_posts/2012-01-03-layout-read-time-comments-sharing-related-posts-disabled.md deleted file mode 100644 index dacb207..0000000 --- a/_posts/2012-01-03-layout-read-time-comments-sharing-related-posts-disabled.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Layout: Reading Time, Comments, Social Sharing Links, and Related Posts Disabled" -read_time: false -comments: false -share: false -related: false -categories: - - Layout - - Uncategorized -tags: - - related posts - - social - - comments - - layout ---- - -This post has reading time, comments, social sharing links, and related posts disabled. - -Reading time, comments, social sharing and related post links should not appear. \ No newline at end of file diff --git a/_posts/2012-01-03-layout-table-of-contents-post.md b/_posts/2012-01-03-layout-table-of-contents-post.md deleted file mode 100644 index d9483ca..0000000 --- a/_posts/2012-01-03-layout-table-of-contents-post.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: "Layout: Post with Table Of Contents" -header: - image: unsplash-image-9.jpg - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" -tags: - - table of contents ---- - -{% include toc title="Unique Title" icon="file-text" %} - -Testing Kramdown auto-generated table of contents with unique title and icon assigned in the include like so: - -```liquid -{% raw %}{% include toc title="Unique Title" icon="file-text" %}{% endraw %} -``` - -## HTML Elements - -Below is just about everything you'll need to style in the theme. Check the source code to see the many embedded elements within paragraphs. - -<h1>Heading 1</h1> -<h2>Heading 2</h2> -<h3>Heading 3</h3> -<h4>Heading 4</h4> -<h5>Heading 5</h5> -<h6>Heading 6</h6> - -## Body text - -Lorem ipsum dolor sit amet, test link adipiscing elit. **This is strong**. Nullam dignissim convallis est. Quisque aliquam. - -![Smithsonian Image]({{ site.url }}{{ site.baseurl }}/images/3953273590_704e3899d5_m.jpg) -{: .image-right} - -*This is emphasized*. Donec faucibus. Nunc iaculis suscipit dui. 53 = 125. Water is H2O. Nam sit amet sem. Aliquam libero nisi, imperdiet at, tincidunt nec, gravida vehicula, nisl. The New York Times (That’s a citation). Underline.Maecenas ornare tortor. Donec sed tellus eget sapien fringilla nonummy. Mauris a ante. Suspendisse quam sem, consequat at, commodo vitae, feugiat in, nunc. Morbi imperdiet augue quis tellus. - -HTML and CSS are our tools. Mauris a ante. Suspendisse quam sem, consequat at, commodo vitae, feugiat in, nunc. Morbi imperdiet augue quis tellus. Praesent mattis, massa quis luctus fermentum, turpis mi volutpat justo, eu volutpat enim diam eget metus. - -### Blockquotes - -> Lorem ipsum dolor sit amet, test link adipiscing elit. Nullam dignissim convallis est. Quisque aliquam. - -## List Types - -### Ordered Lists - -1. Item one - 1. sub item one - 2. sub item two - 3. sub item three -2. Item two - -### Unordered Lists - -* Item one -* Item two -* Item three - -## Tables - -| Header1 | Header2 | Header3 | -|:--------|:-------:|--------:| -| cell1 | cell2 | cell3 | -| cell4 | cell5 | cell6 | -|---- -| cell1 | cell2 | cell3 | -| cell4 | cell5 | cell6 | -|===== -| Foot1 | Foot2 | Foot3 -{: rules="groups"} - -## Code Snippets - -```css -#container { - float: left; - margin: 0 -240px 0 0; - width: 100%; -} -``` - -## Buttons - -Make any link standout more when applying the `.btn` class. - -```html -<a href="#" class="btn btn-success">Success Button</a> -``` - -<div markdown="0"><a href="#" class="btn">Primary Button</a></div> -<div markdown="0"><a href="#" class="btn btn--success">Success Button</a></div> -<div markdown="0"><a href="#" class="btn btn--warning">Warning Button</a></div> -<div markdown="0"><a href="#" class="btn btn--danger">Danger Button</a></div> -<div markdown="0"><a href="#" class="btn btn--info">Info Button</a></div> - -## Notices - -**Watch out!** You can also add notices by appending `{: .notice}` to a paragraph. -{: .notice} diff --git a/_posts/2012-03-14-layout-code-excerpt-generated.md b/_posts/2012-03-14-layout-code-excerpt-generated.md deleted file mode 100644 index 0bdc595..0000000 --- a/_posts/2012-03-14-layout-code-excerpt-generated.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "Layout: Code Excerpt (Generated)" -categories: - - Layout - - Uncategorized -tags: - - content - - excerpt - - layout ---- - -This is the post content with inline code, (e.g. `<span style="color: red;">red</span>`. It should be displayed in place of the auto-generated excerpt in single-page views. Archive-index pages should display an auto-generated excerpt of this content. - -Be sure to test the formatting of the auto-generated excerpt, to ensure that it doesn't create any layout problems. \ No newline at end of file diff --git a/_posts/2012-03-14-layout-excerpt-defined.md b/_posts/2012-03-14-layout-excerpt-defined.md deleted file mode 100644 index 7091cf8..0000000 --- a/_posts/2012-03-14-layout-excerpt-defined.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: "Layout: Excerpt (Defined)" -excerpt: "This is a user-defined post excerpt. It should be displayed in place of the post content in archive-index pages." -categories: - - Layout - - Uncategorized -tags: - - content - - excerpt - - layout ---- - -This is the post content. It should be displayed in place of the user-defined excerpt in archive-index pages. - -This paragraph should be absent from an archive-index page where `post.excerpt` is shown. \ No newline at end of file diff --git a/_posts/2012-03-14-layout-excerpt-generated.md b/_posts/2012-03-14-layout-excerpt-generated.md deleted file mode 100644 index 5f26140..0000000 --- a/_posts/2012-03-14-layout-excerpt-generated.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: "Layout: Excerpt (Generated)" -excerpt_separator: "<!--more-->" -categories: - - Layout - - Uncategorized -tags: - - content - - excerpt - - layout ---- - -This is the post content. Archive-index pages should display an auto-generated excerpt of this content. - -<!--more--> - -Be sure to test the formatting of the auto-generated excerpt, to ensure that it doesn't create any layout problems. \ No newline at end of file diff --git a/_posts/2012-03-15-layout-author-override.md b/_posts/2012-03-15-layout-author-override.md deleted file mode 100644 index c27aa66..0000000 --- a/_posts/2012-03-15-layout-author-override.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: "Layout: Author Override" -author: Billy Rick -excerpt: "A post to test author overrides using a data file." ---- - -Sites that may have content authored from various individuals can be accommodated by using [data files](https://jekyllrb.com/docs/datafiles/). - -To attribute an author to a post or page that is different from the site author specified in `_config.yml`: - -**Step 1.** Create `_data/authors.yml` and add authors using the following format. Anything variables found under `author` in `_config.yml` can be used (e.g. `name`, `avatar`, `uri`, social media profiles, etc.). - -```yaml -# /_data/authors.yml - -Billy Rick: - name: "Billy Rick" - uri: "http://thewhip.com" - email: "billy@rick.com" - bio: "What do you want, jewels? I am a very extravagant man." - avatar: "bio-photo-2.jpg" - twitter: "extravagantman" - -Cornelius Fiddlebone: - name: "Cornelius Fiddlebone" - email: "cornelius@thewhip.com" - bio: "I ordered what?" - avatar: "bio-photo.jpg" - twitter: "rhymeswithsackit" -``` - -**Step 2.** Assign one of the authors in `authors.yml` to a post or page you wish to override the `site.author` with. - -Example: To assign `Billy Rick` as an author for a post the following YAML Front Matter would be applied: - -```yaml -author: Billy Rick -``` \ No newline at end of file diff --git a/_posts/2012-03-15-layout-author-sidebar-disabled.md b/_posts/2012-03-15-layout-author-sidebar-disabled.md deleted file mode 100644 index a4d0dc1..0000000 --- a/_posts/2012-03-15-layout-author-sidebar-disabled.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: "Layout: Author Sidebar Disabled" -excerpt: "A post to test disabling author sidebar." -author_profile: false ---- - -This post has the author sidebar disabled. - -To disable add `author_profile: false` to YAML Front Matter. \ No newline at end of file diff --git a/_posts/2012-03-15-layout-header-image-external.md b/_posts/2012-03-15-layout-header-image-external.md deleted file mode 100644 index 8dd7a01..0000000 --- a/_posts/2012-03-15-layout-header-image-external.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: "Layout: Header Image (External URL)" -header: - image: https://farm5.staticflickr.com/4140/4939863887_84705982fd_b.jpg -categories: - - Layout - - Uncategorized -tags: - - edge case - - featured image - - image - - layout ---- - -This post should display a **header image**, if the theme supports it. - -Featured image is an external asset and should load. \ No newline at end of file diff --git a/_posts/2012-03-15-layout-header-image-horizontal.md b/_posts/2012-03-15-layout-header-image-horizontal.md deleted file mode 100644 index 7b6ef47..0000000 --- a/_posts/2012-03-15-layout-header-image-horizontal.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "Layout: Header Image (Horizontal)" -header: - image: unsplash-image-1.jpg - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" -categories: - - Layout - - Uncategorized -tags: - - edge case - - featured image - - image - - layout ---- - -This post should display a **header image**, if the theme supports it. - -Non-square images can provide some unique styling issues. - -This post tests a horizontal header image. \ No newline at end of file diff --git a/_posts/2012-03-15-layout-header-image-text-readability.md b/_posts/2012-03-15-layout-header-image-text-readability.md deleted file mode 100644 index 140a48c..0000000 --- a/_posts/2012-03-15-layout-header-image-text-readability.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: "Layout: Header Image and Text Readability" -header: - image: unsplash-image-4.jpg - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" -tags: - - sample post - - readability - - test ---- - -This is a sample post with a large feature image[^1] up top and tons of text. Odio ad blue bottle vinyl, 90's narwhal commodo bitters pour-over nostrud. Ugh est hashtag in, fingerstache adipisicing laboris esse Pinterest shabby chic Portland. Shoreditch bicycle rights anim, flexitarian laboris put a bird on it vinyl cupidatat narwhal. Hashtag artisan skateboard, flannel Bushwick nesciunt salvia aute fixie do plaid post-ironic dolor McSweeney's. Cliche pour-over chambray nulla four loko skateboard sapiente hashtag. - -Vero laborum commodo occupy. Semiotics voluptate mumblecore pug. Cosby sweater ullamco quinoa ennui assumenda, sapiente occupy delectus lo-fi. *Ea fashion axe [Marfa cillum aliquip](#). Retro Bushwick keytar cliche.* Before they sold out sustainable gastropub Marfa readymade, ethical Williamsburg skateboard brunch qui consectetur gentrify semiotics. Mustache cillum irony, fingerstache magna pour-over keffiyeh tousled selfies. - -## Cupidatat 90's lo-fi authentic try-hard - -In pug Portland incididunt mlkshk put a bird on it vinyl quinoa. **[Terry Richardson](#) shabby chic +1**, scenester Tonx excepteur tempor fugiat voluptate fingerstache aliquip nisi next level. Farm-to-table hashtag Truffaut, Odd Future ex meggings gentrify single-origin coffee try-hard 90's. - - * Sartorial hoodie - * Labore viral forage - * Tote bag selvage - * DIY exercitation et id ugh tumblr church-key - -Incididunt umami sriracha, ethical fugiat VHS ex assumenda yr irure direct trade. Marfa Truffaut bicycle rights, kitsch placeat Etsy kogi asymmetrical. Beard locavore flexitarian, kitsch photo booth hoodie plaid ethical readymade leggings yr. - -Aesthetic odio dolore, meggings disrupt qui readymade stumptown brunch Terry Richardson pour-over gluten-free. Banksy american apparel in selfies, biodiesel flexitarian organic meh wolf quinoa gentrify banjo kogi. Readymade tofu ex, scenester dolor umami fingerstache occaecat fashion axe Carles jean shorts minim. Keffiyeh fashion axe nisi Godard mlkshk dolore. Lomo you probably haven't heard of them eu non, Odd Future Truffaut pug keytar meggings McSweeney's Pinterest cred. Etsy literally aute esse, eu bicycle rights qui meggings fanny pack. Gentrify leggings pug flannel duis. - -## Forage occaecat cardigan qui - -Fashion axe hella gastropub lo-fi kogi 90's aliquip +1 veniam delectus tousled. Cred sriracha locavore gastropub kale chips, iPhone mollit sartorial. Anim dolore 8-bit, pork belly dolor photo booth aute flannel small batch. Dolor disrupt ennui, tattooed whatever salvia Banksy sartorial roof party selfies raw denim sint meh pour-over. Ennui eu cardigan sint, gentrify iPhone cornhole. - -> Whatever velit occaecat quis deserunt gastropub, leggings elit tousled roof party 3 wolf moon kogi pug blue bottle ea. Fashion axe shabby chic Austin quinoa pickled laborum bitters next level, disrupt deep v accusamus non fingerstache. - -Tote bag asymmetrical elit sunt. Occaecat authentic Marfa, hella McSweeney's next level irure veniam master cleanse. Sed hoodie letterpress artisan wolf leggings, 3 wolf moon commodo ullamco. Anim occupy ea labore Terry Richardson. Tofu ex master cleanse in whatever pitchfork banh mi, occupy fugiat fanny pack Austin authentic. Magna fugiat 3 wolf moon, labore McSweeney's sustainable vero consectetur. Gluten-free disrupt enim, aesthetic fugiat jean shorts trust fund keffiyeh magna try-hard. - -## Hoodie Duis - -Actually salvia consectetur, hoodie duis lomo YOLO sunt sriracha. Aute pop-up brunch farm-to-table odio, salvia irure occaecat. Sriracha small batch literally skateboard. Echo Park nihil hoodie, aliquip forage artisan laboris. Trust fund reprehenderit nulla locavore. Stumptown raw denim kitsch, keffiyeh nulla twee dreamcatcher fanny pack ullamco 90's pop-up est culpa farm-to-table. Selfies 8-bit do pug odio. - -### Thundercats Ho! - -Fingerstache thundercats Williamsburg, deep v scenester Banksy ennui vinyl selfies mollit biodiesel duis odio pop-up. Banksy 3 wolf moon try-hard, sapiente enim stumptown deep v ad letterpress. Squid beard brunch, exercitation raw denim yr sint direct trade. Raw denim narwhal id, flannel DIY McSweeney's seitan. Letterpress artisan bespoke accusamus, meggings laboris consequat Truffaut qui in seitan. Sustainable cornhole Schlitz, twee Cosby sweater banh mi deep v forage letterpress flannel whatever keffiyeh. Sartorial cred irure, semiotics ethical sed blue bottle nihil letterpress. - -Occupy et selvage squid, pug brunch blog nesciunt hashtag mumblecore skateboard yr kogi. Ugh small batch swag four loko. Fap post-ironic qui tote bag farm-to-table american apparel scenester keffiyeh vero, swag non pour-over gentrify authentic pitchfork. Schlitz scenester lo-fi voluptate, tote bag irony bicycle rights pariatur vero Vice freegan wayfarers exercitation nisi shoreditch. Chambray tofu vero sed. Street art swag literally leggings, Cosby sweater mixtape PBR lomo Banksy non in pitchfork ennui McSweeney's selfies. Odd Future Banksy non authentic. - -Aliquip enim artisan dolor post-ironic. Pug tote bag Marfa, deserunt pour-over Portland wolf eu odio intelligentsia american apparel ugh ea. Sunt viral et, 3 wolf moon gastropub pug id. Id fashion axe est typewriter, mlkshk Portland art party aute brunch. Sint pork belly Cosby sweater, deep v mumblecore kitsch american apparel. Try-hard direct trade tumblr sint skateboard. Adipisicing bitters excepteur biodiesel, pickled gastropub aute veniam. - -[^1]: Texture image courtesty of [Lovetextures](http://www.lovetextures.com/) diff --git a/_posts/2012-03-15-layout-header-image-vertical.md b/_posts/2012-03-15-layout-header-image-vertical.md deleted file mode 100644 index 2eae945..0000000 --- a/_posts/2012-03-15-layout-header-image-vertical.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "Layout: Header Image (Vertical)" -header: - image: unsplash-image-6.jpg - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" -categories: - - Layout - - Uncategorized -tags: - - edge case - - featured image - - image - - layout ---- - -This post should display a **header image**, if the theme supports it. - -Non-square images can provide some unique styling issues. - -This post tests a vertical header image. \ No newline at end of file diff --git a/_posts/2012-03-15-layout-header-overlay-color.md b/_posts/2012-03-15-layout-header-overlay-color.md deleted file mode 100644 index 69a8521..0000000 --- a/_posts/2012-03-15-layout-header-overlay-color.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Layout: Header Overlay with Background Fill" -header: - overlay_color: "#333" -categories: - - Layout - - Uncategorized -tags: - - edge case - - image - - layout ---- - -This post should display a **header with a solid background color**, if the theme supports it. - -Non-square images can provide some unique styling issues. - -This post tests overlay headers. \ No newline at end of file diff --git a/_posts/2012-03-15-layout-header-overlay-image.md b/_posts/2012-03-15-layout-header-overlay-image.md deleted file mode 100644 index 1c0ad87..0000000 --- a/_posts/2012-03-15-layout-header-overlay-image.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: "Layout: Header Image Overlay" -header: - overlay_image: unsplash-image-1.jpg - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" - cta_url: "https://unsplash.com" -categories: - - Layout - - Uncategorized -tags: - - edge case - - image - - layout -modified: 2016-05-02T11:39:01-04:00 ---- - -{% include base_path %} - -This post should display a **header with an overlay image**, if the theme supports it. - -Non-square images can provide some unique styling issues. - -This post tests overlay header images. - -## Overlay filter - -You can use it by specifying the opacity (between 0 and 1) of a black overlay like so: - -![transparent black overlay]({{ base_path }}/images/mm-header-overlay-black-filter.jpg) - -```yaml -excerpt: "This post should [...]" -header: - overlay_image: unsplash-image-1.jpg - overlay_filter: 0.5 # same as adding an opacity of 0.5 to a black background - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" - cta_label: "More Info" - cta_url: "https://unsplash.com" -``` - -Or if you want to do more fancy things, go full rgba: - -![transparent red overlay]({{ base_path }}/images/mm-header-overlay-red-filter.jpg) - -```yaml -excerpt: "This post should [...]" -header: - overlay_image: unsplash-image-1.jpg - overlay_filter: rgba(255, 0, 0, 0.5) - caption: "Photo credit: [**Unsplash**](https://unsplash.com)" - cta_label: "More Info" - cta_url: "https://unsplash.com" -``` \ No newline at end of file diff --git a/_posts/2012-03-15-layout-more-tag.md b/_posts/2012-03-15-layout-more-tag.md deleted file mode 100644 index 45940a6..0000000 --- a/_posts/2012-03-15-layout-more-tag.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Layout: More Tag" -categories: - - Layout - - Uncategorized -tags: - - content - - read more - - layout ---- - -This content is before the [excerpt separator tag](http://jekyllrb.com/docs/posts/#post-excerpts). - -Right after this sentence there should be a **continue reading** link of some sort in archive-index pages. - -<!--more--> - -And this content is after the more tag. \ No newline at end of file diff --git a/_posts/2012-03-15-layout-sidebar-custom.md b/_posts/2012-03-15-layout-sidebar-custom.md deleted file mode 100644 index 0dcbbfe..0000000 --- a/_posts/2012-03-15-layout-sidebar-custom.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "Layout: Sidebar Custom" -excerpt: "A post to custom sidebar content." -author_profile: false -sidebar: - - title: "Title" - image: http://placehold.it/350x250 - image_alt: "image" - text: "Some text here." - - title: "Another Title" - text: "More text here." ---- - -This post has a custom sidebar set in the post's YAML Front Matter.. - -An example of how that YAML could look is: - -```yaml -sidebar: - - title: "Title" - image: http://placehold.it/350x250 - image_alt: "image" - text: "Some text here." - - title: "Another Title" - text: "More text here." -``` \ No newline at end of file diff --git a/_posts/2012-05-22-markup-text-readability.md b/_posts/2012-05-22-markup-text-readability.md deleted file mode 100644 index e0dde8e..0000000 --- a/_posts/2012-05-22-markup-text-readability.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: "Markup: Text Readability Test" -excerpt: "A bunch of text to test readability." -tags: - - sample post - - readability - - test ---- - -Portland in shoreditch Vice, labore typewriter pariatur hoodie fap sartorial Austin. Pinterest literally occupy Schlitz forage. Odio ad blue bottle vinyl, 90's narwhal commodo bitters pour-over nostrud. Ugh est hashtag in, fingerstache adipisicing laboris esse Pinterest shabby chic Portland. Shoreditch bicycle rights anim, flexitarian laboris put a bird on it vinyl cupidatat narwhal. Hashtag artisan skateboard, flannel Bushwick nesciunt salvia aute fixie do plaid post-ironic dolor McSweeney's. Cliche pour-over chambray nulla four loko skateboard sapiente hashtag. - -Vero laborum commodo occupy. Semiotics voluptate mumblecore pug. Cosby sweater ullamco quinoa ennui assumenda, sapiente occupy delectus lo-fi. Ea fashion axe Marfa cillum aliquip. Retro Bushwick keytar cliche. Before they sold out sustainable gastropub Marfa readymade, ethical Williamsburg skateboard brunch qui consectetur gentrify semiotics. Mustache cillum irony, fingerstache magna pour-over keffiyeh tousled selfies. - -## Cupidatat 90's lo-fi authentic try-hard - -In pug Portland incididunt mlkshk put a bird on it vinyl quinoa. Terry Richardson shabby chic +1, scenester Tonx excepteur tempor fugiat voluptate fingerstache aliquip nisi next level. Farm-to-table hashtag Truffaut, Odd Future ex meggings gentrify single-origin coffee try-hard 90's. - - * Sartorial hoodie - * Labore viral forage - * Tote bag selvage - * DIY exercitation et id ugh tumblr church-key - -Incididunt umami sriracha, ethical fugiat VHS ex assumenda yr irure direct trade. Marfa Truffaut bicycle rights, kitsch placeat Etsy kogi asymmetrical. Beard locavore flexitarian, kitsch photo booth hoodie plaid ethical readymade leggings yr. - -Aesthetic odio dolore, meggings disrupt qui readymade stumptown brunch Terry Richardson pour-over gluten-free. Banksy american apparel in selfies, biodiesel flexitarian organic meh wolf quinoa gentrify banjo kogi. Readymade tofu ex, scenester dolor umami fingerstache occaecat fashion axe Carles jean shorts minim. Keffiyeh fashion axe nisi Godard mlkshk dolore. Lomo you probably haven't heard of them eu non, Odd Future Truffaut pug keytar meggings McSweeney's Pinterest cred. Etsy literally aute esse, eu bicycle rights qui meggings fanny pack. Gentrify leggings pug flannel duis. - -## Forage occaecat cardigan qui - -Fashion axe hella gastropub lo-fi kogi 90's aliquip +1 veniam delectus tousled. Cred sriracha locavore gastropub kale chips, iPhone mollit sartorial. Anim dolore 8-bit, pork belly dolor photo booth aute flannel small batch. Dolor disrupt ennui, tattooed whatever salvia Banksy sartorial roof party selfies raw denim sint meh pour-over. Ennui eu cardigan sint, gentrify iPhone cornhole. - -> Whatever velit occaecat quis deserunt gastropub, leggings elit tousled roof party 3 wolf moon kogi pug blue bottle ea. Fashion axe shabby chic Austin quinoa pickled laborum bitters next level, disrupt deep v accusamus non fingerstache. - -Tote bag asymmetrical elit sunt. Occaecat authentic Marfa, hella McSweeney's next level irure veniam master cleanse. Sed hoodie letterpress artisan wolf leggings, 3 wolf moon commodo ullamco. Anim occupy ea labore Terry Richardson. Tofu ex master cleanse in whatever pitchfork banh mi, occupy fugiat fanny pack Austin authentic. Magna fugiat 3 wolf moon, labore McSweeney's sustainable vero consectetur. Gluten-free disrupt enim, aesthetic fugiat jean shorts trust fund keffiyeh magna try-hard. - -## Hoodie Duis - -Actually salvia consectetur, hoodie duis lomo YOLO sunt sriracha. Aute pop-up brunch farm-to-table odio, salvia irure occaecat. Sriracha small batch literally skateboard. Echo Park nihil hoodie, aliquip forage artisan laboris. Trust fund reprehenderit nulla locavore. Stumptown raw denim kitsch, keffiyeh nulla twee dreamcatcher fanny pack ullamco 90's pop-up est culpa farm-to-table. Selfies 8-bit do pug odio. - -### Thundercats Ho! - -Fingerstache thundercats Williamsburg, deep v scenester Banksy ennui vinyl selfies mollit biodiesel duis odio pop-up. Banksy 3 wolf moon try-hard, sapiente enim stumptown deep v ad letterpress. Squid beard brunch, exercitation raw denim yr sint direct trade. Raw denim narwhal id, flannel DIY McSweeney's seitan. Letterpress artisan bespoke accusamus, meggings laboris consequat Truffaut qui in seitan. Sustainable cornhole Schlitz, twee Cosby sweater banh mi deep v forage letterpress flannel whatever keffiyeh. Sartorial cred irure, semiotics ethical sed blue bottle nihil letterpress. - -Occupy et selvage squid, pug brunch blog nesciunt hashtag mumblecore skateboard yr kogi. Ugh small batch swag four loko. Fap post-ironic qui tote bag farm-to-table american apparel scenester keffiyeh vero, swag non pour-over gentrify authentic pitchfork. Schlitz scenester lo-fi voluptate, tote bag irony bicycle rights pariatur vero Vice freegan wayfarers exercitation nisi shoreditch. Chambray tofu vero sed. Street art swag literally leggings, Cosby sweater mixtape PBR lomo Banksy non in pitchfork ennui McSweeney's selfies. Odd Future Banksy non authentic. - -Aliquip enim artisan dolor post-ironic. Pug tote bag Marfa, deserunt pour-over Portland wolf eu odio intelligentsia american apparel ugh ea. Sunt viral et, 3 wolf moon gastropub pug id. Id fashion axe est typewriter, mlkshk Portland art party aute brunch. Sint pork belly Cosby sweater, deep v mumblecore kitsch american apparel. Try-hard direct trade tumblr sint skateboard. Adipisicing bitters excepteur biodiesel, pickled gastropub aute veniam. diff --git a/_posts/2013-01-05-markup-title-with-markup.md b/_posts/2013-01-05-markup-title-with-markup.md deleted file mode 100644 index 2ead3fc..0000000 --- a/_posts/2013-01-05-markup-title-with-markup.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: "Markup: Title *with* **Markdown**" -categories: - - Markdown -tags: - - css - - html - - title ---- - -Verify that: - -* The post title renders the word "with" in *italics* and the word "Markdown" in **bold**. -* The post title markup should be removed from the browser window / tab. \ No newline at end of file diff --git a/_posts/2013-01-05-markup-title-with-special-characters.md b/_posts/2013-01-05-markup-title-with-special-characters.md deleted file mode 100644 index 075828a..0000000 --- a/_posts/2013-01-05-markup-title-with-special-characters.md +++ /dev/null @@ -1,432 +0,0 @@ ---- -title: "Markup: Title with Special --- Characters" -categories: - - Markup -tags: - - html - - markup - - post - - title ---- - -Putting special characters in the title should have no adverse effect on the layout or functionality. - -Special characters in the post title have been known to cause issues with JavaScript and XML when not properly encoded and escaped. - -## Latin Character Tests - -This is a test to see if the fonts used in this theme support basic Latin characters. - -<table> - <tr> - <td> - ! - </td> - - <td> - “ - </td> - - <td> - # - </td> - - <td> - $ - </td> - - <td> - % - </td> - - <td> - & - </td> - - <td> - ‘ - </td> - - <td> - ( - </td> - - <td> - ) - </td> - - <td> - * - </td> - </tr> - - <tr> - <td> - + - </td> - - <td> - , - </td> - - <td> - – - </td> - - <td> - . - </td> - - <td> - / - </td> - - <td> - </td> - - <td> - 1 - </td> - - <td> - 2 - </td> - - <td> - 3 - </td> - - <td> - 4 - </td> - </tr> - - <tr> - <td> - 5 - </td> - - <td> - 6 - </td> - - <td> - 7 - </td> - - <td> - 8 - </td> - - <td> - 9 - </td> - - <td> - : - </td> - - <td> - ; - </td> - - <td> - > - </td> - - <td> - = - </td> - - <td> - < - </td> - </tr> - - <tr> - <td> - ? - </td> - - <td> - @ - </td> - - <td> - A - </td> - - <td> - B - </td> - - <td> - C - </td> - - <td> - D - </td> - - <td> - E - </td> - - <td> - F - </td> - - <td> - G - </td> - - <td> - H - </td> - </tr> - - <tr> - <td> - I - </td> - - <td> - J - </td> - - <td> - K - </td> - - <td> - L - </td> - - <td> - M - </td> - - <td> - N - </td> - - <td> - O - </td> - - <td> - P - </td> - - <td> - Q - </td> - - <td> - R - </td> - </tr> - - <tr> - <td> - S - </td> - - <td> - T - </td> - - <td> - U - </td> - - <td> - V - </td> - - <td> - W - </td> - - <td> - X - </td> - - <td> - Y - </td> - - <td> - Z - </td> - - <td> - [ - </td> - - <td> - </td> - </tr> - - <tr> - <td> - ] - </td> - - <td> - ^ - </td> - - <td> - _ - </td> - - <td> - ` - </td> - - <td> - a - </td> - - <td> - b - </td> - - <td> - c - </td> - - <td> - d - </td> - - <td> - e - </td> - - <td> - f - </td> - </tr> - - <tr> - <td> - g - </td> - - <td> - h - </td> - - <td> - i - </td> - - <td> - j - </td> - - <td> - k - </td> - - <td> - l - </td> - - <td> - m - </td> - - <td> - n - </td> - - <td> - o - </td> - - <td> - p - </td> - </tr> - - <tr> - <td> - q - </td> - - <td> - r - </td> - - <td> - s - </td> - - <td> - t - </td> - - <td> - u - </td> - - <td> - v - </td> - - <td> - w - </td> - - <td> - x - </td> - - <td> - y - </td> - - <td> - z - </td> - </tr> - - <tr> - <td> - { - </td> - - <td> - | - </td> - - <td> - } - </td> - - <td> - ~ - </td> - - <td> - </td> - - <td> - </td> - - <td> - </td> - - <td> - </td> - - <td> - </td> - - <td> - </td> - </tr> -</table> \ No newline at end of file diff --git a/_posts/2013-01-09-markup-text-alignment.md b/_posts/2013-01-09-markup-text-alignment.md deleted file mode 100644 index e6fd09b..0000000 --- a/_posts/2013-01-09-markup-text-alignment.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "Markup: Text Alignment" -categories: - - Markup -tags: - - alignment - - content - - css - - markup ---- - -### Default - -This is a paragraph. It should not have any alignment of any kind. It should just flow like you would normally expect. Nothing fancy. Just straight up text, free flowing, with love. Completely neutral and not picking a side or sitting on the fence. It just is. It just freaking is. It likes where it is. It does not feel compelled to pick a side. Leave him be. It will just be better that way. Trust me. - -### Left Align - -This is a paragraph. It is left aligned. Because of this, it is a bit more liberal in it's views. It's favorite color is green. Left align tends to be more eco-friendly, but it provides no concrete evidence that it really is. Even though it likes share the wealth evenly, it leaves the equal distribution up to justified alignment. -{: style="text-align: left;"} - -### Center Align - -This is a paragraph. It is center aligned. Center is, but nature, a fence sitter. A flip flopper. It has a difficult time making up its mind. It wants to pick a side. Really, it does. It has the best intentions, but it tends to complicate matters more than help. The best you can do is try to win it over and hope for the best. I hear center align does take bribes. -{: style="text-align: center;"} - -### Right Align - -This is a paragraph. It is right aligned. It is a bit more conservative in it's views. It's prefers to not be told what to do or how to do it. Right align totally owns a slew of guns and loves to head to the range for some practice. Which is cool and all. I mean, it's a pretty good shot from at least four or five football fields away. Dead on. So boss. -{: style="text-align: right;"} - -### Justify Align - -This is a paragraph. It is justify aligned. It gets really mad when people associate it with Justin Timberlake. Typically, justified is pretty straight laced. It likes everything to be in it's place and not all cattywampus like the rest of the aligns. I am not saying that makes it better than the rest of the aligns, but it does tend to put off more of an elitist attitude. -{: style="text-align: justify;"} \ No newline at end of file diff --git a/_posts/2013-01-10-markup-image-alignment.md b/_posts/2013-01-10-markup-image-alignment.md deleted file mode 100644 index 3aa832e..0000000 --- a/_posts/2013-01-10-markup-image-alignment.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: "Markup: Image Alignment" -categories: - - Markup -tags: - - alignment - - captions - - content - - css - - image - - markup ---- - -Welcome to image alignment! The best way to demonstrate the ebb and flow of the various image positioning options is to nestle them snuggly among an ocean of words. Grab a paddle and let's get started. - -![image-center]({{ site.url }}{{ site.baseurl }}/images/image-alignment-580x300.jpg){: .align-center} - -The image above happens to be **centered**. - -![image-left]({{ site.url }}{{ site.baseurl }}/images/image-alignment-150x150.jpg){: .align-left} The rest of this paragraph is filler for the sake of seeing the text wrap around the 150×150 image, which is **left aligned**. - -As you can see the should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we'll see that the text moves from the right of the image down below the image in seamless transition. Again, letting the do it's thing. Mission accomplished! - -And now for a **massively large image**. It also has **no alignment**. - -![no-alignment]({{ site.url }}{{ site.baseurl }}/images/image-alignment-1200x4002.jpg) - -The image above, though 1200px wide, should not overflow the content area. It should remain contained with no visible disruption to the flow of content. - -![image-right]({{ site.url }}{{ site.baseurl }}/images/image-alignment-300x200.jpg){: .align-right} - -And now we're going to shift things to the **right align**. Again, there should be plenty of room above, below, and to the left of the image. Just look at him there --- Hey guy! Way to rock that right side. I don't care what the left aligned image says, you look great. Don't let anyone else tell you differently. - -In just a bit here, you should see the text start to wrap below the right aligned image and settle in nicely. There should still be plenty of room and everything should be sitting pretty. Yeah --- Just like that. It never felt so good to be right. - -And just when you thought we were done, we're going to do them all over again with captions! - -<figure class="align-center"> - <img src="{{ site.url }}{{ site.baseurl }}/images/image-alignment-580x300.jpg" alt=""> - <figcaption>Look at 580 x 300 getting some love.</figcaption> -</figure> - -The figure above happens to be **centered**. The caption also has a link in it, just to see if it does anything funky. - -<figure style="width: 150px" class="align-left"> - <img src="{{ site.url }}{{ site.baseurl }}/images/image-alignment-150x150.jpg" alt=""> - <figcaption>Itty-bitty caption.</figcaption> -</figure> - -The rest of this paragraph is filler for the sake of seeing the text wrap around the 150×150 image, which is **left aligned**. - -As you can see the should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we'll see that the text moves from the right of the image down below the image in seamless transition. Again, letting the do it's thing. Mission accomplished! - -And now for a **massively large image**. It also has **no alignment**. - -<figure style="width: 1200px"> - <img src="{{ site.url }}{{ site.baseurl }}/images/image-alignment-1200x4002.jpg" alt=""> - <figcaption>Massive image comment for your eyeballs.</figcaption> -</figure> - -The figure element above has an inline style of `width: 1200px` set which should break it outside of the normal content flow. - -<figure style="width: 300px" class="align-right"> - <img src="{{ site.url }}{{ site.baseurl }}/images/image-alignment-300x200.jpg" alt=""> - <figcaption>Feels good to be right all the time.</figcaption> -</figure> - -And now we're going to shift things to the **right align**. Again, there should be plenty of room above, below, and to the left of the image. Just look at him there --- Hey guy! Way to rock that right side. I don't care what the left aligned image says, you look great. Don't let anyone else tell you differently. - -In just a bit here, you should see the text start to wrap below the right aligned image and settle in nicely. There should still be plenty of room and everything should be sitting pretty. Yeah --- Just like that. It never felt so good to be right. - -And that's a wrap, yo! You survived the tumultuous waters of alignment. Image alignment achievement unlocked! diff --git a/_posts/2013-01-11-markup-html-tags-and-formatting.md b/_posts/2013-01-11-markup-html-tags-and-formatting.md deleted file mode 100644 index 4f3c78c..0000000 --- a/_posts/2013-01-11-markup-html-tags-and-formatting.md +++ /dev/null @@ -1,222 +0,0 @@ ---- -title: "Markup: HTML Tags and Formatting" -header: - teaser: "markup-syntax-highlighting-teaser.jpg" -categories: - - Markup -tags: - - content - - css - - formatting - - html - - markup ---- - -A variety of common markup showing how the theme styles them. - -# Header one - -## Header two - -### Header three - -#### Header four - -##### Header five - -###### Header six - -## Blockquotes - -Single line blockquote: - -> Stay hungry. Stay foolish. - -Multi line blockquote with a cite reference: - -> People think focus means saying yes to the thing you've got to focus on. But that's not what it means at all. It means saying no to the hundred other good ideas that there are. You have to pick carefully. I'm actually as proud of the things we haven't done as the things I have done. Innovation is saying no to 1,000 things. - -<cite>Steve Jobs</cite> --- Apple Worldwide Developers' Conference, 1997 -{: .small} - -## Tables - -| Employee | Salary | | -| -------- | ------ | ------------------------------------------------------------ | -| [John Doe](#) | $1 | Because that's all Steve Jobs needed for a salary. | -| [Jane Doe](#) | $100K | For all the blogging she does. | -| [Fred Bloggs](#) | $100M | Pictures are worth a thousand words, right? So Jane × 1,000. | -| [Jane Bloggs](#) | $100B | With hair like that?! Enough said. | - -| Header1 | Header2 | Header3 | -|:--------|:-------:|--------:| -| cell1 | cell2 | cell3 | -| cell4 | cell5 | cell6 | -|-----------------------------| -| cell1 | cell2 | cell3 | -| cell4 | cell5 | cell6 | -|=============================| -| Foot1 | Foot2 | Foot3 | - -## Definition Lists - -Definition List Title -: Definition list division. - -Startup -: A startup company or startup is a company or temporary organization designed to search for a repeatable and scalable business model. - -#dowork -: Coined by Rob Dyrdek and his personal body guard Christopher "Big Black" Boykins, "Do Work" works as a self motivator, to motivating your friends. - -Do It Live -: I'll let Bill O'Reilly [explain](https://www.youtube.com/watch?v=O_HyZ5aW76c "We'll Do It Live") this one. - -## Unordered Lists (Nested) - - * List item one - * List item one - * List item one - * List item two - * List item three - * List item four - * List item two - * List item three - * List item four - * List item two - * List item three - * List item four - -## Ordered List (Nested) - - 1. List item one - 1. List item one - 1. List item one - 2. List item two - 3. List item three - 4. List item four - 2. List item two - 3. List item three - 4. List item four - 2. List item two - 3. List item three - 4. List item four - -## Buttons - -Make any link standout more when applying the `.btn` class. - -```html -<a href="#" class="btn--success">Success Button</a> -``` - -[Primary Button](#){: .btn} -[Success Button](#){: .btn .btn--success} -[Warning Button](#){: .btn .btn--warning} -[Danger Button](#){: .btn .btn--danger} -[Info Button](#){: .btn .btn--info} -[Inverse Button](#){: .btn .btn--inverse} -[Light Outline Button](#){: .btn .btn--light-outline} - -```markdown -[Primary Button Text](#link){: .btn} -[Success Button Text](#link){: .btn .btn--success} -[Warning Button Text](#link){: .btn .btn--warning} -[Danger Button Text](#link){: .btn .btn--danger} -[Info Button Text](#link){: .btn .btn--info} -[Inverse Button](#link){: .btn .btn--inverse} -[Light Outline Button](#link){: .btn .btn--light-outline} -``` - -[X-Large Button](#){: .btn .btn--x-large} -[Large Button](#){: .btn .btn--large} -[Default Button](#){: .btn} -[Small Button](#){: .btn .btn--small} - -```markdown -[X-Large Button](#link){: .btn .btn--x-large} -[Large Button](#link){: .btn .btn--large} -[Default Button](#link){: .btn} -[Small Button](#link){: .btn .btn--small} -``` - -## Notices - -**Watch out!** You can also add notices by appending `{: .notice}` to a paragraph. -{: .notice} - -## HTML Tags - -### Address Tag - -<address> - 1 Infinite Loop<br /> Cupertino, CA 95014<br /> United States -</address> - -### Anchor Tag (aka. Link) - -This is an example of a [link](http://apple.com "Apple"). - -### Abbreviation Tag - -The abbreviation CSS stands for "Cascading Style Sheets". - -*[CSS]: Cascading Style Sheets - -### Cite Tag - -"Code is poetry." ---<cite>Automattic</cite> - -### Code Tag - -You will learn later on in these tests that `word-wrap: break-word;` will be your best friend. - -### Strike Tag - -This tag will let you <strike>strikeout text</strike>. - -### Emphasize Tag - -The emphasize tag should _italicize_ text. - -### Insert Tag - -This tag should denote <ins>inserted</ins> text. - -### Keyboard Tag - -This scarcely known tag emulates <kbd>keyboard text</kbd>, which is usually styled like the `<code>` tag. - -### Preformatted Tag - -This tag styles large blocks of code. - -<pre> -.post-title { - margin: 0 0 5px; - font-weight: bold; - font-size: 38px; - line-height: 1.2; - and here's a line of some really, really, really, really long text, just to see how the PRE tag handles it and to find out how it overflows; -} -</pre> - -### Quote Tag - -<q>Developers, developers, developers…</q> –Steve Ballmer - -### Strong Tag - -This tag shows **bold text**. - -### Subscript Tag - -Getting our science styling on with H<sub>2</sub>O, which should push the "2" down. - -### Superscript Tag - -Still sticking with science and Isaac Newton's E = MC<sup>2</sup>, which should lift the 2 up. - -### Variable Tag - -This allows you to denote <var>variables</var>. \ No newline at end of file diff --git a/_posts/2013-05-22-markup-more-images.md b/_posts/2013-05-22-markup-more-images.md deleted file mode 100644 index 0b226ab..0000000 --- a/_posts/2013-05-22-markup-more-images.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: "Markup: Another Post with Images" -excerpt: "Examples and code for displaying images in posts." -header: - teaser: "http://farm9.staticflickr.com/8426/7758832526_cc8f681e48_c.jpg" -tags: - - sample post - - images - - test ---- - -Here are some examples of what a post with images might look like. If you want to display two or three images next to each other responsively use `figure` with the appropriate `class`. Each instance of `figure` is auto-numbered and displayed in the caption. - -### Figures (for images or video) - -#### One Up - -<figure> - <a href="http://farm9.staticflickr.com/8426/7758832526_cc8f681e48_b.jpg"><img src="http://farm9.staticflickr.com/8426/7758832526_cc8f681e48_c.jpg"></a> - <figcaption><a href="http://www.flickr.com/photos/80901381@N04/7758832526/" title="Morning Fog Emerging From Trees by A Guy Taking Pictures, on Flickr">Morning Fog Emerging From Trees by A Guy Taking Pictures, on Flickr</a>.</figcaption> -</figure> - -Vero laborum commodo occupy. Semiotics voluptate mumblecore pug. Cosby sweater ullamco quinoa ennui assumenda, sapiente occupy delectus lo-fi. Ea fashion axe Marfa cillum aliquip. Retro Bushwick keytar cliche. Before they sold out sustainable gastropub Marfa readymade, ethical Williamsburg skateboard brunch qui consectetur gentrify semiotics. Mustache cillum irony, fingerstache magna pour-over keffiyeh tousled selfies. - -#### Two Up - -Apply the `half` class like so to display two images side by side that share the same caption. - -```html -<figure class="half"> - <a href="/images/image-filename-1-large.jpg"><img src="/images/image-filename-1.jpg"></a> - <a href="/images/image-filename-2-large.jpg"><img src="/images/image-filename-2.jpg"></a> - <figcaption>Caption describing these two images.</figcaption> -</figure> -``` - -And you'll get something that looks like this: - -<figure class="half"> - <a href="http://placehold.it/1200x600.JPG"><img src="http://placehold.it/600x300.jpg"></a> - <a href="http://placehold.it/1200x600.jpeg"><img src="http://placehold.it/600x300.jpg"></a> - <figcaption>Two images.</figcaption> -</figure> - -#### Three Up - -Apply the `third` class like so to display three images side by side that share the same caption. - -```html -<figure class="third"> - <img src="/images/image-filename-1.jpg"> - <img src="/images/image-filename-2.jpg"> - <img src="/images/image-filename-3.jpg"> - <figcaption>Caption describing these three images.</figcaption> -</figure> -``` - -And you'll get something that looks like this: - -<figure class="third"> - <img src="http://placehold.it/600x300.jpg"> - <img src="http://placehold.it/600x300.jpg"> - <img src="http://placehold.it/600x300.jpg"> - <figcaption>Three images.</figcaption> -</figure> diff --git a/_posts/2013-08-16-markup-syntax-highlighting.md b/_posts/2013-08-16-markup-syntax-highlighting.md deleted file mode 100644 index 16b5488..0000000 --- a/_posts/2013-08-16-markup-syntax-highlighting.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: "Markup: Syntax Highlighting" -excerpt: "Post displaying the various ways of highlighting code in Markdown." -header: - teaser: "markup-syntax-highlighting-teaser.jpg" -tags: - - code - - syntax highlighting ---- - -Syntax highlighting is a feature that displays source code, in different colors and fonts according to the category of terms. This feature facilitates writing in a structured language such as a programming language or a markup language as both structures and syntax errors are visually distinct. Highlighting does not affect the meaning of the text itself; it is intended only for human readers.[^1] - -[^1]: <http://en.wikipedia.org/wiki/Syntax_highlighting> - -### GFM Code Blocks - -GitHub Flavored Markdown [fenced code blocks](https://help.github.com/articles/creating-and-highlighting-code-blocks/) are supported. To modify styling and highlight colors edit `/_sass/syntax.scss`. - -```css -#container { - float: left; - margin: 0 -240px 0 0; - width: 100%; -} -``` - -```html -{% raw %}<nav class="pagination" role="navigation"> - {% if page.previous %} - <a href="{{ site.url }}{{ page.previous.url }}" class="btn" title="{{ page.previous.title }}">Previous article</a> - {% endif %} - {% if page.next %} - <a href="{{ site.url }}{{ page.next.url }}" class="btn" title="{{ page.next.title }}">Next article</a> - {% endif %} -</nav><!-- /.pagination -->{% endraw %} -``` - -```ruby -module Jekyll - class TagIndex < Page - def initialize(site, base, dir, tag) - @site = site - @base = base - @dir = dir - @name = 'index.html' - self.process(@name) - self.read_yaml(File.join(base, '_layouts'), 'tag_index.html') - self.data['tag'] = tag - tag_title_prefix = site.config['tag_title_prefix'] || 'Tagged: ' - tag_title_suffix = site.config['tag_title_suffix'] || '–' - self.data['title'] = "#{tag_title_prefix}#{tag}" - self.data['description'] = "An archive of posts tagged #{tag}." - end - end -end -``` - -### Code Blocks in Lists - -Indentation matters. Be sure the indent of the code block aligns with the first non-space character after the list item marker (e.g., `1.`). Usually this will mean indenting 3 spaces instead of 4. - -1. Do step 1. -2. Now do this: - - ```ruby - def print_hi(name) - puts "Hi, #{name}" - end - print_hi('Tom') - #=> prints 'Hi, Tom' to STDOUT. - ``` - -3. Now you can do this. - -### GitHub Gist Embed - -An example of a Gist embed below. - -{% gist mmistakes/6589546 %} diff --git a/_posts/2016-02-24-welcome-to-jekyll.md b/_posts/2016-02-24-welcome-to-jekyll.md deleted file mode 100644 index 5215936..0000000 --- a/_posts/2016-02-24-welcome-to-jekyll.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: "Welcome to Jekyll!" -header: - teaser: "https://farm5.staticflickr.com/4076/4940499208_b79b77fb0a_z.jpg" -categories: - - Jekyll -tags: - - update ---- - -You'll find this post in your `_posts` directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run `jekyll serve`, which launches a web server and auto-regenerates your site when a file is updated. - -To add new posts, simply add a file in the `_posts` directory that follows the convention `YYYY-MM-DD-name-of-post.ext` and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works. - -Jekyll also offers powerful support for code snippets: - -```ruby -def print_hi(name) - puts "Hi, #{name}" -end -print_hi('Tom') -#=> prints 'Hi, Tom' to STDOUT. -``` - -Check out the [Jekyll docs][jekyll-docs] for more info on how to get the most out of Jekyll. File all bugs/feature requests at [Jekyll's GitHub repo][jekyll-gh]. If you have questions, you can ask them on [Jekyll Talk][jekyll-talk]. - -[jekyll-docs]: http://jekyllrb.com/docs/home -[jekyll-gh]: https://github.com/jekyll/jekyll -[jekyll-talk]: https://talk.jekyllrb.com/ \ No newline at end of file diff --git a/_recipes/chocolate-chip-cookies.md b/_recipes/chocolate-chip-cookies.md deleted file mode 100644 index ddd52d7..0000000 --- a/_recipes/chocolate-chip-cookies.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: "Chocolate Chip Cookies" ---- - -A chocolate chip cookie is a drop cookie that originated in the United States and features chocolate chips as its distinguishing ingredient. - -The traditional recipe combines a dough composed of butter and both brown and white sugar with semi-sweet chocolate chips. Variations include recipes with other types of chocolate as well as additional ingredients such as nuts or oatmeal. - -This recipe makes 4 dozen cookies. - -## Ingredients - -* 2 1/4 cups all-purpose flour -* 1 teaspoon baking soda -* 1/2 teaspoon salt -* 1 cup butter, softened and cut to pieces -* 1 cup sugar -* 1 cup light brown sugar, packed -* 2 teaspoons vanilla extract -* 2 large eggs -* 2 cups semi-sweet chocolate chips -* 1/2 teaspoon nutmeg (optional) -* 1 cup chopped pecans or walnuts (optional) - -## Directions - -1. Preheat the oven to 350 F. -2. In a medium bowl, whisk flour with baking soda, nutmeg and salt. -3. In a large bowl, beat butter with sugar and brown sugar until creamy and light. Add vanilla and eggs, one at a time, and mix until incorporated. -4. Gradually add dry mixture into the butter-sugar wet blend, mixing with a spatula until combined. Add chocolate chips and nuts until just mixed. -5. Drop tablespoon-sized clumps onto un-greased cookie sheets. Bake for 8-12 minutes, or until pale brown. Allow to cool on the pan for a minute or three, then transfer cookies to a wire rack to finish cooling. \ No newline at end of file diff --git a/_recipes/oatmeal-cookies.md b/_recipes/oatmeal-cookies.md deleted file mode 100644 index 978ad4f..0000000 --- a/_recipes/oatmeal-cookies.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: "Oatmeal Cookies" ---- - -Oatmeal cookies are a proverbial favorite with both kids and adults. This crisp and chewy cookie is loaded with oats, dried fruit, and chopped nuts. - -## Ingredients - -* 1 cup butter, softened 1 cup white sugar -* 1 cup packed brown sugar -* 2 eggs -* 1 teaspoon vanilla extract -* 2 cups all-purpose flour -* 1 teaspoon baking soda -* 1 teaspoon salt -* 1 1/2 teaspoons ground cinnamon -* 3 cups quick cooking oats - -## Directions - -1. In a medium bowl, cream together butter, white sugar, and brown sugar. Beat in eggs one at a time, then stir in vanilla. Combine flour, baking soda, salt, and cinnamon; stir into the creamed mixture. Mix in oats. Cover, and chill dough for at least one hour. -2. Preheat the oven to 375 degrees F (190 degrees C). Grease cookie sheets. Roll the dough into walnut sized balls, and place 2 inches apart on cookie sheets. Flatten each cookie with a large fork dipped in sugar. -3. Bake for 8 to 10 minutes in preheated oven. Allow cookies to cool on baking sheet for 5 minutes before transferring to a wire rack to cool completely. \ No newline at end of file diff --git a/_recipes/peanut-butter-cookies.md b/_recipes/peanut-butter-cookies.md deleted file mode 100644 index b5eaae8..0000000 --- a/_recipes/peanut-butter-cookies.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: "Peanut Butter Cookies" ---- - -A peanut butter cookie is a type of cookie that is distinguished for having peanut butter as a principal ingredient. The cookie generally originated in the United States, its development dating back to the 1910s. - -## Ingredients - -* 1 cup unsalted butter -* 1 cup crunchy peanut butter -* 1 cup white sugar -* 1 cup packed brown sugar -* 2 eggs 2 -* 1/2 cups all-purpose flour -* 1 teaspoon baking powder -* 1/2 teaspoon salt -* 1 1/2 teaspoons baking soda - -## Directions - -1. Cream butter, peanut butter, and sugars together in a bowl; beat in eggs. -2. In a separate bowl, sift flour, baking powder, baking soda, and salt; stir into butter mixture. Put dough in refrigerator for 1 hour. -3. Roll dough into 1 inch balls and put on baking sheets. Flatten each ball with a fork, making a crisscross pattern. Bake in a preheated 375 degrees F oven for about 10 minutes or until cookies begin to brown. \ No newline at end of file diff --git a/_scenarios/root.md b/_scenarios/root.md new file mode 100644 index 0000000..1e182fa --- /dev/null +++ b/_scenarios/root.md @@ -0,0 +1,10 @@ +--- +title: "Scenario Information" +permalink: /scenarios/ +excerpt: "Scenario Information" +--- + +{% include base_path %} + + +This section contains information on several scenarios in the game, including the items, quests, and places found there. diff --git a/start.sh b/start.sh new file mode 100644 index 0000000..1eb5c75 --- /dev/null +++ b/start.sh @@ -0,0 +1 @@ +jekyll serve --watch --config _config.yml,_config.dev.yml --baseurl ''