content update
This commit is contained in:
@ -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 %}
|
27
pages/overview/troubleshooting.md
Normal file
27
pages/overview/troubleshooting.md
Normal 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.
|
||||
|
||||
|
Reference in New Issue
Block a user