New Post

These are instructions and a simple template to start creating a new post!

Syntax hints for post formatting

All post files must begin with front matter which is typically used to set a layout or other meta data. For a simple example this can just be empty:

---
layout:     post
date:       2020-07-09 21:21:29
title:      Title of your Lesson
summary:    Summary of your Lesson
tags: ['School-Teachers', 'Students', 'Hobbyists' ]
categories: ['Observing']
order:      11
---

• Make sure you do not have special characters like : in your title and/or summary quote any special characters, such as : like title: "my awesome site: an adventure".
• Every post can have one tag or multiple tags. It will automatically split a string entry if it contains whitespace. The website software, Jekyll, expects multiple items mapped to the key tags For example, while front matter tag: classic hollywood will be processed into a singular entity "classic hollywood", front matter tags: classic hollywood will be processed into an array of entries ["classic", "hollywood"].

• categories does not work the way tags does. A lesson belongs to exactly one module, and the name has to match one of the category: entries in _data/modules.yml exactly — Horn Construction, Receiver Electronics, Software Setup, Observing, Digital Signal Processing, Astronomy or Community Labs. A name that matches nothing means the lesson appears in no module at all, and the build will say so.

• order is where the lesson sits inside its module, counting from 1. Every index and the previous/next links sort by it. Take the next free number in the module, or renumber the others if your lesson belongs partway through.

• After the front matter make your lesson post formatting it in markdown refer to this cheat sheet https://github.com/WVURAIL/dspira-lessons/wiki/Markdown-Cheatsheet

• Add buttons to link to a pdf of your document using this syntax

[Google](http://www.google.com){: .button}

In Google Drive:

• open document
• click share button (upper right corner)
• in dialog box, change the get link attribute to Anyone with link with viewer privileges. see screenshot below

EXAMPLE:

• To add a Google doc lesson:

  [Name of your lesson](https://link/to/your/document/dotcom){: .button}
  

• Add YouTube link: Add an embedded window of the youtube video to the page by simply pasting the YouTube link on the markdown page on its own. Please add a couple of lines describing the contents of the video at minimum.

https://www.youtube.com/watch?v=jS5fTzMP_mg

The above video is a video of Kermit the frog singing the Rainbow Connection

Adding images to the posts

To add images to your post first upload your image to github by going to the link below upload and commit an image to the images directory:

Upload image

Then add the following to the post you are editing

![write-a-brief-alt-text-describing-your-image](/dspira-lessons/images/name-of-your-image-file.FORMAT)

View the live webpage: wvurail.org/dspira-lessons

Edit your post in the text area below