content update

This commit is contained in:
Tom Johnson
2015-04-20 16:48:21 -07:00
parent 55b3280762
commit 5b5bf8858e
186 changed files with 32 additions and 64651 deletions

View File

@ -1,45 +0,0 @@
---
title: Tags
permalink: /tags/
audience: writer, designer
---
You can add tags to pages by adding `tags` in the frontmatter, like this:
```
---
title: 2.0 Release Notes
permalink: /release_notes_2_0/
tags: overview, getting-started
---
```
To prevent tags from getting out of control and inconsistent, first make sure the tag appears in the tags.yml file. If it's not there, the tag you add to a page won't be read.
Additionally, you must create a tag archive page similar to the other pages inside the pages/tag-archive folder. This theme doesn't auto-create tag archive pages.
For simplicity, make all your tags single words (connect them with hyphens if necessary).
{% if site.audience == "designer" %}
## Retrieving pages for a specific tag
If you want to retrieve pages outside of a particular tag-archive page, you could use this code:
{% raw %}
```html
{% for page in site.pages limit: 5 %}
{% for tag in page.tags %}
{% if tag == "release_notes" %}
<li><a href="{{ page.permalink | prepend: site.baseurl }}">{{page.title}}</a></li>
<div class="summary">{{page.summary}}</div>
{% endif %}
{% endfor %}
{% endfor %}
```
{% endraw %}
Tags will be sorted in alphabetical order.
{{warning}} Avoid using too many `for` loops. Each `for` loop you add increases the build time with Jekyll. This is why so many of the reuse components are inside data files rather than stored as includes in an HTML file.{{end}}
{% endif %}

View File

@ -0,0 +1,27 @@
---
title: Troubleshooting
permalink: /troubleshooting/
---
## Address already in use
When you try to build the site, you get this error:
```
jekyll 2.5.3 | Error: Address already in use - bind(2)
```
This happens if a server is already in use. To fix this, edit your config file and change the port to a unique number.
If the previous server wasn't shut down properly, you can kill the server process using these commands:
`ps aux | grep jekyll`
Find the PID (for example, it looks like "22298").
Then type `kill -9 22298` where "22298" is the PID.
# "page 0" cross references in the PDF
If you see "page 0" cross-references in the PDF, the URL doesn't exist. Check to make sure you actually included this page in the build. If it's not a page but rather a file, you need to add a class to the file so that your print stylesheet excludes the counter from it. Try adding `class="noCrossRef"` as an attribute to the link. In the css/printstyles.css file, there is a style that should remove the counter from anchor elements with this class.