gis.utah.gov

Read about our new website. Contribute content or typos. License: MIT.

Local Development

1. Check out this repository
2. run docker-compose up
3. browse to localhost:4000
4. run docker pull jekyll/jekyll to update your image

Common Website Tips

• Kramdown reference
• Jekyll Cheat Sheat

_italics_
**bold**
_**bold italics**_

link to page

• markdown

[link text]({{ "/path/to/item/" | prepend: site.baseurl }})

• html

<a href="{{ "/path/to/item/" | prepend: site.baseurl }}">link text</a>

link to post:

• markdown

[link text]({{site.baseurl}}{% post_url 2016-05-26-file-name-without-extension %})

• html

<a href="{{site.baseurl}}{% post_url 2016-05-26-file-name-without-extension %}">link text</a>

external link

• markdown

[link text](http://external.website.location)

images

• markdown

![alt text]({{ "/path/to/item/" | prepend: site.baseurl }})

• html

<img src="{{ "/path/to/image.jpg" alt="hover text" | prepend: site.baseurl }}"/>

link alt text

[link text]({{ "/path/to/item/" | prepend: site.baseurl }} "popup text")

css in markdown

![alt text]({{ "/path/to/item/" | prepend: site.baseurl }})
{: .css-class-name}

font matter

• page - the post vs page layout
• title: Title - the title of the content
• author.display_name: Full Name - The author of the content
• author.email: email@address - The author email
• date: 2018-02-13 - the date the content was created
• update_date: 2018-02-13 - this will show in under the title that the page has been updated
• tags: a list of tags
• categories: Featured|Developer|SGID Blog|GPS-surveyor|Guestblog
• published: true|false

contact information

Contacts are managed in a yml file. Please do not put email addresses directly into content.

The include has a few properties:

• subject: the subject of the email link. Most of the time using page.title is good enough™

• contact: the contact in the yml file to create

• text: update this to change the default text generated

• hide-punctuation: set this to true if you would like to remove the . at the end of the text

• markdown

{% capture contact %}{% include contact.html subject=page.title contact=site.data.contacts.agrc %}{% endcapture %}
{{ contact | strip_newlines }}

• html

{% include contact.html subject=page.title contact=site.data.contacts.agrc %}