/gis.utah.gov

AGRC static jekyll website

Primary LanguageHTMLMIT LicenseMIT

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

_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 %}