M _data/navigation.yml => _data/navigation.yml +2 -2
@@ 38,10 38,10 @@ docs:
path: configuration
- title: "Navigation"
path: navigation
- - title: "Authors"
- path: authors
- title: "UI Text"
path: ui-text
+ - title: "Authors"
+ path: authors
- title: "Layouts"
path: layouts
M _docs/03-installation.md => _docs/03-installation.md +1 -2
@@ 8,7 8,6 @@ sidebar:
---
{% include base_path %}
-{% include toc %}
## Install the Theme
@@ 19,7 18,7 @@ There are several ways to install the theme:
**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.
<figure>
- <img src="{{ base_path }}/images/mm-github-copy-repo-url.png" alt="copy GitHub repo URL">
+ <img src="{{ base_path }}/images/mm-github-copy-repo-url.jpg" alt="copy GitHub repo URL">
<figcaption>Tap the copy to clipboard button (outlined in red above) to grab your GitHub repo's path.</figcaption>
</figure>
M _docs/04-upgrading.md => _docs/04-upgrading.md +0 -1
@@ 8,7 8,6 @@ sidebar:
---
{% include base_path %}
-{% include toc %}
Currently there is no good way of upgrading the theme without doing a bit of manual work. The future looks promising with [**gem based themes**](https://github.com/jekyll/jekyll/pull/4595) on the horizon, but for now here's some suggestions on how handle theme updates.
A _docs/07-ui-text.md => _docs/07-ui-text.md +18 -0
@@ 0,0 1,18 @@
+---
+title: "UI Text"
+permalink: /docs/ui-text/
+excerpt:
+sidebar:
+ title: "v3.0"
+ nav: docs
+---
+
+{% include base_path %}
+
+Text found 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. If you're are interested in localizing for other languages feel free to submit pull-requests and I will be happy to look the over and merge in.
+
+Many of the label based keys like `meta_label`, `categories_label`, `tags_label`, `share_on_label`, `follow_label`, and more can be left blank if you'd like to omit them. It really depends on you and if you want an even more minimal look to your site.
+
+<
\ No newline at end of file
A _docs/08-authors.md => _docs/08-authors.md +43 -0
@@ 0,0 1,43 @@
+---
+title: "Authors"
+permalink: /docs/authors/
+excerpt:
+sidebar:
+ title: "v3.0"
+ nav: docs
+---
+
+{% 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 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
+```
M _posts/2012-03-15-layout-author-override.md => _posts/2012-03-15-layout-author-override.md +16 -14
@@ 4,33 4,35 @@ author: Billy Rick
excerpt: "A post to test author overrides using a data file."
---
-For those of you who may have content written by multiple authors on your site you can now assign different authors to each post if desired.
+Sites that may have content authored from various individuals can be accommodated by using [data files](https://jekyllrb.com/docs/datafiles/).
-Previously the theme used a global author for the entire site and those attributes would be used in all bylines, social networking links, Twitter Card attribution, and Google Authorship. These `owner` variables were defined in `config.yml`
+To attribute an author to a post or page that is different from the site author specified in `_config.yml`:
-Start by modifying or creating a new `authors.yml` file in the `_data` folder and add your authors using the following format.
+**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
+ 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
+ avatar: "bio-photo-2.jpg"
+ twitter: "extravagantman"
Cornelius Fiddlebone:
- name: Cornelius Fiddlebone
- email: cornelius@thewhip.com
+ name: "Cornelius Fiddlebone"
+ email: "cornelius@thewhip.com"
bio: "I ordered what?"
- avatar: bio-photo.jpg
- twitter: rhymeswithsackit
+ avatar: "bio-photo.jpg"
+ twitter: "rhymeswithsackit"
```
-To assign Billy Rick as an author for our post. You'd add the following YAML front matter to a post:
+**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
A images/mm-github-copy-repo-url.jpg => images/mm-github-copy-repo-url.jpg +0 -0
D images/mm-github-copy-repo-url.png => images/mm-github-copy-repo-url.png +0 -0
A images/mm-ui-text-labels.jpg => images/mm-ui-text-labels.jpg +0 -0