Learn Golang

[gawdn]

As a developer, I want to gain familiarity with the language that unifies backend and frontend so I can deliver a good product more efficiently.

Tasks

• Write a simple Markdown blog post server in Golang

Here you can find jonathanmh's excellent guide I used at a reference. Follow this first - it will help you figure out the basic logic behind the project.

---

Some further areas to research if you are stuck on specific points in the tutorial are (and/or possible steps):

• Learn about one possible way to package your Go project by reading https://github.com/golang-standards/project-layout

• Learn about Golang modules (don't use dep) and how they're used in parallel with Golang Standard Layout at Best project structure when using go 1.11 mod golang-standards/project-layout#18. Thoughts about this approach?

• Learn how to serve html/template files (e.g in the HTTP framework https://github.com/gin-gonic/gin)

• Learn how to serve static files like CSS and images

• Learn about routers (not the physical device)/middleware

• Learn about Markdown

• Learn how to parse Markdown (russross' https://github.com/russross/blackfriday is a great place to start)

• Learn about Golang slices etc.

• Bonus points: Add a YAML frontmatter processor

You can see how I approached it here: https://github.com/gawdn/csesoc-web-team-almanac (a little quickly done & not yet finished!)

Acceptance criteria

• When I go to the root directory / of the site I see a page of links with all the posts
• When I go to /posts/INSERT_POST_NAME_HERE I get the post I can read
• The posts are styled with CSS served from a directory (not inline!)
• I can add posts by simply adding a markdown file to a directory (shouldn't have to edit code)
• I can add images to a directory and link them in my markdown posts (e.g ![my caption](/static/images/cactus.png))