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:4 to update your image
5. run grunt imagemin:images to minify images

Website maintenance

1. Check for dead or redirected links
   • npx @tmcw/linkrot

Common Website Tips

• Kramdown reference
• Jekyll Cheat Sheet

Markdown syntax conventions

_italics_
**bold**
_**bold italics**_
- list

link to page

• markdown

  [link text]({% link path/to/item.with-extension %})
  [link text]({% link path/to/item.with-extension %}#to-anchor)

• html

  <a href="{% link path/to/item.with-extension %}">link text</a>
  <a href="{% link path/to/item.with-extension %}#to-anchor">link text</a>

link to post

• markdown

  [link text]({% link _posts/2016-05-26-file-name.with-extension %})
  [link text]({% link _posts/2016-05-26-file-name.with-extension %}#to-anchor)

• html

  <a href="{% link _posts/2016-05-26-file-name.with-extension %}">link text</a>
  <a href="{% link _posts/2016-05-26-file-name.with-extension %}#to-anchor">link text</a>

external link

• markdown

  [link text](http://external.website.location)
  [link text](http://external.website.location#to-anchor)

• html

  <a href="https://url.com">link text</a>
  <a href="https://url.com#to-anchor">link text</a>

image link to an image

• markdown

  [![displayed image alt text]({% link path/to/item.with-extension %})](![link to alt text]({% link path/to/item.with-extension %})

images

• markdown

  ![alt text]({% link path/to/item.with-extension %})

• html

  <img src="{% link path/to/image.jpg" %} alt="hover text"/>

link alt text

[link text]({% link path/to/item.with-extension %} "popup text")

css in markdown

![alt text]({% link path/to/item.with-extension %})
{: .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 }}

• html

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

hub downloads

This creates the download links from hub.

Item:
  hub:
    name: ArcGIS Online name exactly eg Utah Address Points [required]
    alias:  The name you would prefer to display instead of the value for name [optional]
    item_id: the item id [required]
    org: the sharing org name e.g. `SITLA`. When an org shares items it gets prefixed with their name e.g. `/SITLA::land-ownership`
    skip_shapefile: true or false [optional]
    skip_fgdb: true or false [optional]
    skip_hub: true or false [optional]