_posts directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run jekyll serve, which launches a web server and auto-regenerates your site when a file is updated.
Jekyll requires blog post files to be named according to the following format:
YEAR-MONTH-DAY-title.MARKUP
Where YEAR is a four-digit number, MONTH and DAY are both two-digit numbers, and MARKUP is the file extension representing the format used in the file. After that, include the necessary front matter. Take a look at the source for this post to get an idea about how it works.
Jekyll also offers powerful support for code snippets:
def print_hi(name)
puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.
]]>I call it luck. Don’t act so surprised, Your Highness. You weren’t on any mercy mission this time. Several transmissions were beamed to this ship by Rebel spies. I want to know what happened to the plans they sent you.
I don’t know what you’re talking about. I am a member of the Imperial Senate on a diplomatic mission to Alderaan– Don’t act so surprised, Your Highness. You weren’t on any mercy mission this time. Several transmissions were beamed to this ship by Rebel spies. I want to know what happened to the plans they sent you.
I call it luck. Leave that to me. Send a distress signal, and inform the Senate that all on board were killed. Still, she’s got a lot of spirit. I don’t know, what do you think? But with the blast shield down, I can’t even see! How am I supposed to fight?
I need your help, Luke. She needs your help. I’m getting too old for this sort of thing. Look, I can take you as far as Anchorhead. You can get a transport there to Mos Eisley or wherever you’re going.
You don’t believe in the Force, do you? Don’t be too proud of this technological terror you’ve constructed. The ability to destroy a planet is insignificant next to the power of the Force. What!? Hokey religions and ancient weapons are no match for a good blaster at your side, kid.
Your eyes can deceive you. Don’t trust them. I can’t get involved! I’ve got work to do! It’s not that I like the Empire, I hate it, but there’s nothing I can do about it right now. It’s such a long way from here.
Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.
]]>When embedding an item the best option is to look for an embed code option for the item you would like to add to your markdown page. You can slap html or an iframe directly into markdown. __
Just grab the embed link from the share button, add the iframe to your markdown file.
<iframe width="560" height="315" src="https://www.youtube.com/embed/4vXB2R8ybDE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
Are you hosting Reveal.js slides on your GitHub Pages? Just paste the link into an iframe!
<iframe width="720" height="480" frameborder="0" marginheight="0" marginwidth="0" src="https://ubc-lib-geo.github.io/gis-workshop-waml-template/content/slides/waml_github20"></iframe>
In Google Slides, go to File, Publish to Web, Embed and publish your slides. Copy the embed code then paste the code into your Markdown file:
<iframe src="https://docs.google.com/presentation/d/e/2PACX-1vT5hKsfivsyGgfRjsl0nKCHasqOuuZ3Rdoqm_OwVwPAWEo8HYDwx4RHy8LlZgYi1MSELhhUwh8ID3vZ/embed?start=false&loop=false&delayms=3000" frameborder="0" width="720" height="480"
allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe>
<iframe id="widgetPreview" frameBorder="0" width="900px" height="450px" border="0px" style="border:0px solid white" src="https://cudl.colorado.edu/luna/servlet/workspace/handleMediaPlayer?lunaMediaId=CUB~13~13~27~151317&embedded=true&cic=CUB%7E13%7E13&widgetFormat=javascript&widgetType=workspace&controls=1&nsip=1" ></iframe>
Basic Map
We’ll start with a basic map. Once you’ve saved any map in ArcGIS Online, you can get it’s embed code by clicking Share. Because you can add HTML directly to Markdown, just paste the code provided by AGOL directly into the Markdown file:
<style>.embed-container {position: relative; padding-bottom: 80%; height: 0; max-width: 100%;} .embed-container iframe, .embed-container object, .embed-container iframe{position: absolute; top: 0; left: 0; width: 100%; height: 100%;} small{position: absolute; z-index: 40; bottom: 0; margin-bottom: -15px;}</style><div class="embed-container"><iframe width="500" height="400" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" title="CU Aerial Photo Collection (final)" src="//ucboulder.maps.arcgis.com/apps/Embed/index.html?webmap=68fe25f1df2149878fa88e15a4044d52&extent=-108.1261,38.2881,-101.4079,41.3297&zoom=true&previewImage=false&scale=true&disable_scroll=true&theme=light"></iframe></div>
Embedding a StoryMap
Want to embed a Story Map? Same exact procedure. Replace everything after src= and before </iframe> with the url for the Story Map:
<style>.embed-container {position: relative; padding-bottom: 80%; height: 0; max-width: 100%;} .embed-container iframe, .embed-container object, .embed-container iframe{position: absolute; top: 0; left: 0; width: 100%; height: 100%;} small{position: absolute; z-index: 40; bottom: 0; margin-bottom: -15px;}</style><div class="embed-container"><iframe width="500" height="400" frameborder="0" scrolling="yes" marginheight="0" marginwidth="0" title="CU Aerial Photo Collection (final)" src="https://storymaps.arcgis.com/stories/3c38d9c4e2844e25a020eb6bade919b9"></iframe></div>
*Note: if you want to enable scrolling, you’ll need to set the following: scrolling="yes". This is in the iframe code.
Presto!
]]>Markdown is a very simple markup language for formatting plain text. You may have seen it or used it in discussion forums (think Reddit) to style text in certain ways – like in bold or italics or both. It’s also often used in GitHub for assembling nicely looking README files, but it’s also used for the content that makes up this site. GitHub Pages (and Jekyll) reads Markdown files (usually with the file extension .md or .markdown) and converts them to valid HTML.
If you’re old-school and prefer writing in HTML, you can still do that too. You can also combine HTML with your Markdown to add things like <iframe> and custom scripts in the same Markdown document.
Markdown syntax is fairly straightforward and somewhat easy to remember. It uses common characters like asterisks, dashes, and the number symbol (hashtag? pound?) mixed with spaces to stylize text. For instance text surrounded by two asterisks makes the text italicized.
*Hello!* = Hello!
We can also make the text bold.
**HOWDY** = HOWDY
This is just scraping the surface of what capable with Markdown, as you can see from GitHub user obebm503’s Markdown Kitchen Sink. For those of you who use HTML, you can think of Markdown as a super simplified version of that – you can add images, links, tables, quotes, and other things with very simple Markdown syntax.
Let’s try out an online editor to practice a couple of common Markdown markups.
Clicking on the Markdown editor link will take you to web page with document displayed in two windows. On the left is the plain text Markdown, and on the right is the styled version rendered online. You can edit the text on the left, and changes will appear on the right.
The first line of this document is a heading – H1 to be specific. How do I know this? Because there is 1 “number sign” and a space before the rest of the text. Any line of text after a # will be rendered as H1.
On the left, change # Markdown syntax guide to # [your name]'s new document
Adding links to your documents is very easy. All you need is your preferred link text and the URL. The Markdown syntax is:
[your preferred text](the URL)
Add this link to the Perry-Castañeda Library Map Collection somewhere in the document:
[Perry-Castañeda Library Map Collection](http://legacy.lib.utexas.edu/maps/)